Installation

ARIADNE requires Python 3.11 or higher and uses modern Python packaging standards (PEP 517/518).

Quick Install (Recommended)

Install the latest stable version from PyPI:

pip install astroariadne

Development Install

To install from source for development or to use the latest unreleased features:

git clone https://github.com/jvines/astroARIADNE.git
cd astroARIADNE
pip install -e .

The -e flag installs in editable mode, allowing you to modify the source code.

Dependencies

All required dependencies are automatically installed via pip. The main packages include:

Numpy (https://numpy.org/)
Scipy (https://www.scipy.org/)
Pandas (https://pandas.pydata.org/)
numba (http://numba.pydata.org/)
astropy (https://astropy.readthedocs.io/en/stable/)
astroquery (https://astroquery.readthedocs.io/en/latest/)
regions (https://astropy-regions.readthedocs.io/en/latest/index.html)
PyAstronomy (https://pyastronomy.readthedocs.io/en/latest/)
corner (https://corner.readthedocs.io/en/latest/)
tqdm (https://tqdm.github.io/)
matplotlib (https://matplotlib.org/)
termcolor (https://pypi.org/project/termcolor/)
extinction (https://extinction.readthedocs.io/en/latest/)
pyphot (http://mfouesneau.github.io/docs/pyphot/)
dustmaps (https://dustmaps.readthedocs.io/en/latest/) [NEEDS CONFIGURING AND DOWNLOADING OF DUSTMAPS]
dynesty (https://dynesty.readthedocs.io/en/latest/)
isochrones (https://isochrones.readthedocs.io/en/latest/) [NEEDS EXTRA SETUP WITH nosetests isochrones]

Special Installations

dustmaps Configuration

After installing ARIADNE, you must download and configure dustmaps:

# Download SFD dust map
import dustmaps.sfd
dustmaps.sfd.fetch()

# Download Bayestar dust map
import dustmaps.bayestar
dustmaps.bayestar.fetch()

See the dustmaps documentation for other available dust maps.

isochrones Setup

The isochrones package requires additional setup after installation:

# This downloads required stellar evolution models
python -c "from isochrones import get_bc_grid; get_bc_grid('mist')"

Or run the test suite which handles setup automatically:

nosetests isochrones

Platform Support

ARIADNE has been tested on:

Linux (fully supported)
macOS (fully supported, tested up to Catalina and later)
Windows (limited support - healpy dependency may cause issues, see healpy/healpy#25)

Build System

ARIADNE uses pyproject.toml for modern, declarative package configuration. Dependency installation and version management are handled automatically by pip/setuptools.

Model Spectra for SED Plotting

Plotting the SED model is optional — you can run the fitting code without any model spectra. If you want SED plots, there are two options:

Spectra Cache (Recommended)

Download the pre-computed spectra cache (~2.6 GB) from Zenodo. This contains all 7 model grids (Phoenix v2, BT-Settl, BT-NextGen, BT-Cond, Castelli & Kurucz, Kurucz, Coelho) broadened to R=1500 and resampled to a common wavelength grid. This is all you need for plot_SED().

from astroARIADNE.fetch import fetch_spectra_cache
fetch_spectra_cache()

Or from the command line:

python -c "from astroARIADNE.fetch import fetch_spectra_cache; fetch_spectra_cache()"

No environment variables or additional setup required.

Full Model Grids (Optional)

If you need the raw high-resolution model spectra (e.g. for custom broadening or direct spectral analysis), you can download the full grids. Note that these total several hundred GB.

Model	Link
Phoenix v2	ftp://phoenix.astro.physik.uni-goettingen.de/HiResFITS/PHOENIX-ACES-AGSS-COND-2011/
Phoenix v2 wavelength file	ftp://phoenix.astro.physik.uni-goettingen.de/HiResFITS/WAVE_PHOENIX-ACES-AGSS-COND-2011.fits
BT-Models	http://svo2.cab.inta-csic.es/theory/newov2/
Castelli & Kurucz	http://ssb.stsci.edu/cdbs/tarfiles/synphot3.tar.gz
Kurucz 1993	http://ssb.stsci.edu/cdbs/tarfiles/synphot4.tar.gz

The wavelength file for the Phoenix model has to be placed in the root folder of the PHOENIXv2 models.

To tell ARIADNE where to find the models, set the ARIADNE_MODELS environment variable:

export ARIADNE_MODELS='/path/to/Models_Dir/'

You can add this to your .bash_profile or .bashrc so you don’t have to export every time.

The directory structure should look like this:

Models_Dir
│
└───BTCond
│   │
│   └───CIFIST2011
│
└───BTNextGen
│	 │
│	 └───AGSS2009
│
└───BTSettl
│	 │
│	 └───AGSS2009
│
└───Castelli_Kurucz
│	 │
│	 └───ckm05
│	 │
│	 └───ckm10
│	 │
│	 └───ckm15
│	 │
│	 └───ckm20
│	 │
│	 └───ckm25
│	 │
│	 └───ckp00
│	 │
│	 └───ckp02
│	 │
│	 └───ckp05
│
└───Kurucz
│	 │
│	 └───km01
│	 │
│	 └───km02
│	 │
│	 └───km03
│	 │
│	 └───km05
│	 │
│	 └───km10
│	 │
│	 └───km15
│	 │
│	 └───km20
│	 │
│	 └───km25
│	 │
│	 └───kp00
│	 │
│	 └───kp01
│	 │
│	 └───kp02
│	 │
│	 └───kp03
│	 │
│	 └───kp05
│	 │
│	 └───kp10
│
└───PHOENIXv2
	 │
     └─── WAVE_PHOENIX-ACES-AGSS-COND-2011.fits
	 └───Z-0.0
	 │
	 └───Z-0.5
	 │
	 └───Z-1.0
	 │
	 └───Z-1.5
	 │
	 └───Z-2.0
	 │
	 └───Z+0.5
	 │
	 └───Z+1.0

Notes:

The Phoenix v2 models with alpha enhancements are unused
BT-models are BT-Settl, BT-Cond, and BT-NextGen