pyGSTi 0.9

This is the root directory of the pyGSTi software, which is a Python implementation of Gate Set Tomography. pyGSTi free software, licensed under the GNU public license (GPL). Copyright and license information can be found in license.txt, and the GPL itself in COPYING.

pyGSTi is written entirely in Python, and so there's no compiling necessary. The first step is to install Python (and iPython notebook is highly recommended) if you haven't already. In order to use pyGSTi you need to tell your Python distribution where pyGSTi lives, which can be done in one of two ways:

1. run: python install_locally.py

This adds the current pyGSTi path to Python's list of search paths, and doesn't required administrative access (but only applies to the current user).

2. run: python setup.py install

This installs the pyGSTi Python package into one of the Python distribution's search directories. This typically requires administrative privileges, and is the way most Python packages are installed. Installing this way has the advantage that it makes the package available to all users and then allows you to move or delete the directory you're installing from.

The reason why you may not want to use this installation method is that pyGSTi comes with (iPython notebook) tutorials that you may want to access. And if you're keeping the tutorial files somewhere in your local user directories, you may want to just place the entire pyGSTi directory there use method 1) above.

After you've installed pyGSTi, you should be able to import the pygsti Python package. The next thing to do is take a look at the tutorials, which you do by:

• Changing to the notebook directory, by running: cd ipython_notebooks

• Start up the iPython notebook server by running: ipython notebook

The iPython server should open up your web browser to the server root, from where you can navigate to the Tutorials folder and start the first "00" tutorial notebook. Note that the key command to execute a cell within the iPython notebook is Shift+Enter, not just Enter.

Congratulations! You're up and running with pyGSTi!

For help and support with pyGSTi, please contact the authors at pygsti@sandia.gov.

doc/  :  Directory containing the HTML documentation and other
         reference documents.

ipython_notebooks/  : Parent directory of all iPython notebook tutorial
		      files included with pyGSTi.  It is convenient to
		      start an iPython notebook server from within this
		      directory.

packages/  :  Directory containing the (one) package provided by pyGSTi.
	             All of the Python source code lies here.

tests/  :  Directory containing pyGSTi unit tests.

install_locally.py :  A Python script that sets up the software to run 
		      from its current location within the file system.  This
		      essentially adds the packages directory to the list of
		      directories Python uses to search for packages in, so
		      that ``import pygsti`` will work for any Python script,
		      regardless of its location in the file system.  This
		      action is local to the user running the script, and does
                  not copy any files to any system directories, making it
		      a good option for a user without administrative access.

COPYING  :  A text version of the GNU Public License.

license.txt  :  A text file giving copyright and licensing information
	        about pyGSTi.