Skip to main content

A Shavitt graph visualizer

Project description

Iditarod

Iditarod is visualizer for Shavitt graphs, which are a representation of the complete configuration state function (CSF) expansion space within a molecular electronic structure calculation.

Graph settings

The light grid can be toggled with the "Grid" checkbox. It represents all possible CSFs with a given number of orbitals. The maximum number of orbitals supported is 35, beyond that the number of CSFs can exceed the limits of 64-bit integers.

grid graph

The colored balls and cylinders can be toggled with the "Wfn" (wave function) checkbox. They represent all possible CSFs compatible with the specified number electrons (and orbitals) and multiplicity, and with any RAS or GAS restrictions. The cylinders are colored by step vector type: red: "0", yellow: "u", purple: "d", blue: "2".

wave function graph

RAS restrictions can be specified by setting the number of orbitals and maximum number of holes in RAS1, and the number of orbitals and maximum number of electrons in RAS3. GAS restrictions can be specified with any number of "n m l" triplets, separated by semicolons, where "n" is the number of orbitals in the GAS subspace, and "m" and "l" are the minimum and maximum allowed cumulative number of electrons in all subspaces up to that point.

The total number of CSFs (not counting different spin projection values), vertices and edges in the selected wave function graph is displayed.

Representations

Several representations are available:

  • "Projected" is close to the most common representation in the literature. The vertical axis corresponds to the number of orbitals. The horizontal axis is a combination of the number of electrons and intermediate spin.

    projected representation

  • "Canonical" is a straightforward representation of the (a,b,c) Paldus values as the three orthogonal axes. Note that step vectors of type "d" (down) are unit cube diagonals.

    canonical representation

  • "Symmetric": the vertical axis is the number of orbitals, the horizontal axis is the number of "excess" electrons (positive: more electrons than orbitals, negative: more orbitals than electrons), the depth axis is twice the intermediate spin (the b value). The grid is a face-centered cubic lattice, all step vectors are of the same length and join nearest neighbors, only the "side" diagonals are missing. This is the default.

    symmetric representation

  • "Natural": the vertical axis is the number of orbitals, the horizontal axis is the number of electrons, the depth axis is the intermediate spin.

    natural representation

The sliders below the selectors for electrons, orbitals and multiplicity show the planes where these are constant.

constant electrons plane constant orbitals plane constant multiplicity plane

CSF highlight and coupling

Any single CSF can be highlighted in white by writing its string in the box. Alternatively, the slider and selector can be used to select a CSF by its index (in lexicographic order: "2" < "u" < "d" < "0").

highlighted CSF

If an operator is specified, by setting its multiplicity, and indices for creation and annihilation orbitals (space-separated), all possible CSFs coupling to the selected one can be highlighted in red by toggling the "Coupling" checkbox. If the "Allow different spin" checkbox is checked, also CSFs of different spin (and/or number of electrons) will be considered. Note that this does not take into account the order of creation/annihilation operators or their specific spin coupling, the coupling CSFs are an "upper bound" to the possible ones.

highlighted coupling

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iditarod-1.0.0.tar.gz (88.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iditarod-1.0.0-py3-none-any.whl (75.1 kB view details)

Uploaded Python 3

File details

Details for the file iditarod-1.0.0.tar.gz.

File metadata

  • Download URL: iditarod-1.0.0.tar.gz
  • Upload date:
  • Size: 88.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for iditarod-1.0.0.tar.gz
Algorithm Hash digest
SHA256 aebf4c6bf0a0767bbec760481bee86db86f1c2d29b625ca8a30835667b177cd8
MD5 3942f45bd6f543b3a69dc26088f93d10
BLAKE2b-256 20b55bc3ade16b87bf232e51825208261ada92b3fadd9629892c39f0d48420ac

See more details on using hashes here.

File details

Details for the file iditarod-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: iditarod-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 75.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for iditarod-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 11be43b90c1ca47c43504a714e98a7b2a974807ff31bac3a85112c7691f3cedd
MD5 89cff1b44748fae93be65587acc333bf
BLAKE2b-256 e457463db27b8b787a35f10c1fee05b7d9214b0694bd27a43f23a79b714ab90c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page