Metadata-Version: 2.4
Name: nautilus-astrochem-code
Version: 2.1.1
Summary: Fortran simulation binaries for the NAUTILUS gas-grain chemistry code
Author-Email: Valentine Wakelam <valentine.wakelam@u-bordeaux.fr>, Alexandre Mechineau <alexandre.mechineau@u-bordeaux.fr>
License-Expression: MIT
License-File: LICENSE
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Fortran
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: loguru>=0.7.3
Requires-Dist: tyro>=1.0.15
Description-Content-Type: text/markdown

# Nautilus gas-grain code for astrochemistry

![Stable Version](https://img.shields.io/pypi/v/nautilus_astrochem_code?style=for-the-badge&label=Stable)
![Python Versions](https://img.shields.io/pypi/pyversions/nautilus_astrochem_code?style=for-the-badge&label=Python)

> Python CLI for the Nautilus gas-grain astrochemistry code.

[![](https://img.shields.io/badge/doc-Users-green?style=for-the-badge)](https://lab.pages.in2p3.fr/astrochem-tools/nautilus-doc/ "Documentation")

This package is part of the [Nautilus](https://gitlab.in2p3.fr/LAB/astrochem-tools/nautilus) project.

It provides the compiled Fortran binaries of
the [Nautilus gas-grain code](https://gitlab.in2p3.fr/LAB/astrochem-tools/nautilus/-/tree/main/nautilus-astrochem-code)
for astrochemistry: `nautilus_code` and `nautilus_rates_netcdf`.

> [!IMPORTANT]
> You are not meant to call these binaries directly.
> Install the [nautilus-astrochem](https://pypi.org/project/nautilus-astrochem) package instead:
> it drives these binaries and adds plotting and post-processing.

## Getting started

To get started with `nautilus-astrochem-code`, we offer a repository
[nautilus-doc](https://gitlab.in2p3.fr/LAB/astrochem-tools/nautilus-doc),
with scientific documentation and examples of use cases ready to run.
This repository is used to provide the [documentation website](https://lab.pages.in2p3.fr/astrochem-tools/nautilus-doc/),
where the content of the documentation is available.

## Installation

This package is a dependency of `nautilus-astrochem`; you normally install it through that
package rather than on its own.

### Common issues

We provide pre-built wheels for the most common platforms.
When no wheel matches your platform, or if you force a build from the source,
the binaries are compiled during installation, so you must provide:

- a Fortran compiler, and
- the netcdf library for Fortran.

Only `gfortran` with `netcdf-fortran` is tested for now.

- on macOS: `sudo port install gcc14 netcdf-fortran` or `brew install gcc netcdf-fortran`
- on Ubuntu: `apt install gfortran libnetcdff-dev`

## License

`nautilus-astrochem-code` is distributed under the MIT license (see [LICENSE](LICENSE)).
That license covers the Nautilus sources only.

The published wheels are built and repaired using `cibuildwheel`,
they carry third-party libraries that keep their own license.

## Contact

Requests or questions can be sent to valentine.wakelam@u-bordeaux.fr.
