ADM logo

AtomicDensityMatrix

mathematica package

about : installation : documentation : release notes : feedback
About:

AtomicDensityMatrix is a package for Mathematica version 6 and later that facilitates analytic and numerical density-matrix calculations in atomic and related systems. It is intended to be both general and user-friendly, and to be useful to the working physicist as well as to students.

AtomicDensityMatrix is open source software, licensed under the GPLv3.

The package has been updated for compatibility with Mathematica 12. Please send bug reports to simon@rochesterscientific.com.

Features:
Installation:

First download ADM_yy.mm.dd.zip.

Installing a Mathematica package consists entirely of placing the package files in a location where Mathematica can find them. You can do this using one of the following two methods:

  1. Using the File > Install menu item (Mathematica version 8 and up):
    • Start Mathematica.
    • Select the menu item File > Install.
    • In the dialog box, for "Type of Item to Install" choose "Application" (not "Package").
    • For "Source" choose "From File..."
    • When the file selector appears, choose the zip file that you have downloaded, and select "Open".
    • Leave the "Install Name" as it's given, and click "OK".
    • Mathematica will extract the contents of the zip file, and copy them to the correct install location.
  2. Manually (all versions):
    • Locate your Mathematica base directory (for installation for all users) or user base directory (for installation for the current user only). You can find these directories by evaluating $BaseDirectory or $UserBaseDirectory in Mathematica. In Mathematica 7 or later, you can open the directory in a file browser by evaluating
      SystemOpen[$BaseDirectory]
      or
      SystemOpen[$UserBaseDirectory]
      (Note that in Windows or Mac OS X, these directories may be hidden in the file system by default.)
    • Unzip the contents of the downloaded zip archive into the "Applications" subdirectory of the base directory.
    • The package files should now be in the directory
      [BaseDirectory]/Applications/AtomicDensityMatrix
      where [BaseDirectory] is the directory you chose in the previous step.

To load and test the package in Mathematica, evaluate

<<AtomicDensityMatrix`

and then

$ADMVersion

to see the package version number,

AMPSPlot[DiagonalMatrix[{1, 0, 1}]]

to see a simple angular-momentum-probability surface, and

LevelDiagram[ZeemanSystem[1]]

to plot the level diagram for a J=1 atomic system. There are many other examples in the documentation.

Documentation:

The package documentation is growing, but far from complete. It is available in the Mathematica Documentation Center when the package is installed.

You may now have to restart Mathematica to see the AtomicDensityMatrix documentation appear in the Documentation Center.

To view the documentation, select Help > Documentation Center, and click "Add-Ons and Packages" at the bottom of the page (for version 6, "Installed Add-Ons" on the bottom right). You will reach a page of links to the documentation for installed packages. Alternatively, you can just enter "adm" in the Documentation Center search bar—one of the first few results should be for the ADM package guide page. (This shortcut appears to be broken in Mathematica 10.1, but it's working again in Mathematica 10.2.)

The documentation is also available online in html format.

Release notes:
Feedback:
Please send questions, suggestions, and bug reports to Simon Rochester at simon@rochesterscientific.com.