==================================================================
PINTofALE INSTALLATION INSTRUCTIONS 20nov2013
The minimum requirements to use PINTofALE are:
o Disk space of approx 500 MB (IDL procedures, SPEX and CHIANTI
constant-density line emissivity databases, CIE continuum
emissivity database)
o IDL version 5 or greater
o IDLASTRO library routines
Having CHIANTI(v7+) is also useful, especially because PINTofALE
primarily uses the ion balance files compiled by CHIANTI.
To install PINTofALE:
0. If all you need are the IDL procedures, download and unpack
http://hea-www.harvard.edu/PINTofALE/PoA_pro_current.tar.gz
and add the location to IDL's !PATH. That's it.
To get the emissivities and set it up to use for atomic data
analysis, see below.
1. Obtain the tar files containing the necessary IDL routines,
the continuum emissivity database, and sundry documentation,
from http://hea-www.harvard.edu/PINTofALE/
Either:
1.0 All the components at once:
http://hea-www.harvard.edu/PINTofALE/PoA_current.tar.gz
OR each component separately:
1.1 Routines:
http://hea-www.harvard.edu/PINTofALE/PoA_pro_current.tar.gz
1.2 Continuum Emissivities:
http://hea-www.harvard.edu/PINTofALE/PoA_CIE_current.tar.gz
1.3 SPEX Emissivities:
http://hea-www.harvard.edu/PINTofALE/PoA_spex_current.tar.gz
1.4 Documentation:
http://hea-www.harvard.edu/PINTofALE/PoA_doc_current.tar.gz
In addition, you may also download a set of line emissivities
derived from the
a] CHIANTI dataset
http://hea-www.harvard.edu/PINTofALE/PoA_chianti_current.tar.gz
b] ATOMDB dataset
http://hea-www.harvard.edu/PINTofALE/PoA_atomdb_current.tar.gz
(these are not included in the full distribution in [1.0] above)
Note that emissivities consist of binary files that were written
on a Sun. If these files are not read in properly on your
architecture, please contact us.
Also note that any errors in the resulting emissivities are
our responsibility, and not that of the CHIANTI, SPEX, and
APEC software teams.
2. Unpack the downloaded tar files. Assuming that PINTofALE
will be installed in the directory /foo/bar/, type
cd /foo/bar/
gunzip -c PoA_current.tar.gz | tar xvf -
or
gunzip -c PoA_pro_current.tar.gz | tar xvf -
gunzip -c PoA_CIE_current.tar.gz | tar xvf -
gunzip -c PoA_spex_current.tar.gz | tar xvf -
gunzip -c PoA_doc_current.tar.gz | tar xvf -
2a. If earlier installations exist, then please delete the following
files, if they exist:
if ( -f PINTofALE/pro/marfrmf.pro ) /bin/rm PINTofALE/pro/marfrmf.pro
if ( -f PINTofALE/pro/util/setcolor.pro ) /bin/rm PINTofALE/pro/util/setcolor.pro
if ( -f PINTofALE/pro/util/which.pro ) /bin/rm PINTofALE/pro/util/which.pro
3. Edit the file
/foo/bar/PINTofALE/ardb/initale.par
and set the hardcoded values of !LDBDIR, !CDBDIR, and !CHIDIR
to reflect the local environment. If the names do not begin
with a "/" or a "$", then !TOPDIR is automatically prepended
by the initialization script to complete the path.
NOTES:
1. !CHIDIR must point to the directory containing the CHIANTI
dataset downloaded as described in step 6 below.
(e.g., !CHIDIR='/foo/bar/CHIANTI/dbase/')
WARNING: Prior to v4, the CHIANTI distribution did not
include the "dbase" subdirectory. The current version
of PINTofALE assumes and requires the existence of this
subdirectory.
2. !LDBDIR must point to the line emissivities that have been
recast in the PINTofALE compatible format, either the SPEX
emissivities of
http://hea-www.harvard.edu/PINTofALE/PoA_spex_current.tar.gz
(e.g., !LDBDIR = 'emissivity/spex')
or the CHIANTI emissivities obtained as described in
http://hea-www.harvard.edu/PINTofALE/doc/LDB_CHIANTI.howto
(e.g., !LDBDIR = 'emissivity/chianti')
or the APED emissivities obtained as described in
http://hea-www.harvard.edu/PINTofALE/doc/LDB_ATOMDB.howto
(e.g., !LDBDIR = 'emissivity/aped')
3. !CDBDIR must point to the continuum emissivities in the
PINTofALE format
http://hea-www.harvard.edu/PINTofALE/PoA_CIE_current.tar.gz
(e.g., !CDBDIR = 'emissivity/cont')
4. !TOPDIR is set automatically when the initale script is run.
The environment variables $PINTofALE, $PoA, $SCARDIR, and
$SCAR are looked to first in that order, and if none of them
are defined, then the path is determined by looking at the
location of the initialization script. The default value is
!TOPDIR = '/foo/bar/PINTofALE'
4. The following is strictly speaking not necessary (see point 4a
below), but is detailed here for convenience.
It is advantageous to have IDL's system variable !PATH to contain
the path to the PINTofALE installation. This may be done in any
number of ways depending on your local setup. One possible method
is to include the following (or equivalent) in your $HOME/.cshrc
setenv PINTofALE /foo/bar/PINTofALE
if ( $?IDL_PATH ) setenv IDL_PATH +$PINTofALE/pro\:${IDL_PATH}
if (! $?IDL_PATH ) setenv IDL_PATH +$PINTofALE/pro
At this point, PINTofALE is installed and available within IDL.
4a. Even if IDL_PATH is not set and PINTofALE is not available
within IDL a priori, it may be fully initialized by running
the script initale.pro -- this script figures out where it is
located and automatically adds PINTofALE to IDL's !PATH variable.
For such a ``cold start'' initialization, type:
IDL> .run /foo/bar/PINTofALE/pro/scrypt/initale
5. PINTofALE relies on many calls to the IDLASTRO and ROSATLIB
library of IDL routines. If they are not installed, then
obtain them from
http://idlastro.gsfc.nasa.gov/homepage.html (IDLASTRO)
ftp://legacy.gsfc.nasa.gov/rosat/software/idl/ (ROSATLIB)
and install them as directed.
6. It is highly recommended that CHIANTI (v7) be installed.
Download it from
http://www.chiantidatabase.org/
By default, PINTofALE uses ion-balance data from CHIANTI. If CHIANTI
is not installed, users will have to obtain files formatted in a
similar manner from elsewhere.
PLEASE NOTE: Any errors in PINTofALE computations carried out using
the CHIANTI database are our responsibility and not that of the
CHIANTI software team.
7. Build the CHIANTI line database as described in
/foo/bar/PINTofALE/doc/LDB_CHIANTI.howto
This version of PINTofALE is designed for use with v6 of CHIANTI.
We have not supplied a tar file containing the CHIANTI emissivity
database with the general release because it takes up 1 GB
uncompressed, and will make the downloads slow and unwieldy (even
a gunzipped file will require a correspondingly large available
disk space), and because users have the choice of making a smaller
database if they wish by following the instructions in the above file.
However, for convenience, we have also provided a tar file containing
the CHIANTI line emissivities computed at various densities and
compressed to include only locally strong lines, in
http://hea-www.harvard.edu/PINTofALE/PoA_chianti_current.tar.gz
8. Build the ATOMDB line database as described in
/foo/bar/PINTofALE/doc/LDB_ATOMDB.howto
This version of PINTofALE is designed for use with v1.* of ATOMDB,
which is based on APED.
8. Test the installation by following the example threads
http://hea-www.harvard.edu/PINTofALE/doc/EXAMPLE_JJD.html
or http://hea-www.harvard.edu/PINTofALE/doc/EXAMPLE_VLK.html
or by running the example program(s) in the directory
/foo/bar/PINTofALE/pro/esempio/.
__________________________________________________________________