Installing neat

The latest stable release of neat is version 2.2. Depending on your operating system, you may wish to install neat from a package manager, or compile it yourself.

Installing from package managers

If you are using Linux Debian version 9 (Stretch) or later, Ubuntu 18.04 (Bionic) or later, or Linux Mint 19 (Tara) or later, you can install neat by clicking here to install using APT, or in a terminal window by typing

sudo apt install neat

neat is also available for older versions of Ubuntu and Mint if you first enable my Personal Package Archive. Do that with the following two commands, followed by the install command given above.

sudo add-apt-repository ppa:nebulousresearch/ppa
sudo apt update

Compiling from source

If you can't install neat using a package manager, then you will need to get the source code and compile it. You can get it in .tar.gz format or zip format.

Changes from previous versions are listed here, and can also be seen on github. neat comes with all the atomic data necessary to run the code, predominantly from the CHIANTI 7.0 database but from other sources for a couple of ions. You can get atomic data compilations from CHIANTI 5.2, CHIANTI 6.0, CHIANTI 7.0, and an assortment of older sources, from https://github.com/rwesson/Atomic-data/archive/master.tar.gz.

Once you have downloaded neat, extract the archive and then, in the directory it extracted to, compile the code by typing

make

Our makefile assumes that you have gfortran installed, if you don't have gfortran installed then any modern fortran compiler should work as well, although some alterations may be required given that dialects of Fortran are not necessarily 100% compatible.

Once you've typed make, then after a few seconds the code should have compiled, and you should now see an executable `neat' in the directory you are in. If so, then the code has compiled properly. Now you can install the code by typing

sudo make install

If you don't have root access, or you want to install to a different location, you can change the value of PREFIX in the makefile before compiling.

After installation

To verify that the code is working, try out one of the numerous sample linelists. You will find them in /usr/share/doc/neat/examples or (on a Mac) /usr/local/share/doc/neat/examples. Copy a file from there to a convenient location, and test that the code is working by typing

./neat -i ngc6543_3cols.dat

(changing the file name as appropriate). You should then see something like the following in the terminal:

 NEAT, the Nebular Empirical Analysis Tool
 version 2.2.0-1ppa1~xenial1ubuntu2

 15:29:37 : starting code
            command line: neat -i ngc6543_3cols.dat

            unresolved blend: changed wavelength 7318.92 to 7319.45
            line list file ngc6543_3cols.dat read successfully (223 lines)

            using Howarth (1983) galactic extinction law
            using Porter et al. (2012) He I emissivities
            using Delgado-Inglada et al. (2014) ICF

            reading in abundance analysis weights from /usr/share/neat/default.cfg
            reading atomic data from /usr/share/neat
            reading H emissivities
            reading He I emissivities
            reading He II emissivities
            reading OII diagnostics data

            doing abundance calculations
            finished abundance calculations

            Writing line list
            Linelist written to files:
               ngc6543_3cols.dat_linelist
               ngc6543_3cols.dat_linelist.tex
            Writing summary files
            Results written to files:
               ngc6543_3cols.dat_results
               ngc6543_3cols.dat_results.tex

            all done

And if you then look in the output file, ngc6543_3cols.dat_results, you should see a lot of calculated values, starting with the logarithmic extinction at Hβ and ending with abundance discrepancy factors.

If there were problems and something unlike what is described here has happened, please get in touch.