Clone wiki

phosim_release / Using PhoSim

(Back to Home)

using_phosim.png

Installation

The code can be obtained through the PhoSim git repository using an appropriate tagged version. It is easiest to simply download a tarball of the latest version. First, unzip and untar the code in the desired installation directory.

Then to configure the code and installing the two dependencies (cfitsio and fftw) by:

./configure

Then, to build the code simply do:

make

To test with a simulation of a single star and no background:

./phosim examples/star -c examples/nobackground

To activate the graphical user interface (GUI) simply do:

phosim_gui

Usage

The default usage is:

phosim instanceCatalog

The instanceCatalog specifies the configuration of the observation and the astrophysical inputs.

For more complex usage:

phosim instanceCatalog -c physicsCommands -i instrumentSiteDirectory<lsst>

The physicsCommands modify the default (realistic) physics.

The instrumentSiteDirectory points to the instrument and site characteristics files.

This library of SEDs can be used with the simulator.

The output is a stream of FITS files.

For larger simulations, there are two options for parallelization. One that parallelizes at the chip level will run N copies of the raytrace portion of the calculation.

phosim instanceCatalog -p N

This is only useful when simulating a catalog covering more than one chip. Another multi-threads the calculation in the raytrace on a per astronomical source basis:

phosim instanceCatalog -t M

These options could even be used together in a complementary manner. To see a speed up, you should have N*M cores available.

For a quick tutorial to get started, please follow the PhoSim Walkthrough.

If you don't want to run PhoSim, you can also download some sample images.

This code is also developed for use on large-scale grid computing using CONDOR with the -g condor option. Use phosim -h for a full listing of options.

Detailed Information

Current Release Notes and Limitations

Future Release Notes

Updated