Active textiles move in confined areas dataset

Dataset Overview

This dataset contains molecular dynamics simulation inputs/outputs and physical experiment recordings for bobbin lace patterns studied for their pore contraction behaviour under selective yarn fixing.



Directory Structure

The repository is organized into three main directories:





lammps_data/: Contains LAMMPS input files, specifically the particle mesh, with one file provided per pattern.




simulations/: Contains the molecular dynamics simulation results, organized with one subfolder per pattern (Pattern_{ID}/). Each subfolder includes:





Trajectories (*.lammpstrj) for stabilisation and each individual contraction step.




LAMMPS run logs (*.log).




Restart files generated after stabilisation (sim1.restart).




A plots/ directory containing time-series data for pore geometry (*_holes.json) and yarn contraction (*_yarn_lengths.json), combined analysis outputs, relative pore area changes, area distributions, histograms, and yarn length evolution plots.






textile samples/: Contains data from the physical experiments.





Folders named {ID}-{n} {date}/ contain data for one lace sample each, where ID is the pattern and n is the replicate number. These folders hold contraction videos (*.MOV), before-and-after photographs (DSC_*.JPG), and a plots/ subfolder with identical analysis outputs to those found in the simulations.




Folders knit_{date}/ and weave_{date}/ contain reference knitted (article label: K) and woven (article label: W) samples.




The images_tools/ directory contains photographs of the experimental equipment used.







Pattern Naming Conventions

Two naming systems are utilized across the dataset files. The article labels organize the patterns by their structural family: Knit (K), Woven (W), Square (S1-S2), Diamond (D1-D7), Hexa (H1), Rose (R1-R13), and Spruce (Sp1). The pattern IDs found in the file and folder names correspond directly to the numbering used in the reference bobbin lace pattern book: Uta Ulrich, Gründe mit System (2011).

Key Variants and Exceptions:





R12 (Rose-12) variants: The variant 3051_1t employs a 4-step contraction sequence ([[1],[3],[1,2],[1,2,3,4,5,6,7,8]]). The variant 3051v2 utilizes a 2-step sequence ([[1,2],[1,2,3,4,5,6,7,8]]). Three physical replicates for these variants are available under textile samples/3051/.




Physical samples located in textile samples/2003-01/ and textile samples/3110-10/ are included in the repository but were not used in the article simulations.





Simulation File Naming

LAMMPS data and trajectory files follow this specific naming convention: pattern{ID}_{dist}_{mass}_{threshold}_{ks}_{kb}[_contract_fix_{yarns}]





dist: Particle spacing in simulation units (Value: 0.25).




mass: Particle mass (Value: 1.0).




threshold: Contact force threshold (Value: 0.0).




ks: Stretching spring constant (Value: 30.0).




kb: Bending stiffness (Value: 0.1).




yarns: Underscore-separated IDs of the yarns held fixed during contraction (e.g., 1_2_3_4).





Note: Files lacking the _contract_fix_* suffix represent the initial stabilisation runs. Each file with the _contract_fix_{yarns} suffix represents a subsequent contraction step.




Software and Visualization

Simulations were conducted using LAMMPS. To visualize the simulation trajectories using the free version of OVITO Basic, follow these steps:





Open the input file: Navigate to File → Open, and select the .data file for your desired pattern from the lammps_data/ directory.




Set the import format: When the LAMMPS Data File Import dialog appears, set the Atom style to bond and map the columns to atom-ID, molecule-ID, atom-type, x, y, z.




Adjust display sizes: In the Visual Elements panel, adjust the Particle Radius to 0.5 and the Bond Width to 1.0.




Load the trajectory: In the Pipeline panel, select Add modification... → Load Trajectory, and choose the corresponding .lammpstrj file from simulations/Pattern_{ID}/.



To observe the entire contraction protocol, load the stabilisation trajectory first (the file with no suffix), followed by the contraction step trajectories (_contract_fix_{yarns}.lammpstrj) in sequential order.