The MAPPINGS V Code Archive

https://mappings.anu.edu.au/code

https://bitbucket.org/RalphSutherland/mappings

Science and Programming:

Current MAPPINGS Version V 5.1.18

v5.1.18, September 2019

Download mappings_V-5118.zip (297.8MB) : Everything including stellar/agn atmospheres.
SHA256 digest: 9242848db55898f6bb9359f5a739b9b52326750db5397dafc0852cf3cb6f5d22

Download M_V-5118.zip (28.7MB) : Everything except stellar/agn atmospheres.
SHA256 digest: be429425e54baf0f23210b09a716ffd56583e6fa149259fa01931179e61a75a1

Optional Stellar/AGN Atmosphere Library

Download MV_atmos.zip Stellar atmospheres (192.8MB). Compatible with 5.0.12 or newer including all v5.x.x. (Unzip to create the atmos directory and move the atmos directory into the lab area.)

f2c FORTRAN to ANSI C converter

Updated to work better with new systems with no prior f2c installation:
Download f2c.zip (1MB)

Miscellaneous Observational Tools

Go to the lines page : a standalone spectral line measuring tool.

Download dered-106.zip (370kB) : a standalone de-reddening/reddening tool, included in the main zip files in misc/ as well.

Download blur25.zip (561kB) : a standalone spectral convolution tool, included in the main zip files in misc/ as well.

Previous Versions, MIV

MIV code wil continue to be accessible on the miocene server at the MIV Archive

ReadMe: MAPPINGS V

MAPPINGS V v5.1.x

https://mappings.anu.edu.au/code

Contact:

Ralph.Sutherland@anu.edu.au

Quick Start Compiling and Running:

    > cd mappings/src
    > make build`

[wait a while…]

> cd ../lab
> ./map51

Installing so map51 can run anywhere:

> cd mappings/src
> make build
> sudo make install

This copies map51 into /usr/local/bin so it can be run from any location by all users of the computer. It also creates copies of the essential lab directories; data, atmos, and abund, into /usr/local/share.

When running map51, you can run locally in lab/ (note ./map51)

> cd ../lab
> ./map51

and it will find the local map.prefs, data, abund etc old scripts will work as before.

With the /local installed option you can use any directory

(note plain map51) ie:

> cd
> mkdir test
> cd test
> map51

If mappings finds a local data file it will use those, otherwise it will fallback to use the shared copy, so you can still maintain a custom set of data and abundances etc or use the standard shared set.

Uninstalling:

To remove the shared installation simply

> sudo make uninstall

. To remove the local copy simply delete the mappings/ directory

The Mappings directory structure:

mappings/

lab/
    data/
    abund/
src/
    mastercode/
    includes/
    workcode/

Optional:

    lab/atmos/
    lab/scripts/

Shared: (optional with sudo make install)

    /usr/local/bin/
    /usr/local/share/mappings/
        data/
        abund/
        atmos/

Key Directories and Files:

• lab/ This is where the executable is made and run. The runtime files such as map.prefs are here and the essential data directory with the runtime data files.
• map51: The executable.

• map.prefs Essential startup data - must be present.

• mapStd.prefs A standard 16 atom startup in case map.prefs is lost for any reason, can be copied and renamed map.prefs if needed

• mapFull.prefs A full 30 atom startup in case map.prefs is lost for any reason, can be copied and renamed map.prefs if needed

• data/: Contains the atomic data for MAPPINGS V. Read at runtime in mapinit.f. Essential and must be present and complete.

• abund/: A set of useful abundance settings that can be read interactively during a run. Optional.

• atmos/: A set of useful radiation source files and stellar atmosphere models. Optional.

• scripts/: A collection of (mostly) useful of UNIX shell and MAPPINGS scripts

• src/ Contains the code area and the Makefile(s). There are three makefiles, one for a setup with fortran installed, Makefile.for, and one to use if you are running f2c and a C compiler, Makefile.f2c. If using f2c, rename the Makefile.f2c to simply Makefile and use that. If using FORTRAN, rename Makefile.for to Makefile. All the useful parameters are near the top of the makefile.

• Makefile. This makefile controls all the building of MAPPINGS. It takes one argument to control the operation:

         MAPPINGS V v5.1.x make options:
         'make help'    to see this menu
         'make build'   to create executable from scratch and clean
         'sudo make install'   to install the built executable into /usr/local
         'make prepare' to copy over '\*.f' and '\*.inc' files
         'make compile' to create executable
         'make backup'  to backup '\*.f' and '\*.inc' files
         'make clean'   to backup '\*.f' and '\*.inc', remove '*.o'
         'make listing' to create listing of code
  

• mastercode/ Contains a master copy of the code - only accessed by the Makefile.

• workcode/ The Makefile copies the .f files here. These can be edited etc by the user. The Makefile compiles these files to make the executable.

• f2c.zip: A zip archive of f2c, requires only a C compiler to make, gcc by default. MAPPINGS can be built from scratch by building f2c, installing it in /usr/local and then use the f2c Makefile to build MAPPINGS.

MAPPINGS V 5.1 Change List

• 5.1.13 : CHAINTI 8.0.6 atomic data update. S I demoted to 5 level atom. C II wavelengths change.
• 5.1.12 : Option to monitor the emmisivity of up to 16 lines selected by wavelength radially through a P6/P7 model. General file version bump.
• 5.1.11 : A critical density test routine added, and 'C' temperature ending bug fix for S5 shock models.
• 5.1.10 : Imortant update for FeII - FeVI recombination rates to match CHIANTI 8 better with special NORAD rates override
• 5.1.09 : Evolution of S5 model for shock paper, fix for neq cooling routing to account for S5 changes.
• 5.1.08 : minor fix for thermal spectral component in the source menu.
• 5.1.07 : Important Update: long standing bug in flow equations affecting shocks with magnetic fields fixes. Energy and momentum now strictly conserved with new cubic solution. Old quartic method retired. All shock modelling should use the new version.
• 5.1.07 : Improvements to MM atomic data output. Minor bug fixes.
• 5.1.06 : Internal development
• 5.1.05 : Major Update, CHIANTI 7.0 -> CHIANTI 8.0.3 atomic data with all new temperature splined collisional data for multi-level atoms and expanded resonance line cascades. Up to 80,000 lines possible.
• 5.1.05 : significant new shock modelling code, S5, includes automatic iterated time-dependent precursors. Still in development.
• 5.1.01-05 : private internal development code versions.

MAPPINGS V 5.0 Change List

• 5.0.16 : Minor changes for better compiler compatibility, and a few unused variables removed.
• 5.0.15 : IAU2015 Nominal Solar Values and IAU2012 A.U. update
• 5.0.15 : CODATA 2014 fundamental constants update, small changes, very few lines shift enough to change scripts.
• 5.0.14 : Improvements to S5
• 5.0.14 : Fixed optical depth limit endings in P4 - P7
• 5.0.14 : Improvements to S5
• 5.0.13 : Cosmetic changes to output to improve scripting.
• 5.0.13 : Added abundance table to top of spec.csv files
• 5.0.12 : hydrogen emissivity tables now interpolate more accurately with cubic splines, improved behaviour at low Te.
• 5.0.12 : He I two photon continuum now operates to lower temperatures, not limited by collisional component.
• 5.0.12 : heavy element hydrogen series are now case A until a better case estimator can be found for these elements, no effect on H or He.
• 5.0.12 Minor update: Makefile defaults to gfortran 4.9, works with gfortran 5.x, f2c version will continue to be supported indefinitely.
• 5.0.12 Minor update: in-code epsilon reduced to 1e-200 to improve low temperature F-B continuum, more cosmetic than serious.
• 5.0.12 Minor update: output number limited to 1e-99 in most places, to reduce the occurrence of badly formed floating point numbers at 1.0e-100 or lower becoming 1.0-100 with some fortrans. Cosmetic.
• 5.0.11 IMPORTANT : The multi-component radiation source menu has been changed to allow for more libraries without using up all possible letters. Sources are grouped by type to clarify the sources. Any script that specifies a radiation source will need revision and possible changes.
• 5.0.11 IMPORTANT : New TNMAP CSPN planetary nebula stellar library by Rauch for the H-Ni grid and older H-Ca grid have been added
• 5.0.11 IMPORTANT : The AGN atmosphere library has been rescaled to 1.0e4 R_g for M = 1.0E9; source radius = 1.5e18cm, and is different to the 1.0e16cm source radius used before. Scripts based on luminosity will be unchanged, scripts based on source radius will need changes. A new atmos library has the new compSED2 library. The file headers now include all the OPTXAGNF parameters needed to recreate the file if necessary.
• 5.0.11 bugfix : Fixed photsou 'K' option when reading certain types of external flux files.
• 5.0.11 T1C experimental library was very large, and with the new CSPN models included, T1C is now no longer part of the standard distribution. Contact RSS if needed, but they are being recomputed anyway. atmos library is a little smaller as the added CSPN grids were smaller than the removed T1C library.
• 5.0.10 Minor Update: src/f2c.zip is updated to work better with completely new systems with no prior f2c installation.
• 5.0.10 IMPORTANT : Fixes resonance line initialisation bug.
• 5.0.10: Refraction corrected continuum in .lam flambda output.
• 5.0.10: lambda - flambda .lam files now use bin *centre* wavelengths, plot with the histogram option in Graf instead of step-X.
• 5.0.10: All lines and continua are now as vac wavelengths internally, only converted to air wavelengths in output to spectrum files and .lam files. All Energy (.sou) and Frequency (.nfn) output are always in vacuum values, naturally.
• 5.0.10: Changes to the new internal vac standard meant that the optical/near UV/near IR H I and He II wavelengths tables were re-evaluated (all other lines are energy level derived or in vac. already and unchanged as before). The wavelengths of hydrogen lines remain the same, apart from one or two with last decimal place changes. He II spectral wavelengths were re-computed for intensity weighted energy differences and are now in closer agreement with low resolution ( R < 30,000 ) observed wavelengths, but are generally different to v5.0.9 at the 0.01-0.1Å level. Awk scripts that search for He II 4686 etc will need to be updated.
• 5.0.10: Added new set of element depletion files, thanks Mike.
• 5.0.10: Tidied P6 and P7 screen output a little.
• 5.0.9: OIII demoted to more smaller but more accurate 5 level ion in MULTIDAT using SSB 2014 coll str.
• 5.0.9: Resonance line collisional cascades expanded to include OIII 1660/66Å to make up for OIII change. Now up to 9134 optical, UV and X-ray lines for 220 ions.
• 5.0.9: Update 1/4: switches.txt was accidentally left in the data/ directory in the lab/, it is not intended for general use so it has been removed from the default setup in the archives. Contact RSS if you want to use it at all.
• 5.0.9: Fixed HI and HeII electron collision data, default is Anderson et al 2000/2002 and Ballance 2003. This changes the n=4 and n=5 rates considerably, so the ratio of two-photon to H-Beta in partially ionised shock changes, quite considerably in some cases. The two-photon rates are relatively unchanged, so the absolute two-photon emission is unchanged, but the ratio to H-Beta does vary.
• 5.0.9: Extended HeII recombination spectrum to 16 lines per series like hydrogen. Heavy element H series are still 2 series of 10 lines.
• 5.0.9: Added lambda (Å) - Flambda (ergs/cm2/s/Å) file output. Lines will be std Air, but the continuum is not transformed, so edges may differ by approx. 1Å depending on the spectral region.
• 5.0.9: Fixes for all Fe line output in the detailed spectrum.
• 5.0.9: Fixes HI and HeII Two Photon emission output in the detailed spectrum.
• 5.0.9: P6 and P7 create phsemXXX.ph[67] files, the basic nebula structure and emmissivity of strong lines as nebula summary file.
• 5.0.9: Added P7 and S5 for experimental work on new photo and shock models
• 5.0.9: S4, Now deprecated, pending S5 coming online. Will be reverted to a fixed state, but currently has some modifications in preparation for S5. Contact RSS if you are going to use S4
• 5.0.9: New precise (double precision accurate) exponential integral functions based on NIST DLMF reference to Cody and Thatcher 1968/69. Old A&S rational power series are retained as a speed option, but new Cody code is not much slower and is much more precise. All the functions that use E1 or exp*E1 are channelled through the same precision routines and are all more stable and accurate, including farint and fue1.
• 5.0.9: S5 begun, will eventually include automatic preionisation, includes all the new S4 fixes. S4 is fixed now and will retain its calling sequence, S5 may evolve and require script changes, but currently has the same API as S4.
• 5.0.9: Fixed switches.txt to include the option '3' for no charge exchange at all, 0 = MIV/MV, 1 = MIII, 2= MI/II, 3 = none, default = 0
• 5.0.8, BUGFIX: New Anderson H collisional excitation rates rolled back to GNP1989 H collisional excitation rates until Anderson rate code is fixed. Two photon collisional excitation rates exhibited too low collision rates.
• 5.0.8, BUGFIX: Two photon collisional de-excitation to 2P level fraction corrected
• 5.0.7, BUGFIX: Long standing isobaric mode bug. 5.0.7 now correctly computes inner radius, pressure and ionisation parameter for all isobaric nebula models.
• 5.0.6, Minor Adjustments to Std Air refraction, now applied 2000 Å - 4 µm, vacuum wavelengths outside this range.
• 5.0.6, Minor Adjustments to OII and NII fine structure level energies.
• MAJOR update, v5.0
• All new resonance line collisional cascades - replacing nearly all of old resonance line lists. Up to 8343 optical, UV and X-ray lines for 220 ions
• New total cooling rate compatible with more detailed CHIANTI 7.1 cooling
• All new resonance line spectrum output, each line has detailed transition information
• Fixed heavy element hydrogenic recombination spectra
• 5.0.6, Anderson et al 2000 Hydrogen/Helium Collisional Excitation, 25 FS levels up to n=5
• Fe II - Fe VII as full multi-level model ions, 1773 Lines
• Fe IV 37 level multi-level model added
• Fe V 34 level multi-level model added
• Fe VI 19 level multi-level model added
• Output can handle up to 10,000+ lines
• All multi-level collision data re-splined. Some ions moved to resonance line cascades (CIV, NV, OVI), some new multi-level ions (Si II, FeXIV). Optional data file to use CHIANTI only data. 52 ions 385 Lines
• Zero-field option in fast shocks now much more efficient
• Output to spec.csv files includes more information in kind column
• All new radiation field construction to handle new line lists
• Fixed bugs in reading large atmosphere input files