Description
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.
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.
| Date made available | 26 Mar 2026 |
|---|---|
| Publisher | Zenodo |
Dataset Licences
- CC-BY-4.0
Cite this
- DataSetCite