Command line interface

ReacNetGenerator can process any kind of trajectory files containing atomic coordinates, e.g. a LAMMPS dump file prepared by running “dump 1 all custom 100 dump.reaxc id type x y z” in LAMMPS:

reacnetgenerator --type lammpsdumpfile -i dump.reaxc -a C H O --nohmm

where C, H, and O are atomic names in the input file. Analysis report will be generated automatically.

Also, ReacNetGenerator can process files containing bond information, e.g. LAMMPS bond file:

reacnetgenerator --type lammpsbondfile -i bonds.reaxc -a C H O --nohmm

You can running the following script for help:

reacnetgenerator -h

ReacNetGenerator 0.1.dev1+g2d43ad0

usage: reacnetgenerator [-h] -i [INPUTFILENAME [INPUTFILENAME ...]] -a
                        [ATOMNAME [ATOMNAME ...]] [--nohmm] [--miso MISO]
                        [--type {lammpsbondfile,bond,lammpsdumpfile,dump,xyz}]
                        [--nopbc] [--cell CELL [CELL ...]] [-n NPROC]
                        [-s [SELECTATOMS [SELECTATOMS ...]]]
                        [--stepinterval STEPINTERVAL] [--split SPLIT]
                        [--maxspecies MAXSPECIES]
                        [--matrixa MATRIXA MATRIXA MATRIXA MATRIXA]
                        [--matrixb MATRIXB MATRIXB MATRIXB MATRIXB]
                        [--urls URLS URLS] [--version]

Named Arguments

-i, --inputfilename

Input trajectory file, e.g. bonds.reaxc

-a, --atomname

Atomic names in the trajectory, e.g. C H O


Process trajectory without Hidden Markov Model (HMM). If one wants to enable HMM, firstly read the related section in the paper

Default: False


Merge the isomers

Default: 0


(deprecated) Process the LAMMPS dump file. Please use –type dump instead.

Default: False

--type, -t

Possible choices: lammpsbondfile, bond, lammpsdumpfile, dump, xyz

Input file type

Default: “lammpsbondfile”


Disable PBC.

Default: False

--cell, -c


-n, -np, --nproc

Number of processes

-s, --selectatoms

Select atoms in the reaction network, e.g. C


Step interval

Default: 1


Split number for the time axis

Default: 1


Max number of nodes (species) in the network

Default: 20


Matrix A of HMM parameters

Default: [0.999, 0.001, 0.001, 0.999]


Matrix B of HMM parameters

Default: [0.6, 0.4, 0.4, 0.6]


Download files


show program’s version number and exit