Trigger#

Branch quasistatic simulations at different forces and trigger events. See depinning_inertia_2024.QuasiStatic.

Functions

`CheckData`([cli_args])	Check the data file for data version.
`EnsembleInfo`([cli_args])	Read information (avalanche size, force) of an ensemble.
`FilterCompleted`([cli_args])	Filter completed files from list of files.
`Generate`([cli_args])	Branch simulations at different forces.
`JobRerun`([cli_args])	Create jobs to get event maps.
`Merge`([cli_args])	Merge a previous run "push" file (`source`) into a "push" file (`destination`).
`MergeBatch`([cli_args])	Merge a a batch of files. This is a wrapper around `depinning_inertia_2024.Trigger.Merge()`. The usage is::.
`Paraview`([cli_args])	Write states to be viewed in Paraview.
`Run`([cli_args])	Trigger all branches stored in a file.
`UpdateData`([cli_args])	Update the data from any version to the current version.

Details

depinning_inertia_2024.Trigger.CheckData(cli_args=None)#: Check the data file for data version. Prints the files that have failed. No output is written if all files are ok.

depinning_inertia_2024.Trigger.EnsembleInfo(cli_args=None)#: Read information (avalanche size, force) of an ensemble. See depinning_inertia_2024.Trigger.basic_output(). Store into a single output file.

depinning_inertia_2024.Trigger.FilterCompleted(cli_args=None)#: Filter completed files from list of files. Printed are just the files that are not completed.

depinning_inertia_2024.Trigger.Generate(cli_args=None)#

Branch simulations at different forces. The simulations are the result of depinning_inertia_2024.QuasiStatic.Run().

The following options are available:

(default) After each system spanning event.
(–delta-f) At a fixed force increment (of the frame force) after a system spanning event.

Per realisation in the output of depinning_inertia_2024.QuasiStatic.EnsembleInfo() create one file with a branch ibranch at the relevant state after each system spanning event (n in total):

# Note:
# -     Fields marked (*) are extendible, with initial size = 1
# -     Fields marked (**) are extendible, with initial size = 2
#       They control trigger `i`, and have a size that is 'one ahead'
# -     Fields marked (***) are reconstructable and there only for fast post-processing
# -     Unknown items are ``-1`` (or ``0`` for sizes of durations)

# O.    Meta-data

/Trigger/step        # per branch, the last quasistatic step it was based on [n]
/Trigger/step_c      # per branch, the last system spanning step it was based on [n]
/Trigger/loaded      # per branch, true is elastic loading was applied to ``step`` [n]

# I.    Definition of the state

/Trigger/branches/{ibranch:d}/u/0         # particle positions [shape]
/Trigger/branches/{ibranch:d}/u_frame     # frame position per step (*)
/Trigger/branches/{ibranch:d}/inc         # increment per step (*)

# III.  Trigger control parameters

/Trigger/branches/{ibranch:d}/try_p       # particle to try to trigger first (**)
/Trigger/branches/{ibranch:d}/p           # triggered particle (**)

# IV.   Basic output that cannot be reconstructed

/Trigger/branches/{ibranch:d}/completed   # check that the dynamics finished (*)
/Trigger/branches/{ibranch:d}/truncated   # if event was stopped at A == N (*)
/Trigger/branches/{ibranch:d}/T           # duration of the event (*)

# V.    Basic output that can be reconstructed from "u"/"u_frame"

/Trigger/branches/{ibranch:d}/S           # number of times that blocks yielded (***)
/Trigger/branches/{ibranch:d}/A           # number of blocks that yielded (***)
/Trigger/branches/{ibranch:d}/f_frame     # frame force (***)

depinning_inertia_2024.Trigger.JobRerun(cli_args=None)#

Create jobs to get event maps. The following options are available:

--largest-avalanches=n: the (maximum) n largest avalanches.
--system-spanning=n: (maximum) n avalanches.

In the case of triggering the events are selected based on the distance between the force and the mean of the selected bin.

depinning_inertia_2024.Trigger.Merge(cli_args=None)#

Merge a previous run “push” file (source) into a “push” file (destination). Only pushes that are not present in the destination file are added.

There are assertions on:

The parameters.
The position of the frame and of the particles before triggering.
The particle tried for triggering.
the increment (a.k.a. time).

depinning_inertia_2024.Trigger.MergeBatch(cli_args=None)#

Merge a a batch of files. This is a wrapper around depinning_inertia_2024.Trigger.Merge(). The usage is:

:py:func:`depinning_inertia_2024.Trigger.MergeBatch` -o delta-f=x /path/to/old/delta-f=x/id*h5

depinning_inertia_2024.Trigger.Paraview(cli_args=None)#: Write states to be viewed in Paraview.

depinning_inertia_2024.Trigger.Run(cli_args=None)#: Trigger all branches stored in a file. The file has to be generated by depinning_inertia_2024.Trigger.Generate(). An option is available to rerun a previous trigger, just to check.

depinning_inertia_2024.Trigger.UpdateData(cli_args=None)#: Update the data from any version to the current version.