Command-line Tools¶

ccu¶

___ ___ _ _

/ __/ __| | | |

(_| (__| |_| | ______|__,_|

ccu [OPTIONS] COMMAND [ARGS]...

Options

-V, --version¶: Show the version and exit.

-v, --verbose¶: Control how much information is printed to the terminal. This option can be repeated.

-q, --quiet¶

--log-file <log_file>¶: Specify a log file for all logging messages.

--log-level <log_level>¶

Specify the log level for all logging messages.

Options:: DEBUG | INFO | WARNING | ERROR | CRITICAL

adsorb¶

Create adsorbate complexes for a given structure.

Each complex is written to a .traj file with identifying metadata about the adsorbate identity, orientation, site, and structure.

ADSORBATE is the name of the adsorbate to place on the surface.

STRUCTURE is the path to the surface on which the adsorbate will be placed.

DESTINATION is the directory in which to write the .traj files. The directory is created if it does not exist. Defaults to the current working directory.

ccu adsorb [OPTIONS] ADSORBATE STRUCTURE [DESTINATION]

Options

-t, --adsorbate-tag, --tag <adsorbate_tag>¶

Specify an integer with which to tag adsorbate atoms.

Default:: -99

-s, --separation <separation>¶

Specify the minimum distance between the surface and any adsorbate atom

Default:: 1.8

-c, --centers <centers>¶

Specify a method of centering the adsorbate. ‘special’ will center adsorbates using the ‘special_centers’ key in the Atoms.info dictionary. ‘all’ will center adsorbates using their atomic coordinates. ‘com’ will center adsorbates by their center-of-mass.

Default:: 'com'
Options:: special | com | all

-f, --finder <finder>¶

Specify a site finder protocol. ‘tri’ will select the method implemented by ccu.adsorption.sites.Triangulator. ‘hub’ will select the method implemented by ccu.adsorption.sites.HubSpokeFinder

Default:: 'tri'
Options:: tri | hub

--no-symmetry, -Y, --symmetry¶: Whether or not to ignore the symmetry of the adsorbate when constructing adsorbate complexes. ‘–no-symmetry’ ignores symmetry. Symmetry is not considered by default.

-l, --list¶: List all available adsorbates

Arguments

ADSORBATE¶: Required argument

STRUCTURE¶: Required argument

DESTINATION¶: Optional argument

fed¶

Create free energy diagrams with the FancyPlots GUI.

ccu fed [OPTIONS]

Options

--cache <CACHE_FILE>¶: Load fancyplots with a cached session.

--data <DATA_FILE>¶: Initialize fancyplots with free energy diagram data. This should point to the result of dumping an instance of FEDData to a json file.

--style <STYLE_FILE>¶: Specify a style file.

init¶

Enable tab completion and create the ccu home directory.

ccu init [OPTIONS]

pop¶

Population analysis tools.

ccu pop [OPTIONS] COMMAND [ARGS]...

bader-sum¶

Sum the bader charges of atoms specified by indices.

INDICES is a list of integers indicating the indices for which to sum Bader charges. If –sort-file is set, the indices specified will still refer to the indices in the Atoms object before re-sorting. Note that if no indices are passed, then –smart-mode is activated and that if any indices are passed, then –smart-mode is ignored.

Examples:: ccu pop bader-sum –atoms final.traj –sort-file ase-sort.dat 0 1 2 22 ccu pop bader-sum –atoms final.traj –smart-mode –sort-file ase-sort.dat

ccu pop bader-sum [OPTIONS] [INDICES]...

Options

--atoms <atoms>¶: Required A file from which an Atoms object can be read via ase.io.read.

--smart-mode, --no-smart-mode¶: This is a special mode that will print out cumulative Bader charges for each tag group in the format TAG: BADER_CHARGE where TAG is an integer used to tag atoms in an Atoms object and BADER_CHARGE is the sum of the Bader charge of all atoms with that tag. Note that if both –smart-mode and INDICES are specified, this option is ignored.

--sort-file <sort_file>¶: Specify a file in the format of ‘ase-sort.dat’ used to translate indices in the Bader charge analysis file to the indices in the corresponding Atoms object.

--bader-file <bader_file>¶

Required Specify a path to the ‘ACF.dat’ file produced by the bader program.

Default:: 'ACF.dat'

Arguments

INDICES¶: Optional argument(s)

structure¶

Structure manipulation tools.

ccu structure [OPTIONS] COMMAND [ARGS]...

permute¶

Creates permutations of a given structure.

SITES is a list of sites to permute. Can be specified as a list of indices or a list of chemical symbols.

ccu structure permute [OPTIONS] [SITES]...

Options

-o, --occupant <occupants>¶: a 2-tuple indicating an element with which to permute the specified sites and the number of times to include the element. This option can be specified multiple times, but note that the sum of all second elements must not exceed the number of sites specified.

-s, --source <source>¶: Required the structure file to permute

-d, --destination <destination>¶: the directory in which to place the permuted structure files. Defaults to current working directory.

Arguments

SITES¶: Optional argument(s)

Examples::

ccu structure permute -o Co 1 -o Cu 1 -s Ni.traj -d trimetallics/ 0 1 2

ccu structure permute -o Co 1 -o Cu 1 -s NiO.traj -d trimetallics/ Ni

resize-cell¶

Resizes the c-vector and centers given structure.

STRUCTURE is the structure to be resized and centered.

C_VECTOR is the new magnitude of the c-vector.

ccu structure resize-cell [OPTIONS] STRUCTURE [C_VECTOR]

Arguments

STRUCTURE¶: Required argument

C_VECTOR¶: Optional argument

thermo¶

Thermochemistry tools.

ccu thermo [OPTIONS] COMMAND [ARGS]...

chempot¶

Launch the chemical potential calculator parametrized with PBE-D3.

MOLECULES are the molecules for which the chemical potential will be calculated.

ccu thermo chempot [OPTIONS] MOLECULE

Options

-t, --temperature <temperatures>¶

Specify the temperature (in Kelvin).

Default:: 273.15

-p, --pressure <pressures>¶

Specify the temperature (in bar).

Default:: 1.0

-i, --interactive¶: Execute interactively.

-l, --list¶: Print the list of all molecules for which chempot is parametrized

Arguments

MOLECULE¶: Optional argument(s)

gibbs¶

Calculate the free energy of a system.

ccu thermo gibbs [OPTIONS]

Options

-v, --verbose¶

Controls the verbosity. 0: Show messages of level warning and higher. 1: Show messages of level info and higher. 2: Show all messages-useful for debugging.

Default:: 0

-T, --transition-state¶

Assume that the system is a transition state when calculating the free energy of the system. One imaginary vibrational mode (corresponding to the reaction coordinate) will be discarded.

Default:: False

-S, --solution-phase¶

Assume that the system is in solution when calculating the free energy of the system. When activated, low vibrations are shifted to 100 cm^-1; otherwise, low vibrations are shifted to 12 cm^-1.

Default:: False

--ideal-gas¶

Use the ideal gas limit to calculate the free energy. With \(N\) atoms, \(3N - 6\) vibrational modes will be considered (\(3N - 5\) if the --linear flag is provided).

Default:: False

--harmonic¶

Use the harmonic limit to calculate the free energy. All vibrational modes will be considered.

Default:: True

-Y, --symmetry <symmetry>¶

Specify the symmetry number of the system. Note that this is only relevant under the ideal gas approximation.

Default:: 1

--linear¶

Specify that the system is linear. Note that this is only relevant under the ideal gas approximation.

Default:: False

--non-linear¶

Specify that the system is nonlinear. Note that this is only relevant under the ideal gas approximation.

Default:: True

-t, --temperature <temperature>¶

Specify the temperature (in Kelvin).

Default:: 273.15

-p, --pressure <pressure>¶

Specify the temperature (in bar). Note that this is only applicable for the ideal gas approximation.

Default:: 1.0

-s, --spin <spin>¶

Specify the spin. Note that this is only relevant for the gas-phase approximation.

Default:: 0

--atoms-file <atoms_file>¶

The name of the file containing the structure corresponding to the vibrational frequencies. Note that this is only used in the ideal gas approximation.

Default:: 'in.traj'

--dg-file <dg_file>¶

The name of the file in which the save the quantity \(-TS + ZPE\).

Default:: 'dg_ase.log'

--freq-file <freq_file>¶

The name of the file in which to save the frequencies used to calculate the free energy. Use “-” to print to the standard output.

Default:: 'gibbs_freq_used.txt'

--vib-file <vib_file>¶

The name of the file from which to read the frequencies used to calculate the free energy.

Default:: 'vib.txt'

--log-file <log_file>¶: The name of the file in which to save all the information used to calculate the free energy. Use - to print to the standard output.

--energy-file <energy_file>¶: The name of the file in which to save the free energy. Use - to print to the standard output.