parameters
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
parameters [2013/02/28 13:22] – created daniel | parameters [2019/08/11 12:11] (current) – daniel | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{TOC_right}} | + | ~~NOTOC~~ |
- | Following is a complete list of all '' | + | ====== Parameters ====== |
+ | ---- | ||
+ | Following is a complete list of all //potfit// parameters, together with a short description of their meaning, and indications when they are needed. | ||
Floating point numbers should be given in decimal notation. Vectors are given as a list of components, separated by spaces or tabs (all on one line). | Floating point numbers should be given in decimal notation. Vectors are given as a list of components, separated by spaces or tabs (all on one line). | ||
- | An asterisk marks required parameters. | ||
- | The first column contains the name of the parameter, the second the type of the parameter and the third one the initial value (if there is one). The second line is a short explanation for the parameter | + | An asterisk |
- | === main parameters === | + | |<100% 33% 33% 33%>| |
- | ;ntypes* - integer - (none) | + | ^ parameter name | parameter type | default value | |
- | :number of atom types (types vary in [0, | + | | short explanation ||| |
- | === file names === | + | ==== main parameters |
- | ;config* - string - (none) | + | |
- | :file with atom configuration in force format, see [[Configurations]] | + | |
- | ;startpot* - string - (none) | + | |
- | :file name for starting potential, see [[Potential_files]] | + | |
- | ;tempfile* - string - (none) | + | |
- | :file name for temporary (intermediate) potential, see [[Tempfile]] | + | |
- | ;endpot - string - $startpot_end | + | |
- | :file name for final potential, see [[Potential_files]] | + | |
- | ;imdpot - string - (none) | + | |
- | :file name prefix for imd potentials, see [[IMD]] | + | |
- | ;plotfile - string - (none) | + | |
- | :file name for plotting potential, see [[Plotfile]] | + | |
- | ;flagfile - string - (none) | + | |
- | :file whose presence terminates fit, see [[Flagfile]] | + | |
- | === general options === | + | |<100% 33% 33% 33%>| |
- | ;write_pair - boolean - 0 | + | ^ **ntypes*** | integer | (none) | |
- | :write radial pair distribution, | + | | number of atom types (types vary in [0,..,ntypes-1]) ||| |
- | ; | + | |
- | :write potential in LAMMPS format, see [[Lammps]] | + | |
- | === Minimization options | + | ==== file names ==== |
- | ;opt - boolean - 0 | + | |
- | :whether or not to perform an optimization | + | |
- | ; | + | |
- | :weight of energy in minimization, | + | |
- | ; | + | |
- | :weight of [[Stress|stress]] in minimiziation, | + | |
- | ; | + | |
- | :starting temperature for simulated annealing, set to 0 to skip simulated annealing, see [[Simulated Annealing]] | + | |
- | ; | + | |
- | :stop the evolutionary algorithm if the difference in the population is smaller than this, set to zero to skip evo, see [[Differential Evolution]] | + | |
- | ;d_eps - float - 0.0 | + | |
- | :error margin for powell minimization - if the improvement is smaller, the optimization is stopped, see [[Method of Least Squares]] | + | |
- | ;seed - integer - 4 | + | |
- | :seed for random number generator | + | |
- | ; | + | |
- | :scaling factor for apot punishments, | + | |
- | === options only for tabulated potentials === | + | |<100% 33% 33% 33%>| |
- | ; | + | ^ **config*** | string |
- | :file name for plotting the sampling points, see [[Plotpointfile]] | + | | file with atomic configurations in force format, see [[config:main|Configurations]] ||| |
- | ;distfile - string - (none) | + | |
- | :file name for distribution file (* with compile option ' | + | |
- | ;maxchfile - string - (none) | + | |
- | :file with maximal permissible changes for each parameter, see [[Maxchfile]] | + | |
- | === options only for analytic potentials === | + | |<100% 33% 33% 33%>| |
- | ;plotmin - float - 0.0 | + | ^ **startpot*** | string | (none) | |
- | :starting | + | | file name containing the starting |
- | ;enable_cp - boolean - 0 | + | |
- | :whether or not to include chemical potentials, see [[Pair Potentials]] | + | |
- | === options for output === | + | |<100% 33% 33% 33%>| |
- | ; | + | ^ **tempfile*** | string |
- | :number of points in each function in imd and lammps potential files, see [[IMD]] / [[Lammps]] | + | | file name for temporary (intermediate) potentials, see [[output:tempfile]] ||| |
- | ; | + | |
- | : | + | |
- | ;extend - float - 2. | + | |
- | :how many steps should the imd potentials be extrapolated, | + | |
- | === parameter | + | |<100% 33% 33% 33%>| |
- | ;dp_cut - float - 10 | + | ^ **endpot** | string | $startpot_end | |
- | : | + | | file name for final potential, see [[potfiles: |
- | === parameters | + | |<100% 33% 33% 33%>| |
- | ;dp_tol - float - 1.e-7 | + | ^ **imdpot** | string | (none) | |
- | :dipole iteration precision. | + | | file name prefix |
- | ;dp_mix - float - 0.2 | + | |
- | :mixing parameter for dipole convergence during iteration. | + | |
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **plotfile** | string | (none) | | ||
+ | | file name for plotting potential, see [[output: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **flagfile** | string | (none) | | ||
+ | | file, whose presence terminates the current fit, see [[Flagfile]] ||| | ||
+ | |||
+ | ==== general options | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **write_pair** | boolean | 0 | | ||
+ | | write radial pair distribution, | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **write_lammps** | boolean | 0 | | ||
+ | | write potential in LAMMPS format, see [[output: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **cell_scale** | float | 1.0 | | ||
+ | | rescale all cells, see [[cell_scale]] ||| | ||
+ | |||
+ | ==== Minimization options | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **opt** | boolean | 0 | | ||
+ | | whether or not to perform an optimization ||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **eng_weight*** | float | (none) | | ||
+ | | weight of energy in minimization, | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **stress_weight** | ||
+ | | (* if compiled with '' | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **anneal_temp** | float | 1.0 | | ||
+ | | starting temperature for simulated annealing, set to 0 to skip simulated annealing, see [[algorithms: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **evo_threshold** | float | 1.0 | | ||
+ | | stop the evolutionary algorithm if the difference in the population is smaller than this, set to zero to skip evo, see [[algorithms: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **d_eps** | float | 0.0 | | ||
+ | |error margin for powell minimization - if the improvement is smaller, the optimization is stopped, see [[algorithms: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **seed** | integer | 4 | | ||
+ | |seed for random number generator||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **apot_punish** | float | 0.0 | | ||
+ | |scaling factor for apot punishments, | ||
+ | |||
+ | ==== options only for tabulated potentials | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **plotpointfile*** | string | (none) | | ||
+ | | file name for plotting the sampling points, see [[output: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **distfile** | string | (none) | | ||
+ | | file name for distribution file (* with compile option ' | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **maxchfile** | string | (none) | | ||
+ | | file with maximal permissible changes for each parameter, see [[Maxchfile]] ||| | ||
+ | |||
+ | ==== options only for analytic potentials | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **plotmin** | float | 0.0 | | ||
+ | | starting point for plotting potentials, see [[output: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **enable_cp** | boolean | 0 | | ||
+ | | whether or not to include chemical potentials, see [[interactions: | ||
+ | |||
+ | ==== options for output | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **imdpotsteps** | integer | 500 | | ||
+ | | number of sampling points in each function in imd potential files, see [[IMD]] ||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **output_prefix** | string | (none) | | ||
+ | | prefix for various output files, see [[output: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **extend** | float | 2.0 | | ||
+ | | how many steps should the imd potentials be extrapolated, | ||
+ | |||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **lammpspotsteps** | integer | 500 | | ||
+ | | number of sampling points in each funcation in LAMMPS potential files, see [[output: | ||
+ | |||
+ | ==== parameter for option coulomb | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **dp_cut** | float | 10 | | ||
+ | | cutoff-radius for electrostatic interactions, | ||
+ | |||
+ | ==== parameters for option dipole | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **dp_tol** | float | 1.e-7 | | ||
+ | | dipole iteration precision. ||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **dp_mix** | float | 0.2 | | ||
+ | | mixing parameter for dipole convergence during iteration. ||| | ||
+ | |||
+ | ==== parameters for OpenKIM potentials | ||
+ | |||
+ | The options for OpenKIM potentials are described in more detail on the [[models: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **kim_model_name** | string | (none) | | ||
+ | | KIM model indentifier ||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **kim_model_params** | string | (none) | | ||
+ | | Special parameter option, see [[models: | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **kim_model_output_directory** | string | (none) | | ||
+ | | Output directory for the optimized KIM model ||| | ||
+ | |||
+ | |<100% 33% 33% 33%>| | ||
+ | ^ **kim_model_output_name** | string | (none) | | ||
+ | | Name for the optimized KIM model ||| |
parameters.txt · Last modified: 2019/08/11 12:11 by daniel