1MSI2LMP(1) General Commands Manual MSI2LMP(1)
2
6 MSI2LMP - Converter for Materials Studio files to LAMMPS
7
10 msi2lmp [-help] <ROOTNAME> [-class <I|1|II|2|O|0>] [-frc <path to frc
11 file>] [-print #] [-ignore] [-nocenter] [-oldstyle] [-shift <x> <y>
12 <z>]
13
16 MSI2LMP is a tool bundled with LAMMPS to aide in the conversion of sim‐
17 ulation inputs from Biovia's Materials Studio software for use with
18 LAMMPS. It is a standalone program that generates a LAMMPS data file
19 based on the information in an MS .car file (atom coordinates), an .mdf
20 file (molecular topology and atom types) and an .frc (forcefield param‐
21 eters) file. The .car and .mdf files are specific to a molecular sys‐
22 tem while the .frc file is specific to a forcefield (variant). The
23 only coherency needed between .frc and .car/.mdf files are the atom
24 types.
25
27 -h, -help,
28 Print detailed help message to the screen and stop.
29 <ROOTNAME>
31 This has to be the first argument and is a mandatory argument.
32 It defines the root of the file names; i.e. for a <ROOTNAME> of
33 benzene, you have to provide the files 'benzene.car' and 'ben‐
34 zene.mdf' in the current working directory. msi2lmp will then
35 read and process those files according to its remaining set‐
36 tings. All other settings are optional and have defaults as
37 listed.
38 -c <I,1,II,2,O,0>, -class <I,1,II,2,O,0>
40 The -c or -class option selects the force field class, i.e which
41 pair styles and bond styles and so on are required in the LAMMPS
42 input file. Class I or class 1 uses similar combination of
43 functional forms as Amber and Charmm force field and support the
44 force fields cvff and clayff. Class II or class 2 corresponds
45 to the more complex force fields COMPASS and pcff. Class O or
46 class 0 finally is an experimental and incomplete extension and
47 supports generating output for OPLS-AA
48 -f <ffname>, -frc <ffname>
50 The -c or -frc option allows the selection of the force field
51 parameter file Valid names for <ffname> with this distribution
52 are: cvff, clayff, cvff_aug, pcff, compass_published, cff91, and
53 oplsaa. If the argument is a pathname, i.e. it starts with a '.'
54 or a '/', then this absolute path is used to read the force
55 field, otherwise msi2lmp will look in the folder pointed to by
56 the environment variable $MSI2LMP_LIBRARY. If the variable is
57 not set, then it will look in the current directory. The exten‐
58 sion '.frc' is appended, if missing. Default is to look for the
59 cvff.frc force field file.
60 -p <loglevel>, -print <loglevel>,
62 Selects the amount of information messages about the progress of
63 the conversion printed to the screen. <loglevel> can be a num‐
64 ber from 0 (silent except for errors) to 3 (very detailed).
65 -i, -ignore,
67 Ignore errors about missing parameters and use 0.0 for the re‐
68 spective force constants making these no-ops. Is correct to be
69 used for a few molecules and settings, but often an indication,
70 that either the atom type assignment have errors, or the force
71 field file is missing entries.
72 -n, -nocenter,
74 Do not center the box around the (geometrical) center of the
75 atoms, but around the origin. Default is to recenter.
76 -o, -oldstyle,
78 Write out a data file without style hint comments to be compati‐
79 ble with old LAMMPS versions. Default is to write out those com‐
80 ments.
81 -s <x> <y> <z>, -shift <x> <y> <z>,
83 Shift the entire system (box and coordinates) by a vector (de‐
84 fault: 0.0 0.0 0.0).
85 EXAMPLES
89 msi2lmp benzene -c 2 -p 1 -f ../frc_files/pcff.frc
91 msi2lmp benzene-class1 -c I
93 msi2lmp decane -c 0 -f oplsaa
95
99 © 2003--2022 Sandia Corporation
100 This package is free software; you can redistribute it and/or modify it
102 under the terms of the GNU General Public License version 2 as pub‐
103 lished by the Free Software Foundation.
104 This package is distributed in the hope that it will be useful, but
106 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
107 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
108 Public License for more details.
1092023-03-10 v3.9.10 MSI2LMP(1)