From 5b55640fd9013bd46b012fc16a600c427e7f2fb4 Mon Sep 17 00:00:00 2001
From: Shyue Ping Ong Support for new Lobster versions (@naik-aakash) Bug fix for termination of gamma VASP runs. This is a script to converge the geometry of a system This is a master vasp running script to converging kpoints for a calculation Generate the runs using a generator until convergence is achieved. Basic script to run nwchem job. This is a master vasp running script to perform various combinations of VASP
-runs. This module implements specific error handler for FEFF runs. Bases: Correct the unconverged error of FEFF’s SCF calculation. Initializes the handler with the output file to check output_filename (str) – Filename for the log1.dat file. log1.dat file
-contains the SCF calculation convergence information. Change this only
-if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Implements various interpreters and modders for FEFF calculations. Bases: A Modder for FeffInput sets actions ([Action]) – A sequence of supported actions. See actions – A sequence of supported actions. See
- strict (bool) – Indicating whether to use strict mode. In non-strict
-mode, unsupported actions are simply ignored without any
-errors raised. In strict mode, if an unsupported action is
-supplied, a ValueError is raised. Defaults to True. feffinp (FEFFInput) – A FeffInput object from the current directory.
-Initialized automatically if not passed (but passing it will
-avoid having to reparse the directory). This module implements specific error handler for Lobster runs. Bases: Check if spilling is below certain threshold! output_filename – filename of the output file of lobter, usually lobsterout charge_spilling_limit – limit of the charge spilling that will be considered okay Bases: validates if enough bands for COHP calculation are available output_filename – filename of output file, usually lobsterout Bases: normally create upon running. Check if lobster terminated normally by looking for finished Dummy init This module implements error handlers for Nwchem runs. Currently tested only
-for B3LYP DFT jobs. Bases: Error handler for Nwchem Jobs. Currently tested only for B3LYP DFT jobs
-generated by pymatgen. Initializes with an output file name. output_filename (str) – This is the file where the stdout for nwchem
-is being redirected. The error messages that are checked are
-present in the stdout. Defaults to “mol.nwout”, which is the
-default redirect used by This module implements specific error handlers for VASP runs. These handlers
-try to detect common errors in vasp runs and attempt to fix them on the fly
-by modifying the input files. Bases: Master VaspErrorHandler class that handles a number of common errors
-that occur during VASP runs. Initializes the handler with the output file to check. output_filename (str) – This is the file where the stdout for vasp
-is being redirected. The error messages that are checked are
-present in the stdout. Defaults to “vasp.out”, which is the
-default redirect used by This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: This is not an error handler per se, but rather a checkpointer. What this
-does is that every X seconds, a STOPCAR and CHKPT will be written. This
-forces VASP to stop at the end of the next ionic step. The files are then
-copied into a subdir, and then the job is restarted. To use this proper,
-max_errors in Custodian must be set to a very high value, and you
-probably wouldn’t want to use any standard VASP error handlers. The
-checkpoint will be stored in subdirs chk_#. This should be used in
-combination with the StoppedRunHandler. Initializes the handler with an interval. interval (int) – Interval at which to checkpoint in seconds. 3600 (Defaults to) – This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Whether this handler terminates a job upon error detection. By
-default, this is True, which means that the current Job will be
-terminated upon error detection, corrections applied,
-and restarted. In some instances, some errors may not need the job to be
-terminated or may need to wait for some other event to terminate a job.
-For example, a particular error may require a flag to be set to request
-a job to terminate gracefully once it finishes its current task. The
-handler to set the flag should be classified as is_terminating = False to
-not terminate the job. Bases: Corrects for total drift exceeding the force convergence criteria. Initializes the handler with max drift
-:param max_drift: This defines the max drift. Leaving this at the default of None gets the max_drift from EDFIFFG Bases: Detects an error when the output file has not been updated
-in timeout seconds. Changes ALGO to Normal from Fast Initializes the handler with the output file to check. output_filename (str) – This is the file where the stdout for vasp
-is being redirected. The error messages that are checked are
-present in the stdout. Defaults to “vasp.out”, which is the
-default redirect used by timeout (int) – The time in seconds between checks where if there
-is no activity on the output file, the run is considered
-frozen. Defaults to 3600 seconds, i.e., 1 hour. This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Check if a calculation is a metal (zero bandgap), has been run with
-ISMEAR=-5, and is not a static calculation, which is only appropriate for
-semiconductors. If this occurs, this handler will rerun the calculation
-using the smearing settings appropriate for metals (ISMEAR=2, SIGMA=0.2). Initializes the handler with the output file to check. output_filename (str) – Filename for the vasprun.xml file. Change
-this only if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: When ISMEAR > 0 (Methfessel-Paxton), monitor the magnitude of the entropy
-term T*S in the OUTCAR file. If the entropy term is larger than 1 meV/atom, reduce the
-value of SIGMA. See VASP documentation for ISMEAR. Initializes the handler with a buffer time. This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Corrects LRF_COMMUTATOR errors by setting LPEAD=True if not already set.
-Note that switching LPEAD=T can slightly change results versus the
-default due to numerical evaluation of derivatives. Initializes the handler with the output file to check. output_filename (str) – This is the file where the stderr for vasp
-is being redirected. The error messages that are checked are
-present in the stderr. Defaults to “std_err.txt”, which is the
-default redirect used by This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Corrects the mesh symmetry error in VASP. This error is sometimes
-non-fatal. So this error handler only checks at the end of the run,
-and if the run has converged, no error is recorded. Initializes the handler with the output files to check. output_filename (str) – This is the file where the stdout for vasp
-is being redirected. The error messages that are checked are
-present in the stdout. Defaults to “vasp.out”, which is the
-default redirect used by output_vasprun (str) – Filename for the vasprun.xml file. Change
-this only if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Check if a run is hitting the maximum number of electronic steps at the
-last nionic_steps ionic steps (default=10). If so, change ALGO using a
-multi-step ladder scheme or kill the job. Initializes the handler with the output file to check. output_filename (str) – This is the OSZICAR file. Change
-this only if it is different from the default (unlikely). nionic_steps (int) – The threshold number of ionic steps that
-needs to hit the maximum number of electronic steps for the
-run to be considered non-converging. Custom from_dict method to preserve backwards compatibility with
-older versions of Custodian. This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Check if a run has positive absolute energy.
-If so, change ALGO from Fast to Normal or kill the job. Initializes the handler with the output file to check. output_filename (str) – This is the OSZICAR file. Change
-this only if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Check if a run has excessively large positive energy changes.
-This is typically caused by too large a POTIM. Runs typically
-end up crashing with some other error (e.g. BRMIX) as the geometry
-gets progressively worse. Initializes the handler with the input and output files to check. input_filename (str) – This is the POSCAR file that the run
-started from. Defaults to “POSCAR”. Change
-this only if it is different from the default (unlikely). output_filename (str) – This is the OSZICAR file. Change
-this only if it is different from the default (unlikely). dE_threshold (float) – The threshold energy change. Defaults to 1eV. This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Check if a SCAN calculation is a metal (zero bandgap) but has been run with
-a KSPACING value appropriate for semiconductors. If this occurs, this handler
-will rerun the calculation using the KSPACING setting appropriate for metals
-(KSPACING=0.22). Note that this handler depends on values set in MPScanRelaxSet. Initializes the handler with the output file to check. output_filename (str) – Filename for the vasprun.xml file. Change
-this only if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Master StdErr class that handles a number of common errors
-that occur during VASP runs with error messages only in
-the standard error. Initializes the handler with the output file to check. output_filename (str) – This is the file where the stderr for vasp
-is being redirected. The error messages that are checked are
-present in the stderr. Defaults to “std_err.txt”, which is the
-default redirect used by This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: This is not an error handler per se, but rather a checkpointer. What this
-does is that every X seconds, a STOPCAR will be written. This forces VASP to
-stop at the end of the next ionic step. The files are then copied into a
-subdir, and then the job is restarted. To use this proper, max_errors in
-Custodian must be set to a very high value, and you probably wouldn’t
-want to use any standard VASP error handlers. The checkpoint will be
-stored in subdirs chk_#. This should be used in combination with the
-StoppedRunHandler. Dummy init. This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Whether this handler terminates a job upon error detection. By
-default, this is True, which means that the current Job will be
-terminated upon error detection, corrections applied,
-and restarted. In some instances, some errors may not need the job to be
-terminated or may need to wait for some other event to terminate a job.
-For example, a particular error may require a flag to be set to request
-a job to terminate gracefully once it finishes its current task. The
-handler to set the flag should be classified as is_terminating = False to
-not terminate the job. Bases: Check if a run is converged. Initializes the handler with the output file to check. output_vasprun (str) – Filename for the vasprun.xml file. Change
-this only if it is different from the default (unlikely). This class property indicates whether the error handler is a monitor,
-i.e., a handler that monitors a job as it is running. If a
-monitor-type handler notices an error, the job will be sent a
-termination signal, the error is then corrected,
-and then the job is restarted. This is useful for catching errors
-that occur early in the run but do not cause immediate failure. Bases: Master VaspErrorHandler class that handles a number of common errors
-that occur during VASP runs. Initializes the handler with the output file to check. output_filename (str) – This is the file where the stdout for vasp
-is being redirected. The error messages that are checked are
-present in the stdout. Defaults to “vasp.out”, which is the
-default redirect used by natoms_large_cell (int) – Number of atoms threshold to treat cell
-as large. Affects the correction of certain errors. Defaults to
-None (not used). Deprecated. errors_subset_to_detect (list) – A subset of errors to catch. The
-default is None, which means all supported errors are detected.
-Use this to only catch only a subset of supported errors.
-E.g., [“eddrrm”, “zheev”] will only catch the eddrmm and zheev
-errors, and not others. If you wish to only excluded one or
-two of the errors, you can create this list by the following
-lines: vtst_fixes (bool) – Whether to consider VTST optimizers. Defaults to
-False for compatibility purposes. ```
-subset = list(VaspErrorHandler.error_msgs.keys())
-subset.pop(“eddrrm”) handler = VaspErrorHandler(errors_subset_to_catch=subset)
-```Navigation
Navigation
Navigation
Navigation
Navigation
Navigation
Source code for custodian.lobster.jobs
from custodian.custodian import Job
-__author__ = "Janine George, Guido Petretto"
+__author__ = "Janine George, Guido Petretto,Aakash Naik"
__copyright__ = "Copyright 2020, The Materials Project"
__version__ = "0.1"
__maintainer__ = "Janine George"
@@ -79,7 +79,13 @@
Source code for custodian.lobster.jobs
"ICOOPLIST.lobster",
"lobster.out",
"projectionData.lobster",
+ "MadelungEnergies.lobster",
+ "SitePotentials.lobster",
+ "bandOverlaps.lobster",
+ "ICOBILIST.lobster",
+ "COBICAR.lobster",
]
+FW_FILES = ["custodian.json", "FW.json", "FW_submit.script"]
logger = logging.getLogger(__name__)
@@ -149,6 +155,9 @@
Source code for custodian.lobster.jobs
if self.backup:
if os.path.exists("lobsterin.orig"):
compress_file("lobsterin.orig", compression="gz")
+ for file in FW_FILES:
+ if os.path.exists(file):
+ compress_file(file, compression="gz")
for file in self.add_files_to_gzip:
compress_file(file, compression="gz")
Navigation
Navigation
Source code for custodian.qchem.utils
reversed_direction (bool): If True, then perturb in direction opposite of frequency modes.
"""
- max_dis = max(math.sqrt(sum(x ** 2 for x in vec)) for vec in negative_freq_vecs)
+ max_dis = max(math.sqrt(sum(x**2 for x in vec)) for vec in negative_freq_vecs)
scale = molecule_perturb_scale / max_dis
normalized_vecs = [[x * scale for x in vec] for vec in negative_freq_vecs]
direction = 1.0
diff --git a/docs/_modules/custodian/utils.html b/docs/_modules/custodian/utils.html
index 1418741d..54b482ad 100644
--- a/docs/_modules/custodian/utils.html
+++ b/docs/_modules/custodian/utils.html
@@ -5,7 +5,7 @@
-
Navigation
Navigation
Navigation
All modules for which code is available
diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
index e95ca3d9..c8afe1ac 100644
--- a/docs/_static/documentation_options.js
+++ b/docs/_static/documentation_options.js
@@ -1,6 +1,6 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
- VERSION: '2022.1.17',
+ VERSION: '2022.2.13',
LANGUAGE: 'None',
COLLAPSE_INDEX: false,
BUILDER: 'html',
diff --git a/docs/_themes/README.html b/docs/_themes/README.html
index 57277f32..8fd83600 100644
--- a/docs/_themes/README.html
+++ b/docs/_themes/README.html
@@ -6,7 +6,7 @@
- Navigation
Navigation
Navigation
Change Log¶
+v2022.2.13¶
+
+
+v2022.1.17¶
@@ -415,6 +422,7 @@
Version 0.2.4Table of Contents
@@ -52,43 +52,11 @@
+
diff --git a/docs/custodian.cli.html b/docs/custodian.cli.html
index 3e62b298..3654ee2c 100644
--- a/docs/custodian.cli.html
+++ b/docs/custodian.cli.html
@@ -6,7 +6,7 @@
- Navigation
Navigation
custodian.cli package
Submodules¶
custodian.cli.converge_geometry module¶
-custodian.cli.converge_geometry module¶
custodian.cli.converge_kpoints module¶
-
-
-
-
-
+custodian.cli.converge_kpoints module¶
custodian.cli.cstdn module¶
@@ -112,50 +80,11 @@ Submodules
-
custodian.cli.run_nwchem module¶
-custodian.cli.run_nwchem module¶
custodian.cli.run_vasp module¶
-custodian.cli.run_vasp module¶
Module contents¶
@@ -175,11 +104,11 @@ Table of Contents
@@ -57,90 +57,11 @@
Navigation
Subpackages
Submodules¶
custodian.feff.handlers module¶
-
-
-
+custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-custodian.feff.handlers module¶
custodian.feff.interpreter module¶
-
-
-
+custodian.ansible.interpreter.Modder
-
-
-
-
-
-custodian.ansible.actions
. Default is None,
-which means DictActions and FileActions are supported.custodian.feff.interpreter module¶
custodian.feff.jobs module¶
@@ -211,8 +132,8 @@ Table of Contents
diff --git a/docs/custodian.html b/docs/custodian.html
index 13d92d43..c52f1d4a 100644
--- a/docs/custodian.html
+++ b/docs/custodian.html
@@ -6,7 +6,7 @@
- Navigation
Subpackagescustodian.cli package
@@ -78,8 +78,8 @@ SubpackagesSubmodules
-
SubpackagesSubmodules
-
SubpackagesSubmodules
-
SubpackagesSubmodules
-
Navigation
Subpackages
Submodules¶
custodian.lobster.handlers module¶
-
-
-
-custodian.custodian.Validator
-
-
-
-
-
-
-
-
-custodian.custodian.Validator
-
-
-
-
-
-
+custodian.custodian.Validator
-
-custodian.lobster.handlers module¶
custodian.lobster.jobs module¶
@@ -179,7 +120,7 @@ Table of Contents
diff --git a/docs/custodian.nwchem.html b/docs/custodian.nwchem.html
index 11b622b3..7e4cac14 100644
--- a/docs/custodian.nwchem.html
+++ b/docs/custodian.nwchem.html
@@ -6,7 +6,7 @@
- Navigation
Subpackages
Submodules¶
custodian.nwchem.handlers module¶
-
-
-
+custodian.custodian.ErrorHandler
-
-
-
-
-
-custodian.nwchem.jobs
-.NwchemJob
.custodian.nwchem.handlers module¶
custodian.nwchem.jobs module¶
@@ -159,7 +127,7 @@ Table of Contents
diff --git a/docs/custodian.qchem.html b/docs/custodian.qchem.html
index 4070e92a..fbc87268 100644
--- a/docs/custodian.qchem.html
+++ b/docs/custodian.qchem.html
@@ -6,7 +6,7 @@
- Navigation
Navigation
Subpackages
Submodules¶
custodian.vasp.handlers module¶
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-custodian.vasp.jobs.VaspJob
.
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-custodian.vasp.jobs.VaspJob
.
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-custodian.vasp.jobs.VaspJob
.
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-custodian.vasp.jobs.VaspJob
.
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-custodian.vasp.jobs.VaspJob
.
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-custodian.custodian.ErrorHandler
-
-
-
-
-
-
-
-
-
-
custodian.custodian.ErrorHandler
-
-
custodian.vasp.jobs.VaspJob
.
Check for error.
-Perform corrections.
-This class property indicates whether the error handler is a monitor, -i.e., a handler that monitors a job as it is running. If a -monitor-type handler notices an error, the job will be sent a -termination signal, the error is then corrected, -and then the job is restarted. This is useful for catching errors -that occur early in the run but do not cause immediate failure.
-Bases: custodian.custodian.ErrorHandler
Check if a run is nearing the walltime. If so, write a STOPCAR with -LSTOP or LABORT = .True.. You can specify the walltime either in the init ( -which is unfortunately necessary for SGE and SLURM systems. If you happen -to be running on a PBS system and the PBS_WALLTIME variable is in the run -environment, the wall time will be automatically determined if not set.
-Initializes the handler with a buffer time.
-wall_time (int) – Total walltime in seconds. If this is None and -the job is running on a PBS system, the handler will attempt to -determine the walltime from the PBS_WALLTIME environment -variable. If the wall time cannot be determined or is not -set, this handler will have no effect.
buffer_time (int) – The min amount of buffer time in secs at the -end that the STOPCAR will be written. The STOPCAR is written -when the time remaining is < the higher of 3 x the average -time for each ionic step and the buffer time. Defaults to -300 secs, which is the default polling time of Custodian. -This is typically sufficient for the current ionic step to -complete. But if other operations are being performed after -the run has stopped, the buffer time may need to be increased -accordingly.
electronic_step_stop (bool) – Whether to check for electronic steps -instead of ionic steps (e.g. for static runs on large systems or -static HSE runs, …). Be careful that results such as density -or wavefunctions might not be converged at the electronic level. -Should be used with LWAVE = .True. to be useful. If this is -True, the STOPCAR is written with LABORT = .TRUE. instead of -LSTOP = .TRUE.
Check for error.
-Perform corrections.
-This class property indicates whether the error handler is a monitor, -i.e., a handler that monitors a job as it is running. If a -monitor-type handler notices an error, the job will be sent a -termination signal, the error is then corrected, -and then the job is restarted. This is useful for catching errors -that occur early in the run but do not cause immediate failure.
-Whether this handler terminates a job upon error detection. By -default, this is True, which means that the current Job will be -terminated upon error detection, corrections applied, -and restarted. In some instances, some errors may not need the job to be -terminated or may need to wait for some other event to terminate a job. -For example, a particular error may require a flag to be set to request -a job to terminate gracefully once it finishes its current task. The -handler to set the flag should be classified as is_terminating = False to -not terminate the job.
-Whether this handler causes custodian to raise a runtime error if it cannot -handle the error (i.e. if correct returns a dict with “actions”:None, or -“actions”:[])
-Implements various interpreters and modders for VASP.
-Bases: custodian.ansible.interpreter.Modder
A Modder for VaspInputSets.
-Initializes a Modder for VaspInput sets
-actions ([Action]) – A sequence of supported actions. See
-custodian.ansible.actions
. Default is None,
-which means DictActions and FileActions are supported.
strict (bool) – Indicating whether to use strict mode. In non-strict -mode, unsupported actions are simply ignored without any -errors raised. In strict mode, if an unsupported action is -supplied, a ValueError is raised. Defaults to True.
vi (VaspInput) – A VaspInput object from the current directory. -Initialized automatically if not passed (but passing it will -avoid having to reparse the directory).
Applies a list of actions to the Vasp Input Set and rewrites modified -files. -:param actions [dict]: A list of actions of the form {‘file’: filename,
---‘action’: moddermodification} or {‘dict’: vaspinput_key, -‘action’: moddermodification}
-
This module implements basic kinds of jobs for VASP runs.
-Bases: custodian.custodian.Job
Generates a VASP input based on an existing directory. This is typically -used to modify the VASP input files before the next VaspJob.
-input_set (str) – Full path to the input set. E.g., -“pymatgen.io.vasp.sets.MPNonSCFSet”.
contcar_only (bool) – If True (default), only CONTCAR structures -are used as input to the input set.
Dummy postprocess.
-Run the calculation.
-Dummy setup
-Bases: custodian.custodian.Job
A basic vasp job. Just runs whatever is in the directory. But conceivably -can be a complex processing of inputs etc. with initialization.
-This constructor is necessarily complex due to the need for -flexibility. For standard kinds of runs, it’s often better to use one -of the static constructors. The defaults are usually fine too.
-vasp_cmd (str) – Command to run vasp as a list of args. For example, -if you are using mpirun, it can be something like -[“mpirun”, “pvasp.5.2.11”]
output_file (str) – Name of file to direct standard out to. -Defaults to “vasp.out”.
stderr_file (str) – Name of file to direct standard error to. -Defaults to “std_err.txt”.
suffix (str) – A suffix to be appended to the final output. E.g., -to rename all VASP output from say vasp.out to -vasp.out.relax1, provide “.relax1” as the suffix.
final (bool) – Indicating whether this is the final vasp job in a -series. Defaults to True.
backup (bool) – Whether to backup the initial input files. If True, -the INCAR, KPOINTS, POSCAR and POTCAR will be copied with a -“.orig” appended. Defaults to True.
auto_npar (bool) – Whether to automatically tune NPAR to be sqrt( -number of cores) as recommended by VASP for DFT calculations. -Generally, this results in significant speedups. Defaults to -False. Set to False for HF, GW and RPA calculations.
auto_gamma (bool) – Whether to automatically check if run is a -Gamma 1x1x1 run, and whether a Gamma optimized version of -VASP exists with “.gamma” appended to the name of the VASP -executable (typical setup in many systems). If so, run the -gamma optimized version of VASP instead of regular VASP. You -can also specify the gamma vasp command using the -gamma_vasp_cmd argument if the command is named differently.
settings_override ([dict]) –
An ansible style list of dict to -override changes. For example, to set ISTART=1 for subsequent -runs and to copy the CONTCAR to the POSCAR, you will provide:
-[{"dict": "INCAR", "action": {"_set": {"ISTART": 1}}},
- {"file": "CONTCAR",
- "action": {"_file_copy": {"dest": "POSCAR"}}}]
-
gamma_vasp_cmd (str) – Command for gamma vasp version when -auto_gamma is True. Should follow the list style of -subprocess. Defaults to None, which means “.gamma” is added -to the last argument of the standard vasp_cmd.
copy_magmom (bool) – Whether to copy the final magmom from the -OUTCAR to the next INCAR. Useful for multi-relaxation runs -where the CHGCAR and WAVECAR are sometimes deleted (due to -changes in fft grid, etc.). Only applies to non-final runs.
auto_continue (bool) – Whether to automatically continue a run -if a STOPCAR is present. This is very useful if using the -wall-time handler which will write a read-only STOPCAR to -prevent VASP from deleting it once it finishes
Returns a generator of jobs for a constrained optimization run. Typical -use case is when you want to approximate a biaxial strain situation, -e.g., you apply a defined strain to a and b directions of the lattice, -but allows the c-direction to relax.
-Some guidelines on the use of this method: -i. It is recommended you do not use the Auto kpoint generation. The
---grid generated via Auto may fluctuate with changes in lattice -param, resulting in numerical noise.
-
Make sure your EDIFF/EDIFFG is properly set in your INCAR. The -optimization relies on these values to determine convergence.
vasp_cmd (str) – Command to run vasp as a list of args. For example, -if you are using mpirun, it can be something like -[“mpirun”, “pvasp.5.2.11”]
lattice_direction (str) – Which direction to relax. Valid values are -“a”, “b” or “c”.
initial_strain (float) – An initial strain to be applied to the -lattice_direction. This can usually be estimated as the -negative of the strain applied in the other two directions. -E.g., if you apply a tensile strain of 0.05 to the a and b -directions, you can use -0.05 as a reasonable first guess for -initial strain.
atom_relax (bool) – Whether to relax atomic positions.
max_steps (int) – The maximum number of runs. Defaults to 20 ( -highly unlikely that this limit is ever reached).
algo (str) – Algorithm to use to find minimum. Default is “bfgs”, -which is fast, but can be sensitive to numerical noise -in energy calculations. The alternative is “bisection”, -which is more robust but can be a bit slow. The code does fall -back on the bisection when bfgs gives a non-sensical result, -e.g., negative lattice params.
**vasp_job_kwargs – Passthrough kwargs to VaspJob. See
-custodian.vasp.jobs.VaspJob
.
Generator of jobs. At the end of the run, an “EOS.txt” is written -which provides a quick look at the E vs lattice parameter.
-Returns a list of two jobs corresponding to an AFLOW style double -relaxation run.
-vasp_cmd (str) – Command to run vasp as a list of args. For example, -if you are using mpirun, it can be something like -[“mpirun”, “pvasp.5.2.11”]
auto_npar (bool) – Whether to automatically tune NPAR to be sqrt( -number of cores) as recommended by VASP for DFT calculations. -Generally, this results in significant speedups. Defaults to -True. Set to False for HF, GW and RPA calculations.
ediffg (float) – Force convergence criteria for subsequent runs ( -ignored for the initial run.)
half_kpts_first_relax (bool) – Whether to halve the kpoint grid -for the first relaxation. Speeds up difficult convergence -considerably. Defaults to False.
List of two jobs corresponding to an AFLOW style run.
-Returns a generator of jobs for a full optimization run. Basically, -this runs an infinite series of geometry optimization jobs until the -% vol change in a particular optimization is less than vol_change_tol.
-vasp_cmd (str) – Command to run vasp as a list of args. For example, -if you are using mpirun, it can be something like -[“mpirun”, “pvasp.5.2.11”]
vol_change_tol (float) – The tolerance at which to stop a run. -Defaults to 0.05, i.e., 5%.
max_steps (int) – The maximum number of runs. Defaults to 10 ( -highly unlikely that this limit is ever reached).
ediffg (float) – Force convergence criteria for subsequent runs ( -ignored for the initial run.)
half_kpts_first_relax (bool) – Whether to halve the kpoint grid -for the first relaxation. Speeds up difficult convergence -considerably. Defaults to False.
**vasp_job_kwargs – Passthrough kwargs to VaspJob. See
-custodian.vasp.jobs.VaspJob
.
Generator of jobs.
-Returns a list of thres jobs to perform an optimization for any -metaGGA functional. There is an initial calculation of the -GGA wavefunction which is fed into the initial metaGGA optimization -to precondition the electronic structure optimizer. The metaGGA -optimization is performed using the double relaxation scheme
-Postprocessing includes renaming and gzipping where necessary. -Also copies the magmom to the incar if necessary
-Perform the actual VASP run.
-(subprocess.Popen) Used for monitoring.
-Performs initial setup for VaspJob, including overriding any settings -and backing up.
-Ensure all vasp jobs are killed.
-Bases: custodian.custodian.Job
A NEB vasp job, especially for CI-NEB running at PBS clusters. -The class is added for the purpose of handling a different folder -arrangement in NEB calculation.
-This constructor is a simplified version of VaspJob, which satisfies -the need for flexibility. For standard kinds of runs, it’s often -better to use one of the static constructors. The defaults are -usually fine too.
-vasp_cmd (str) – Command to run vasp as a list of args. For example, -if you are using mpirun, it can be something like -[“mpirun”, “pvasp.5.2.11”]
output_file (str) – Name of file to direct standard out to. -Defaults to “vasp.out”.
stderr_file (str) – Name of file to direct standard error to. -Defaults to “std_err.txt”.
suffix (str) – A suffix to be appended to the final output. E.g., -to rename all VASP output from say vasp.out to -vasp.out.relax1, provide “.relax1” as the suffix.
final (bool) – Indicating whether this is the final vasp job in a -series. Defaults to True.
backup (bool) – Whether to backup the initial input files. If True, -the INCAR, KPOINTS, POSCAR and POTCAR will be copied with a -“.orig” appended. Defaults to True.
auto_npar (bool) – Whether to automatically tune NPAR to be sqrt( -number of cores) as recommended by VASP for DFT calculations. -Generally, this results in significant speedups. Defaults to -True. Set to False for HF, GW and RPA calculations.
half_kpts (bool) – Whether to halve the kpoint grid for NEB. -Speeds up convergence considerably. Defaults to False.
auto_gamma (bool) – Whether to automatically check if run is a -Gamma 1x1x1 run, and whether a Gamma optimized version of -VASP exists with “.gamma” appended to the name of the VASP -executable (typical setup in many systems). If so, run the -gamma optimized version of VASP instead of regular VASP. You -can also specify the gamma vasp command using the -gamma_vasp_cmd argument if the command is named differently.
auto_continue (bool) – Whether to automatically continue a run -if a STOPCAR is present. This is very useful if using the -wall-time handler which will write a read-only STOPCAR to -prevent VASP from deleting it once it finishes.
gamma_vasp_cmd (str) – Command for gamma vasp version when -auto_gamma is True. Should follow the list style of -subprocess. Defaults to None, which means “.gamma” is added -to the last argument of the standard vasp_cmd.
settings_override ([dict]) –
An ansible style list of dict to -override changes. For example, to set ISTART=1 for subsequent -runs and to copy the CONTCAR to the POSCAR, you will provide:
-[{"dict": "INCAR", "action": {"_set": {"ISTART": 1}}},
- {"file": "CONTCAR",
- "action": {"_file_copy": {"dest": "POSCAR"}}}]
-
Postprocessing includes renaming and gzipping where necessary.
-Perform the actual VASP run.
-(subprocess.Popen) Used for monitoring.
-Performs initial setup for VaspNEBJob, including overriding any settings -and backing up.
-Implements various validatiors, e.g., check if vasprun.xml is valid, for VASP.
-Bases: custodian.custodian.Validator
Check if the data in the AECCAR is corrupted
-Dummy init
-Check for error.
-Bases: custodian.custodian.Validator
normally create upon running.
-Dummy init
-Check for error.
-Bases: custodian.custodian.Validator
Check NpT-AIMD settings is loaded by VASP compiled with -Dtbdyn. -Currently, VASP only have Langevin thermostat (MDALGO = 3) for NpT ensemble.
-Dummy init.
-Check for error.
-Bases: custodian.custodian.Validator
Checks that a valid vasprun.xml was generated
-output_file (str) – Name of file VASP standard output is directed to. -Defaults to “vasp.out”.
stderr_file (str) – Name of file VASP standard error is direct to. -Defaults to “std_err.txt”.
Check for error.
-Check if the charge density file is corrupt -:param chgcar: Chgcar-like object. -:type chgcar: Chgcar -:param diff_thresh: Threshold for diagonal difference.
---None means we won’t check for this.
-
|
-
|
+
|