ExcitedStateEnergies - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Toolboxes : Quantum Chemistry : ExcitedStateEnergies

QuantumChemistry

  

ExcitedStateEnergies

  

compute electronic excited-state energies

  

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

ExcitedStateEnergies(molecule, method, options)

Parameters

molecule

-

list of lists; each list has 4 elements, the string of an atom's symbol and atom's x, y, and z coordinates

method

-

(optional)  method = name/procedure where name is one of 'HartreeFock' (default), 'DensityFunctional'

nstates

-

(optional)  nstates = integer/list where the integer specifies the number of excited states computed  

showtable

-

(optional)  showtable = true or false (default) displays a fancy table when set to true

options

-

(optional) equation(s) of the form option = value where option is any valid option of the chosen method

Description

• 

ExcitationStateEnergies computes the excited-state energies from exciting a molecule from its ground state to its excited states.

• 

The procedure returns a (n+1)x2 Matrix containing the state indices and excited-state energies (hartrees) in columns 1 and 2.

• 

Methods, set by the method keyword, include 'HartreeFock' (default) and 'DensityFunctional'.

• 

The number n of excited states is determined by the optional keyword nstates.  If nstates = n, then n singlet and n triplet states are computed.  If nstates=[n,m], then n singlet and m triplet states are computed.  By default, nstates = 6.          

• 

The data can be displayed in a fancy table by setting the optional keyword showtable to true (the default is false).

• 

When the HartreeFock method is selected, the excited-state energies can be computed by either the time-dependent Hartree-Fock (TDHF) or the configuration interaction singles (CIS) method.  By default TDHF is performed.  TDHF and CIS can be directly selected by setting the optional keyword excited_states to the string "TDHF" or "CIS".   

• 

When the DensityFunctional method is selected, the excited-state energies can be computed by either the time-dependent density functional theory (TDDFT) or the Tamm-Dancoff approximation (TDA) method.  By default TDDFT is performed.  TDDFT and TDA can be directly selected by setting the optional keyword excited_states to the string "TDDFT" or "TDA".      

• 

The result depends upon the chosen molecule, method, and basis set among other options such as charge, spin, and symmetry.  The ground-state molecule must be in a singlet state, that is spin = 0.

• 

The command only works with methods that return excitation energies.

• 

Because the methods employ Maple remember tables, the procedure only computes the results if they have not been previously computed by calling the method directly or indirectly through another property.

Examples

withQuantumChemistry:

The excited-state energies of the uracil molecule can be computed with the Hartree-Fock (TDHF) method.  

First, we define the molecule's geometry with the MolecularGeometry command

molecule  MolecularGeometryuracil;

moleculeO,2.32640000,0.96510000,0.00010000,O,−2.29720000,1.02320000,0.00050000,N,0.01800000,1.01990000,−0.00020000,N,1.16370000,−1.02210000,0.00010000,C,1.25240000,0.36290000,0,C,−1.23150000,0.41410000,−0.00040000,C,−0.02680000,−1.69550000,0.00020000,C,−1.20490000,−1.06760000,−0.00020000,H,0.03820000,2.03570000,−0.00010000,H,2.01870000,−1.57020000,0.00040000,H,−2.14430000,−1.60630000,−0.00020000,H,0.04690000,−2.77610000,0.00040000

(1)

Second, we plot uracil with the PlotMolecule command

PlotMoleculemolecule;

Finally, we compute the excited-state energies

spectra_hf  ExcitedStateEnergiesmolecule;

By double clicking the output matrix above, the result can be viewed in a Matrix Browser with options to export the data.

The excited-state energies can also be displayed in a fancy table by setting the optional keyword showtable to true

spectra_hf  ExcitedStateEnergiesmolecule,showtable=true:

State

Energy

1

407.01717695E0

2

406.98781819E0

3

406.93057336E0

4

406.92221909E0

5

406.89547452E0

6

406.89173206E0

7

406.85874373E0

8

406.79627862E0

9

406.78327921E0

10

406.74373986E0

11

406.73480220E0

12

406.72929634E0

 

 

The number of states computed can be controlled with the keyword nstates; i.e., nstates=1 computes 1 singlet and 1 triplet state

spectra_hf  ExcitedStateEnergiesmolecule,nstates=1, showtable=true:

State

Energy

1

407.01717046E0

2

406.89547476E0

 

See Also

ExcitedStateSpins
ExcitationSpectra

ExcitationSpectraPlot
Energy
HartreeFock
DensityFunctional