Skip to main content
zenodoopen

Contact changes in shear-stabilized jammed packings

<p>Authors are listed in alphabetical order.</p> <p>This data set contains the result of small simple shear deformations applied to approximately 140,000 shear-stabilized jammed packings (see [...]), focusing on contact changes, as described in [1,2,3,4].</p> <p>These packings contain&nbsp;<span class="math-tex">\(N = 16 \ldots 4096\)</span>&nbsp;particles with harmonic interactions,&nbsp;under a confining pressure &nbsp;<span class="math-tex">\(p=10^{-7}\ldots10^{-2}\)</span>. Ensemble sizes range from 10 (N=4096) to 5000 (N=16).&nbsp;</p> <p>In addition, a data file summarizing properties of the first contact change for each packing is provided.</p> <p><strong>Particle interactions</strong></p> <p>The simulation code minimizes the enthalpy</p> <p><span class="math-tex">\(H = \sum_{} \frac{k}{2} \delta_{ij}^2 + pL^2\)</span></p> <p>where L&sup2; is the simulation box area, p the externally applied pressure, k=1 the spring constant and&nbsp;</p> <p><span class="math-tex">\(\delta_{ij} = \left\{ \begin{array}{ll} R_i + R_j - |\vec{r_{ij}}| &amp; \textrm{if } |\vec{r_{ij}}| &lt; R_i + R_j, \\ 0 &amp; \textrm{otherwise.} \end{array}\right.\)</span></p> <p>&nbsp;</p> <p>During shear, the boundary conditions are changed, and the system is relaxed to the new state. The simulation uses a bisection algorithm to efficiently step towards each subsequent contact change; see [3,4] for details.</p> <p><strong>Data files</strong></p> <p>The packings are stored in HDF5 data files. For each ensemble, we provide two files: one with and one without particle positions:</p> <ul> <li>N1024~P3162e-3_shear_noparticles.h5 includes all simulation data, but omits particle positions (see below for which data is included).</li> <li>For small data sets,&nbsp;N1024~P3162e-3_shear.h5 contains all simulations and all particle positions</li> <li>For large data sets, N1024~P3162e-3_shear_partial.h5 contains&nbsp;<em>a subset</em>&nbsp;of all simulations, but with all particle positions.</li> <li>Full particle positions for all simulations are available upon request to the authors. Please contact Martin van Hecke .</li> </ul> <p>All files follow the same HDF5 layout:</p> <ul> <li>Example name: N1024~P3162e-3_shear.h5 and&nbsp;N1024~P3162e-3_shear_noparticles.h5 <ul> <li>Packings with&nbsp;<span class="math-tex">\(N=1024\)</span>&nbsp;particles</li> <li>Pressure&nbsp;<span class="math-tex">\(p = 3.162\cdot 10^{-3}\)</span></li> </ul> </li> <li>Packings are stored in a directory structure, e.g. /N1024/P3.1620e-03/0090/SR for the packing with id 0090. <ul> <li>​This directory contains a table &#39;data&#39; indicating system parameters for each simulation step: <ul> <li>boundary conditions L1 and L2 (also as&nbsp;L,&nbsp;alpha, delta)</li> <li>pressure P,</li> <li>strain gamma,</li> <li>stresses s_xy (simple shear), s_xx and s_yy,&nbsp;</li> <li>number of contacts Ncontacts, contact number Z and number of rattlers #rattler</li> <li>number of changed contacts for this contact change bisection Nchanges, N+ (created), N- (broken)</li> <li>contact number Z</li> <li>energy U, enthalpy H and their change in the last relaxation step (dU, dH)</li> <li>step runtime t_run (seconds), #CG, #FIRE (number of conjugate gradient and FIRE iterations)</li> <li>path to the packing corresponding to this state (does not always exist for each state for older simulations)</li> </ul> </li> <li>Each state is saved in /N1024/P3.1620e-03/0090/SR/0000 (initial),&nbsp;/N1024/P3.1620e-03/0090/SR/0001, ...etc. <ul> <li>States are not included in the _noparticles.h5 files</li> <li>Some files omit intermediate positions, and only store positions just before and just after a contact change.</li> <li>The format of these directories is the same as in https://dx.doi.org/10.5281/zenodo.59216.</li> </ul> </li> </ul> </li> </ul> <p>Finally, we provide a summary file (shear_summary_cache.h5)&nbsp;which contains one table (&#39;data&#39;) with properties of the first contact change of all packings. We provide the following columns:</p> <ul> <li>The variable postfix determines whether the value was calculated in the initial state (_base), just before the first contact change (_min) or just after the first contact change (_plus).</li> </ul> <p>&nbsp;</p> <ul> <li>General/simulation properties <ul> <li>Number of particles &#39;N&#39;</li> <li>Random seed [&#39;num&#39;, &#39;PackingNumber_base&#39;]</li> <li>External pressure &#39;P0_base&#39;</li> <li>Simulation step [&#39;i_min&#39;, &#39;i_plus&#39;]</li> </ul> </li> <li>Relaxation statistics <ul> <li>Last change in enthalpy during relaxation [&#39;dH_base&#39;, &#39;dH_plus&#39;, &#39;dH_min&#39;]</li> <li>Last change in energy during relaxation [&#39;dU_base&#39;, &#39;dU_plus&#39;, &#39;dU_min&#39;]</li> <li>Maximum gradient [&#39;maxGrad_base&#39;, &#39;gg_min&#39;, &#39;gg_plus&#39;]</li> <li>Initial simulation runtime [&#39;runtime (s)_base&#39;]</li> </ul> </li> <li>State properties <ul> <li>Number of rattlers &#39;N - Ncorrected_base&#39;</li> <li>Number of non-rattler particles [&#39;Neff_min&#39;, &#39;Neff_plus&#39;]</li> <li>Number of contacts [&#39;Ncontacts_plus&#39;, &#39;Ncontacts_min&#39;]</li> <li>Contact number z [&#39;Z_base&#39;, &#39;Z_min&#39;, &#39;Z_plus&#39;]</li> <li>Internal pressure [&#39;P&#39;, &#39;P_base&#39;, &#39;P_min&#39;, &#39;P_plus&#39;]</li> <li>Mean overlap &delta; [&#39;mean_delta_base&#39;]</li> <li>Packing fraction [&#39;phi_base&#39;, &#39;phi_min&#39;, &#39;phi_plus&#39;]</li> <li>Enthalpy [&#39;H_base&#39;, &#39;H_plus&#39;, &#39;H_min&#39;]</li> <li>Energy [&#39;Uhelper_base&#39;, &#39;U_min&#39;, &#39;U_plus&#39;]</li> <li>Simple shear parameter alpha [&#39;alpha_base&#39;, &#39;alpha_min&#39;, &#39;alpha_plus&#39;]</li> <li>Pure shear parameter delta [&#39;delta_base&#39;, &#39;delta_plus&#39;, &#39;delta_min&#39;]</li> <li>Square root of area [&#39;L_base&#39;, &#39;L_min&#39;, &#39;L_plus&#39;]</li> <li>Stresses on boundaries: <ul> <li>xx &nbsp;[&#39;sxx_base&#39;, &#39;s_xx_min&#39;, &#39;s_xx_plus&#39;,]</li> <li>yy &nbsp;[ &#39;syy_base&#39;, &#39;s_yy_plus&#39;, &#39;s_yy_min&#39;,]</li> <li>xy [&#39;sxy_base&#39;, &#39;s_xy_plus&#39;, &#39;s_xy_min&#39;]</li> </ul> </li> <li>Elastic moduli: <ul> <li>&nbsp;[&#39;c1_base&#39;, &#39;c1_min&#39;, &#39;c1_plus&#39;,</li> <li>&#39;c2_base&#39;, &#39;c2_min&#39;, &#39;c2_plus&#39;,</li> <li>&#39;c3_base&#39;, &#39;c3_min&#39;, &#39;c3_plus&#39;,</li> <li>&#39;c4_base&#39;, &#39;c4_plus&#39;, &#39;c4_min&#39;,</li> <li>&#39;c5_base&#39;, &#39;c5_plus&#39;, &#39;c5_min&#39;,</li> <li>&#39;c6_base&#39;, &#39;c6_min&#39;, &#39;c6_plus&#39;,</li> <li>&#39;Dac_base&#39;, &#39;Dac_plus&#39;, &#39;Dac_min&#39;,</li> </ul> </li> <li>AC component of G(&theta;) [&#39;Gac_base&#39;, &#39;Gac_min&#39;, &#39;Gac_plus&#39;]</li> <li>DC component of G(&theta;) [&#39;Gdc_base&#39;, &#39;Gdc_min&#39;, &#39;Gdc_plus&#39;,]</li> <li>AC component of U(&theta;) [&#39;Uac_base&#39;, &#39;Uac_plus&#39;, &#39;Uac_min&#39;]</li> <li>DC component of U(&theta;) [&#39;Udc_base&#39;, &#39;Udc_plus&#39;, &#39;Udc_min&#39;]</li> <li>Simple shear [&#39;Galpha_base&#39;, &#39;Galpha_plus&#39;, &#39;Galpha_min&#39; ]</li> </ul> </li> <li>Contact change properties <ul> <li>Applied strain gamma [&#39;gamma_plus&#39;, &#39;gamma_min&#39;] <ul> <li><em>gamma_min is used as contact change strain</em></li> </ul> </li> <li>Number of created/broken contacts [&#39;N+_plus&#39;, &#39;N+_min&#39;, &#39;N-_plus&#39;, &#39;N-_min&#39;]</li> <li>Number of changed contacts (=N<sup>+</sup> + N<sup>-</sup>) [&#39;Nchanges_plus&#39;, &#39;Nchanges_min&#39;]</li> <li>Making &amp; breaking strain from upar and uperp: <ul> <li>simple linear (SL) solution: [&#39;gmk_SL_base&#39;, &#39;gbk_SL_base&#39;]</li> <li>full quadratic (FQ) solution: [&#39;gmk_FQ_base&#39; &#39;gbk_FQ_base&#39;]</li> </ul> </li> <li>G up to CC from fit &sigma;=G&gamma; &amp; error bar [&#39;Glin&#39;, &#39;Glinerr&#39;]</li> <li>G up to CC from fit &sigma;=G&gamma; + &lambda;&gamma;&sup2; &amp; error bar [&#39;Gquad&#39;, &#39;Gquaderr&#39;]</li> <li>&lambda; up to CC from fit &sigma;=G&gamma; + &lambda;&gamma;&sup2; &amp; error bar [&#39;lambdaquad&#39;, &#39;lambdaquaderr&#39;]</li> </ul> </li> </ul> <p>[1]&nbsp;Simon Dagois-Bohy, Brian P. Tighe, Johannes Simon, Silke Henkes, and Martin van Hecke.&nbsp;<em>Soft-Sphere Packings at Finite Pressure but Unstable to Shear.&nbsp;</em>Phys. Rev. Lett.&nbsp;<strong>109</strong>, 095703.&nbsp;http://dx.doi.org/10.1103/PhysRevLett.109.095703</p> <p>[2]&nbsp;Merlijn S. van Deen, Johannes Simon, Zorana Zeravcic, Simon Dagois-Bohy, Brian P. Tighe, and Martin van Hecke.&nbsp;<em>Contact changes near jamming</em>. Phys. Rev. E&nbsp;<strong>90</strong>&nbsp;020202(R). http://dx.doi.org/10.1103/PhysRevE.90.020202</p> <p>[3]&nbsp;Merlijn S. van Deen, Brian P. Tighe, and Martin van Hecke.&nbsp;<em>Contact Changes of Sheared Systems: Scaling, Correlations, and Mechanisms</em>. arXiv:1606.04799.&nbsp;https://arxiv.org/abs/1606.04799</p> <p>[4] Merlijn S. van Deen.&nbsp;<em>Mechanical Response of Foams: Elasticity, Plasticity, and Rearrangements</em>. PhD Thesis, Leiden University, 2016.&nbsp;https://openaccess.leidenuniv.nl/handle/1887/40902</p>

ShareScore

44/100

Overall dataset sharing score

Score breakdown

These five areas show where the dataset supports — or may limit — practical reuse.

Stewardship
8
Harmonization
4
Access
20
Reuse readiness
8
Engagement
4

Topics