potfit wiki

open source force-matching

User Tools

Site Tools

parameters

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
parameters [2013/03/04 07:52] – danielparameters [2019/08/11 12:11] (current) – daniel
Line 4: Line 4:
 Following is a complete list of all //potfit// parameters, together with a short description of their meaning, and indications when they are needed.  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 (*****) marks required parameters. 
 + 
 +|<100% 33% 33% 33%>| 
 +^ parameter name | parameter type | default value | 
 +| short explanation |||
  
 ====  main parameters  ==== ====  main parameters  ====
-**ntypes*** - integer - (none)\\ + 
-<html>&nbsp;&nbsp;&nbsp;</html>number of atom types (types vary in [0,..,ntypes-1]) +|<100% 33% 33% 33%>| 
 +^ **ntypes*** | integer | (none) | 
 +| number of atom types (types vary in [0,..,ntypes-1]) |||
  
 ====  file names  ==== ====  file names  ====
-**config*** - string - (none)\\ 
-<html>&nbsp;&nbsp;&nbsp;</html>file with atom configuration in force format, see [[Configurations]] 
  
-**startpot*** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for starting potential, see [[Potential_files]]+^ **config*** | string | (none) | 
 +| file with atomic configurations in force format, see [[config:main|Configurations]] |||
  
-**tempfile*** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for temporary (intermediate) potential, see [[Tempfile]]+^ **startpot*** | string | (none) | 
 +| file name containing the starting potential, see [[potfiles:main|Potential files]] |||
  
-**endpot** - string - $startpot_end\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for final potential, see [[Potential_files]]+^ **tempfile*** | string | (none) | 
 +| file name for temporary (intermediate) potentials, see [[output:tempfile]] |||
  
-**imdpot** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name prefix for imd potentials, see [[IMD]]+^ **endpot** | string | $startpot_end | 
 +| file name for final potential, see [[potfiles:main|Potential files]] |||
  
-**plotfile** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for plotting potential, see [[Plotfile]]+^ **imdpot** | string | (none) | 
 +| file name prefix for imd potentials, see [[IMD]] |||
  
-**flagfile** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file whose presence terminates fit, see [[Flagfile]]+^ **plotfile** | string | (none) | 
 +| file name for plotting potential, see [[output:plotfile]] |||
  
 +|<100% 33% 33% 33%>|
 +^ **flagfile** | string | (none) |
 +| file, whose presence terminates the current fit, see [[Flagfile]] |||
  
 ====  general options  ==== ====  general options  ====
-**write_pair** - boolean - 0\\ 
-<html>&nbsp;&nbsp;&nbsp;</html>write radial pair distribution, see [[Pair_distribution]] 
  
-**write_lammps** - boolean - 0\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>write potential in LAMMPS format, see [[Lammps]]+^ **write_pair** | boolean | 0 | 
 +| write radial pair distribution, see [[output:pair_distribution|Pair distribution]] ||| 
 + 
 +|<100% 33% 33% 33%>| 
 +^ **write_lammps** | boolean | 0 | 
 +| write potential in LAMMPS format, see [[output:lammps|LAMMPS]] ||| 
 + 
 +|<100% 33% 33% 33%>| 
 +^ **cell_scale** | float | 1.0 | 
 +| rescale all cells, see [[cell_scale]] |||
  
 ====  Minimization options  ==== ====  Minimization options  ====
-**opt** - boolean - 0\\ 
-<html>&nbsp;&nbsp;&nbsp;</html>whether or not to perform an optimization 
  
-**eng_weight*** - float - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>weight of energy in minimization, see [[algorithms]]+^ **opt** | boolean | 0 | 
 +| whether or not to perform an optimization |||
  
-**stress_weight** (* if compiled with ''stress'') - float - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>weight of [[Stress|stress]] in minimiziation, see [[algorithms]]+^ **eng_weight*** | float | (none) | 
 +| weight of energy in minimization, see [[algorithms:main|Algorithms]] |||
  
-**anneal_temp** - float - 1.\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>starting temperature for simulated annealing, set to 0 to skip simulated annealing, see [[Simulated Annealing]]+^ **stress_weight**  | float | (none) | 
 +| (* if compiled with ''stress'') weight of [[Stress|stress]] in minimiziation, see [[algorithms:main|Algorithms]] |||
  
-**evo_threshold** - float - 1.\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>stop the evolutionary algorithm if the difference in the population is smaller than this, set to zero to skip evo, see [[Differential Evolution]]+^ **anneal_temp** | float | 1.0 | 
 +| starting temperature for simulated annealing, set to 0 to skip simulated annealing, see [[algorithms:simann|Simulated Annealing]] |||
  
-**d_eps** - float - 0.0\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>error margin for powell minimization - if the improvement is smaller, the optimization is stopped, see [[Method of Least Squares]]+^ **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:diffevo|Differential Evolution]] |||
  
-**seed** - integer - 4\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>seed for random number generator+^ **d_eps** | float | 0.0 | 
 +|error margin for powell minimization - if the improvement is smaller, the optimization is stopped, see [[algorithms:lsq]] |||
  
-**apot_punish** - float - 0.\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>scaling factor for apot punishments, this does not affect out-of-bounds punishment, see [[Analytic|potentials/Punishments]]+^ **seed** | integer | 4 | 
 +|seed for random number generator||| 
 + 
 +|<100% 33% 33% 33%>| 
 +^ **apot_punish** | float | 0.0 | 
 +|scaling factor for apot punishments, this does not affect out-of-bounds punishment, see [[Analytic potentials/Punishments]]|||
  
 ====  options only for tabulated potentials  ==== ====  options only for tabulated potentials  ====
-**plotpointfile*** - string - (none)\\ 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for plotting the sampling points, see [[Plotpointfile]] 
  
-**distfile** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file name for distribution file (* with compile option 'dist'), see [[Distfile]]+^ **plotpointfile*** | string | (none) | 
 +| file name for plotting the sampling points, see [[output:plotpointfile]] |||
  
-**maxchfile** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>file with maximal permissible changes for each parameter, see [[Maxchfile]]+^ **distfile** | string | (none) | 
 +| file name for distribution file (* with compile option 'dist'), see [[output:bindistfile]] ||| 
 + 
 +|<100% 33% 33% 33%>| 
 +^ **maxchfile** | string | (none) | 
 +| file with maximal permissible changes for each parameter, see [[Maxchfile]] |||
  
 ====  options only for analytic potentials  ==== ====  options only for analytic potentials  ====
  
-**plotmin** - float - 0.0\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>starting point for plotting potentials, see [[Plotfile]]+^ **plotmin** | float | 0.0 | 
 +| starting point for plotting potentials, see [[output:plotfile]] |||
  
-**enable_cp** - boolean - 0\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>whether or not to include chemical potentials, see [[Pair|Potentials]]+^ **enable_cp** | boolean | 0 | 
 +| whether or not to include chemical potentials, see [[interactions:pair_potentials]] |||
  
 ====  options for output  ==== ====  options for output  ====
  
-**imdpotsteps** - integer - 1000\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>number of points in each function in imd and lammps potential files, see [[IMD]] / [[Lammps]]+^ **imdpotsteps** | integer | 500 | 
 +| number of sampling points in each function in imd potential files, see [[IMD]] |||
  
-**output_prefix** - string - (none)\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>prefix for various output files, see [[:Category:Output|Output]]+^ **output_prefix** | string | (none) | 
 +| prefix for various output files, see [[output:main|Output]] |||
  
-**extend** - float - 2.\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>how many steps should the imd potentials be extrapolated, see [[IMD]]+^ **extend** | float | 2.0 | 
 +| how many steps should the imd potentials be extrapolated, see [[IMD]] ||| 
 + 
 + 
 +|<100% 33% 33% 33%>| 
 +^ **lammpspotsteps** | integer | 500 | 
 +| number of sampling points in each funcation in LAMMPS potential files, see [[output:lammps|LAMMPS]] |||
  
 ====  parameter for option coulomb  ==== ====  parameter for option coulomb  ====
  
-**dp_cut** - float - 10 \\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>cutoff-radius for electrostatic interactions, doesn't depend on other pair-function-radii.+^ **dp_cut** | float | 10 | 
 +| cutoff-radius for electrostatic interactions, doesn't depend on other pair-function-radii. |||
  
 ====  parameters for option dipole  ==== ====  parameters for option dipole  ====
  
-**dp_tol** - float - 1.e-7\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>dipole iteration precision.+^ **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:openkim|OpenKIM]] page. 
 + 
 +|<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:openkim|OpenKIM]] page for details |||
  
-**dp_mix** - float - 0.2\\ +|<100% 33% 33% 33%>| 
-<html>&nbsp;&nbsp;&nbsp;</html>mixing parameter for dipole convergence during iteration.+^ **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.1362379926.txt.gz · Last modified: 2013/03/04 07:52 by daniel