nanodisort 0.1.0.dev1

Python bindings for cdisort radiative transfer solver

nanodisort

Python bindings for CDISORT, a C implementation of the DISORT (Discrete Ordinates Radiative Transfer) solver.

Overview

DISORT is a widely-used radiative transfer solver for plane-parallel atmospheres. It uses the discrete ordinates method to solve the radiative transfer equation with support for:

• Multiple scattering
• Absorption and emission
• Thermal emission (Planck function)
• Various boundary conditions
• Pseudo-spherical geometry for direct beam

The CDISORT library offers improved performance over the original Fortran version through dynamic memory allocation and full double precision arithmetic.

Installation

Prerequisites

• Python 3.9 to 3.13
• NumPy 1.20 or later

From source

git clone https://github.com/rayference/nanodisort.git
cd nanodisort
uv sync --dev
uv pip install -e .

Quickstart

import nanodisort as nd

# Create solver state
state = nd.DisortState()

# Configure dimensions
state.nstr = 8   # Number of streams
state.nlyr = 6   # Number of layers
state.nmom = 8   # Number of phase function moments
state.ntau = 5   # Number of output optical depths
state.numu = 4   # Number of output polar angles
state.nphi = 3   # Number of output azimuthal angles

# Allocate memory
state.allocate()

# Set optical properties, geometry, boundary conditions
# ... (see documentation)

# Solve
state.solve()

License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later), consistent with the CDISORT library it wraps.

Acknowledgments

nanodisort authors are grateful to the developers of the many implementations of DISORT, and, in particular, to

• Timothy E. Dowling (original CDISORT C translation);
• Robert Buras (phase function extensions);
• Arve Kylling (pseudo-spherical approximation, testing);
• the original DISORT Fortran authors.

Citation

If you use nanodisort in your research, please cite the CDISORT paper and the nanodisort repository:

@software{Leroy_nanodisort,
    author = {Leroy, Vincent and Emde, Claudia},
    license = {GPL-3.0-or-later},
    title = {{nanodisort}},
    url = {https://github.com/eradiate/nanodisort},
    version = {0.1.0}
}