Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • chronusq_public chronusq_public
  • Project information
    • Project information
    • Activity
    • Labels
    • Planning hierarchy
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 1
    • Issues 1
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • ChronusQ
  • chronusq_publicchronusq_public
  • Wiki
  • Input sections
  • Overview

Last edited by Andrew Wildman Oct 13, 2020
Page history

Overview

Table of contents

  • Table of contents
  • Input specification
  • Supported sections
  • Example

Input specification

The format of the ChronusQ input file loosely follows the INI file format commonly used in UNIX style configuration files, but has been customized for ChronusQ specifically. Most lines and keywords are case insensitive, but if they are case sensitive, it will be noted in the documentation. For example, most modern filesystems are case sensitive, so keywords that take a filesystem path are case sensitive.

In order to promote reproducibility, the input file is copied to the beginning of the output file at the beginning of the calculation.

Generally, there are 5 types of lines that an input file can contain:

  • Comment line: Begins with #
  • Section line: Contains a bracket enclosed section name, e.g. [Molecule]
  • Single line keywords: Contains a keyword definition in the form keyword = option
  • Multi-line keyword header: Contains the name of the multiline keyword in the form keyword:
  • Multi-line keyword continuation: Contains data for the most recent multiline keyword. Must be indented beyond the multiline keyword header. The exact form of this line is keyword dependent.

Graphically, this may be represented as:

# This is an example of a section definition
[Section]
var1 = value1
var2 = value2
multilinevar1:
  line1
  line2
  line3

The values in ChronusQ input may be expected to be a variety of types, listed in the table below:

Data Type Accepted formats
String Valid ASCII characters
Double precision float Decimal notation with possible exponential portion delimited by e
Integer ASCII digits
Boolean True or On (case insensitive) are true values. All other data is interpreted as false.

Supported sections

There are currently 9 supported input sections in the ChronusQ input file. Three of these sections are required for every calculation, and depending on the type of calculation, more may be required. For more information about their keywords and what they control, see the section pages specifically.

  • Molecule: Specification of molecular information such as atoms, charge, and multiplicity. Required.
  • Basis: Specification of the basis used for the calculation. Required.
  • QM: Specification of the Hamiltonian, wavefunction, and type of calculation. Required.
  • Ints: Options to control integral computation. Optional.
  • DFTInts: Options to control DFT grid evaluation. Optional.
  • SCF: Options to control SCF procedure. Optional.
  • RT: Options to control real time electron dynamics procedure. Required for RT jobs.
  • Response: Options to control response theory procedures. Required for Resp jobs.
  • Misc: Options to specify computational model. (parallelism, memory) Optional.

Example

#
#  Water RBHANDH/sto-3g / SCF parallel
#

#  Molecule Specification 
[Molecule]
charge = 0
mult = 1
geom: 
 O               0.  -0.07579184359              0.
 H     0.866811829    0.6014357793               0.
 H    -0.866811829    0.6014357793               0.

#  Job Specification
[QM]
reference = Real RBHANDH
job = SCF

# Basis Specification
[BASIS]
basis = sto-3g

# Computational Details
[MISC]
nsmp = 2
mem = 4GB

Further examples of input files are given in the Examples section of this documentation. If you would like even more examples, they can be found in the tests/<type of test>/<serial or parallel>/<type of reference> directories of the ChronusQ source code.

Clone repository

Overview and Features

Getting ChronusQ

Running ChronusQ

Input sections

     Overview
     QM and PROTQM
     Molecule
     Basis and DFBasis
     Ints
     DFTInts
     SCF
     RT
     Response
     CC
     MCSCF
     Misc

FAQ

Examples

     HF energy
     Relativistic DFT Energy
     Linear Response TDDFT
     Frequency dependent TDHF
     Model Order Reduction of TDDFT
     Electron dynamics

Keyword Reference

Binary Reference