Skip to content
ttrainor edited this page Jan 6, 2012 · 30 revisions

Tdl Installation

Notes

Tdl includes a number of application modules, binary libraries and utilities. Tdl can be installed as a python package and used from the python shell, from within other python packages or scripts, or as a standalone program (using the pds interpreter).

If you want to download a standalone version of tdl/pds built for windows check here. You can browse the source code here

Dependencies and packages

If you do not have these packages installed locally follow the provided links to install them. Usually most recent is best with some noted exceptions.

The following are required for tdl

To use the reflectivity module

  • Currently you will need to have Ifeffit installed and have the Ifeffit python library installed in your PYTHONPATH You'll might also need the Ifeffit environment variables defined. See XX for more info.

If you want to run the graphical user interface of pds you'll need


The following are optional, but you might find useful


  • After installing python and associated packages, make sure the following are on your systems 'PATH'
    • Python's installation directory so that '>>python' works from your command line
    • If you are using the reflectivity module:
      • Ifeffit's installation directory
      • TDL_DIR/modules/core/libs

== Install the svn client ==

  • The tdl code is maintained in an svn data base. To get the source code you'll want to install SVN on your computer. See http://subversion.tigris.org/ or http://subversion.apache.org/packages.html
    • For windows try the !Win32Svn installer
  • When the client is installed, make sure the svn executable is on your path. Test by running ">>svn -h" from your command line.

== Check out the svn repository ==

  • Once you have svn installed you can create a local copy of the latest tdl code by running the following in a command shell. Note:
    • 'XX\code_svn' is the root directory to install the repository
    • 'XX\code_svn\tdl' is the repository, make sure you create this path before running the svn commands.

{{{

cd C:\XX\code_svn svn checkout http://cars9.uchicago.edu/svn/tdl/trunk tdl }}}

  • If you have already downloaded tdl and want to get any available updates, run the following in a command shell ( this will warn (without overwriting) about conflicting files)

{{{

cd C:\XX\code_svn\tdl svn update }}}

  • You can commit your changes to the svn data base with: {{{

cd C:\XX\code_svn\tdl svn commit -m "comment here"

Note the first time you commit you'll need to enter a username. You will then be prompted for a passphrase before the commit occurs:

cd C:\XX\code_svn\tdl svn commit -m "comment here" --username XX }}}

  • See ">>svn -h" for a list of additional options (e.g. adding and (re)moving files and directories) and the complete svn doc at http://subversion.tigris.org/

== Working with the development version ==

  • Make sure your system path includes:

    • python
    • Ifeffit install dir (for reflectivity)
    • tdl/modules/wrap/libs
  • To run the tdl code in the svn repository directory. {{{

cd C:\XX\code_svn\tdl python rpds }}}


== Installing tdl under .../python.../site-packages ==

  • You can also install tdl into the standard python 3rd party modules library => python/libs/site-packages

{{{

cd C:\XX\code_svn\tdl python setup.py install }}}

  • A directory is created ...python/lib/site-packages/tdl with all the code...

  • to startup pds do:

{{{

python from tdl import pds pds.main()

}}}


Clone this wiki locally