Leicester Database and Archive Service
Ginga Analysis
    Software Archive
    Download Site
    Download Site
    Download Site
Opacity Project
    Download Site
Chandra Data
    Analysis Software
This is the UK Mirror of the HEASARC PIMMS pages, maintained by LEDAS.
Please refer any problems with these pages to ledas-help@star.le.ac.uk.

Next: The User Interface

PIMMS commands


Command syntax: MODEL <name> <par> <nh>
             or MODEL <filename> [<nh>]
             or MODEL ?
Minimum abbreviation: M
Examples: "MO PL 1.7 3e21" "MO mymodel.dat"

Model specifies the spectral shape to be folded with the effective area curve of the instrument. Starting with version 3.0, up to 8 model components can be added together to represent multi-temperature plasma, power law plus Gaussian emission line, partial-covering absorber etc. Only a limited combinations of models have been rigorously tested; users of complicated models are urged to check the composite model by using the OUTPUT command. See the Using Multi-component Models section for more details.

As components, PIMMS recognizes BLACKBODY, POWERLAW, BREMSSTRAHLUNG, GAUSSIAN and RAYMONDSMITH. If the model name string does not match these, PIMMS will try to interpret the string as a file name containing a precalculated model containing energy, photon flux pairs. NH, the equivalent neutral hydrogen column density (using Morrison and McCammon model) is expected for each component, except for GAUSSIAN and external files. NH should be specified in full with an appropriate exponent (e.g., 2.5e21), or as a small non-zero number less than 30.0, to be intepreted as log10(NH).

Optionally, all components may be redshifted using a common z (in which case, all component NH are interpreted as intrinsic absorber, with the same z) with an optional Galactic NH.


The Model commands takes 1--8 blocks of component specification, and a final optional block of redshift specification. Each block starts with a valid name of a component (including a valid file name), followed by a set of numerical parameters. As a special case, the Raymond-Smith model takes an optional string (logt or kev, the latter being the default) specifying the unit of temperature. For 2nd through 8th component blocks, additional parameter(s) specifying the ratio of that component to component 1, and the reference energy at which this is to be evaluated, must also be given (NB the reference energy for Gaussian is always its central energy). See the Using Multi-component Models section for more details.


MODEL command with a question mark (or no parameters) will return a short listing of available models.

MODEL - Blackbody

Can be abbreviated to "BL.." or "BB". Parameter is temperature in keV.

MODEL - Bremsstrahlung

Can be abbreviated to "BR.." or "TB" (short for Thermal Bremsstrahlung); the model include the Gaunt factor. Parameter is temperature in keV.

MODEL - Power Law

Can be abbreviated to "P.." or "PL". Parameter is photon index (flux in photons/cm/cm/s is E^[-(index)]. Unlike in previous versions, a power-law photon spectrum that increases with increasing energy can be specified by entering a negative number as the index, starting from PIMMS v2.5.

A power law with high energy cutoff E^(-index) exp[(Ecut-E)/Eefold] can be specified by typing "model pl 1.5 13.5 20.0 1e22" for example; this will result in an index of 1.5, cut-off energy of 13.5 and e-folding energy of 20 keV, with an Nh of 1e22.

MODEL - Raymond & Smith

Can be abbreviated to "R.." or "RS". At the moment, PIMMS cannot compute an arbitrary RS model but merely uses one of pre-calculated models. The standard installation has a set of 12 coarse models. An additional tar file can be used to extend the temperature range and grid density (see "Models directory" below). Plasma temperature can be specified either as logt (in which case type, e.g., "model rs logt 6.6 3e19") or as keV ("model rs 2.5 1e20"). Abundances are assumed to be Solar, as defined by Allen.

See also "Models directory" below.

MODEL - Gaussian

Can be abbreviated to "G". This model takes the central energy and physical width (in keV) as parameters, and optionally also NH. A physical width of 0 is allowed, which is interpreted as a delta function (integrations of delta function is treated appropriately, although it may look incorrect in the differential form, which is what is saved by the OUTPUT command).

Gaussian is primarily intended as second (etc.) component in addition to a continuum model, with the same NH as the primary component. In such cases, specify the equivalent width in eV rather than the "relative strength".

MODEL - External Models

Other, perhaps more complex, models can be imported in the form of an Ascii file containing energy (keV) vs. flux (photons/cm/cm/s/keV) pairs. Nh correction is optional (i.e., interstellar absorption can be included when producing the file or done within PIMMS). If the full directory/file name is not specified, user's current default directory is assumed first, and if not the models directory is searched.

MODEL - Models directory

Some external models (see help item under that name) may be kept under the models subdirectory. If the file names and a short description is also included in the model.idx file, then PIMMS users will be able to see what is available. Currently, a series of 0.25 Solar abundance Raymond-Smith models are available from models directory by default.

A set of 295 additional Raymond-Smith model files (8000 lines each) are available in a separate tar file (extra_v3.tar.Z). These files are called rsxx_yyy.mdl, where abundances are x.x solar (02, 04, 06, 08 or 10) and log T is y.yy (5.60 - 8.50 in 0.05 increment).

MODEL - Importing from XSPEC

To import a model from XSPEC, start XSPEC and read, e.g., a template ASCA SIS pha file (which specifies the SIS response matrix which specifies the PHA channel boundaries etc.). Create your model. Then use IPLOT MODEL command to plot the model, then from within plot use the WD <filename> command to output the model into an Ascii file. The program XSING within the models directory should be used to convert the XSPEC output into a form readable by PIMMS.


Command syntax: FROM <mission> [<det> [<filt>]] [<lo>-<hi>]
             or FROM FLUX <unit> <lo>-hi> [UNABSORBED]
             or FROM NORMALIZATION
Minimum abbreviation: F

This command specifies the default "instrument" that the conversion is to take place from. This default will be used in GO command if not explicitly specified. See Missions for details of the available instruments, or try DIRECTORY. Initially the default is 2.0-10.0 flux in ergs/cm/cm/s.


Command syntax: INSTRUMENT <mission> [<det> [<filt>]] [<lo>-<hi>]
             or INSTRUMENT FLUX <unit> <lo>-<hi> [UNABSORBED]
Minimum abbreviation: I

This command specifies the "instrument" that the conversion is to take place to. See Missions for details of the available instruments, or try DIRECTORY. Initially default is ASCA SIS.


Command syntax: GO <input_rate> [<mission> [<det> [<filt>]]] [<lo>-<hi>]
             or GO <input_rate> [FLUX <unit> <lo>-<hi> [UNABSORBED]]
Minimum abbreviation: G
Examples: "G 1.0" "GO 3.4 EINSTEIN IPC"

This command actually tells PIMMS to execute the simulation.

Given a source spectrum in the form specified with MODEL, which produces an input rate (count rate in the specified instruments or flux) of <input_rate> it GO predicts what the rate would be for the instrument specified with the INSTRUMENT command. Unit of input rate can be specified here, or else the default is used (see FROM).


Command syntax: OUTPUT <filename> <loE> <hiE> <deltaE>'
Example: "OUT compoite 0.1 10.0 0.005"

This command produces an Ascii file containing the current spectral model, and is intended primarily as a debugging tool for complicated multi-component models. Each row consists of energy, total model flux, and flux of each component if there are more than one. The energy grid should be specified using the minimum and maximum values and the increment.

PIMMS currently forces output file names to be all lowercase.


Command syntax: SHOW
Minimum abbreviation: SH

Presents a summary of the current defaults on the screen.


Command syntax: DIRECTORY [<mission> [<detector>]]
Minimum abbreviation: D
Examples: "DIR" "DIRE EXOSAT"

This command prints, on your screen, the full listing of missions that PIMMS recognizes. For explanations and comments, see Missions.


Command syntax: LOG <log-file-name> or LOG close
Minimum abbreviation: L
Example: "LOG crab"

When this command is issued, PIMMS opens a log file (default extension .log). Thereafter, screen outputs from PIMMS (except for questions/prompts) will be copied to the log file. LOG CLOSE will close the current log file; the purpose of this command would be to send further output to a separate log file. This command will indicate error if (1) a log file is already open; (2) (on UNIX systems) the specified file already exists; (3) (on VMS systems) when the specified "log file name" is also a DCL Logical; and (4) PIMMS failed to open the file for the usual reasons, including a lack of disk space and file system protection.

PIMMS currently forces output file names to be all lowercase.