Child pages
  • Catalogs and MAF

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


In these instructions we assume you are installing in ~/lsst, however the install directory can be any place in the file system, including a place visible to all users.  To install in another location, replace ~/lsst with the desired path in the following instructions.  For multi user stacks, permissions are typically restricted to read only for the main stack so packages are not accidentally installed in the main stack.

For the basic install of lsst_appsinstallation of the basic LSST packages, please follow the directions here:  and then from there, install lsst_sims following the directions below. but only up to the point "Installing Packages" – you do not need to do "eups distrib install lsst_distrib" as we will install the required simulations packages below.  

Note that the pages go on to describe LSST Data Management packages (lsst_apps and lsst_distrib) that include additional software not necessary for simulations (although it may be very useful for you!). This includes the LSST data management demo package. You may find it interesting for image processing and catalog purposes, but it is not directly related to installation and use of the simulations packages.

 2. Set up the environment and install the simulations code and data.


This will install all packages currently in the catalogs simulations framework (CatSim) and metrics analysis framework (MAF) and all dependencies.  The installation should take on the order of 2 hours, with a final required installation size of 10GB. 


You have now downloaded and built all of the packages in lsst_sims, with the command "eups distrib install <packagename> -t <tag>".  These packages are designed to be totally self-contained.  They have been built in the directories


where yourOperatingSystem is 'DarwinX86' for Mac users and 'Linux64' for Linux users.  In order to use the packages you installed, you must add 'activate' them in your environment, which is essentially adding these directories to your $PYTHONPATH.  This is done using

Code Block
setup your_package_name -t your_package_tag

"setup <packagename> -t <tag>" is an eups command that activates the packages and their dependencies.  your_package_name is the name of one of the packages you have installed (e.g. sims_maf or sims_catUtils).  your_package_tag is a tag eups uses to keep track of the versions of each package you have built on your machine.  This corresponds to the argument of '-t' in the 'eups distrib install' command above.  So, if you wanted to setup the version of MAF you just downloaded, you would use