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

pip install nanodisort

Prerequisites:

Supported platforms: Linux, macOS
Python 3.10 and later
NumPy 1.20 or later
nanobind-backend (installed automatically)

Quickstart

Single Rayleigh-scattering layer illuminated by a solar beam at 60° zenith:

import numpy as np
import nanodisort as nd
from nanodisort.utils import phase_functions as pf

# Configure dimensions and allocate
ds = nd.DisortState()
ds.nstr = 16     # number of streams
ds.nlyr = 1      # number of layers
ds.nmom = 16     # phase function moments (>= nstr)
ds.ntau = 2      # output optical depth levels
ds.numu = 6      # output polar angles
ds.nphi = 1      # output azimuthal angles
ds.nphase = 100  # phase-angle grid points for the Buras-Emde correction
ds.allocate()

# Flags
ds.usrtau = True                     # user-specified output levels
ds.usrang = True                     # user-specified viewing angles
ds.lamber = True                     # Lambertian lower boundary
ds.quiet = True                      # suppress C-level output
ds.intensity_correction = True       # enable intensity correction
ds.old_intensity_correction = False  # use the Buras-Emde algorithm (default)

# Optical properties
ds.dtauc = np.array([0.1])          # extinction optical thickness
ds.ssalb = np.array([1.0])          # single-scattering albedo (pure scattering)
ds.pmom = pf.rayleigh(ds.nmom).reshape(-1, 1)  # Rayleigh phase function moments

# Buras-Emde correction: tabulate the phase function on a scattering-angle grid.
# mu_phase holds the scattering-angle cosines, shape (nphase,); phase holds the
# phase function values per layer, shape (nlyr, nphase). Here we use the analytic
# Rayleigh phase function P(mu) = 0.75 * (1 + mu**2).
mu_phase = np.linspace(-1.0, 1.0, ds.nphase)
ds.mu_phase = mu_phase
ds.phase = (0.75 * (1.0 + mu_phase**2)).reshape(1, -1)

# Output levels and viewing angles
ds.utau = np.array([0.0, 0.1])                    # TOA and surface
ds.umu = np.array([-1.0, -0.5, -0.1, 0.1, 0.5, 1.0])  # cosines of polar angles
ds.phi = np.array([0.0])                           # azimuthal angle [degrees]

# Boundary conditions
ds.fbeam = np.pi  # solar irradiance [W/m²]
ds.umu0 = 0.5     # cosine of solar zenith angle (60°)
ds.phi0 = 0.0     # solar azimuth [degrees]
ds.albedo = 0.0   # black surface
ds.fisot = 0.0    # no diffuse illumination from above

# Solve
ds.solve()

# Fluxes at each output level: shape (ntau,)
print(ds.rfldir)  # direct-beam downward irradiance
print(ds.rfldn)   # diffuse downward irradiance
print(ds.flup)    # diffuse upward irradiance

# Radiance field: shape (numu, ntau, nphi)
print(ds.uu.shape)

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.

Acknowledgements

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 (Knuth Stamnes, Si-Chee Tsay, Warren Wiscombe and Kolf Jayaweera).

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.2.0}
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nanodisort-0.3.0.tar.gz (362.5 kB view details)

Uploaded Sep 3, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (177.1 kB view details)

Uploaded Sep 3, 2026 CPython 3.10+manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl (174.4 kB view details)

Uploaded Sep 3, 2026 CPython 3.10+macOS 11.0+ ARM64

nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl (186.1 kB view details)

Uploaded Sep 3, 2026 CPython 3.10+macOS 10.13+ x86-64

File details

Details for the file nanodisort-0.3.0.tar.gz.

File metadata

Download URL: nanodisort-0.3.0.tar.gz
Upload date: Sep 3, 2026
Size: 362.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nanodisort-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`83125cdcc0543e6ddcfee6fe14b58cd929d6e94771ee0d110fe746e4d7df119c`
MD5	`eab0738ce7baeb44b019ded386a9ea5f`
BLAKE2b-256	`103271dad01eee4124b342f5aeadf619c482d9364d6a5a473a263898d1fae5f9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nanodisort-0.3.0.tar.gz:

Publisher: build.yml on eradiate/nanodisort

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nanodisort-0.3.0.tar.gz
- Subject digest: 83125cdcc0543e6ddcfee6fe14b58cd929d6e94771ee0d110fe746e4d7df119c
- Sigstore transparency entry: 2699086037
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: eradiate/nanodisort@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/eradiate
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build.yml@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Trigger Event: push

File details

Details for the file nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Sep 3, 2026
Size: 177.1 kB
Tags: CPython 3.10+, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`8342614ccd092a334eb2c5078ab39644429a7458f1d450a8cb24429d48ccc0f1`
MD5	`fb0014afab06032fdc80894aa4e52bd2`
BLAKE2b-256	`3db10037a81d59155c33d826fdd040b1a56a74ec195bede52bbf73eb54ae3256`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build.yml on eradiate/nanodisort

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nanodisort-0.3.0-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Subject digest: 8342614ccd092a334eb2c5078ab39644429a7458f1d450a8cb24429d48ccc0f1
- Sigstore transparency entry: 2699086092
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: eradiate/nanodisort@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/eradiate
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build.yml@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Trigger Event: push

File details

Details for the file nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Sep 3, 2026
Size: 174.4 kB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`fce6b2cab09d67e17fb8f45b3e3622d0dc2ea222cf4f11cd50941cf0912f2abe`
MD5	`85489bc6037a7e2d2e1d60132f43d54c`
BLAKE2b-256	`10dab9a119b0148732a96d04cf601a60ec0575da06930f0dbd9e9a3ea3dbc097`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: build.yml on eradiate/nanodisort

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nanodisort-0.3.0-cp310-abi3-macosx_11_0_arm64.whl
- Subject digest: fce6b2cab09d67e17fb8f45b3e3622d0dc2ea222cf4f11cd50941cf0912f2abe
- Sigstore transparency entry: 2699086065
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: eradiate/nanodisort@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/eradiate
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build.yml@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Trigger Event: push

File details

Details for the file nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl.

File metadata

Download URL: nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl
Upload date: Sep 3, 2026
Size: 186.1 kB
Tags: CPython 3.10+, macOS 10.13+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl
Algorithm	Hash digest
SHA256	`670c83ba7322f90657e733972f198d7673376b036144bd4108768e2dad5f8447`
MD5	`0ad4252333a0974c40e1faf625f1df50`
BLAKE2b-256	`b3fc1a95cf3295e46196d22847b22e91c810c70b11b49edd4d067a2a1f4453cc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl:

Publisher: build.yml on eradiate/nanodisort

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nanodisort-0.3.0-cp310-abi3-macosx_10_13_x86_64.whl
- Subject digest: 670c83ba7322f90657e733972f198d7673376b036144bd4108768e2dad5f8447
- Sigstore transparency entry: 2699086122
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: eradiate/nanodisort@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/eradiate
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build.yml@3f77cfba952f352ab4cae3b5f4abb7ae55972f8f
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.3.0 This release

Sep 3, 2026 4 files

Pre-release

0.3.0rc1

Aug 25, 2026 4 files

0.2.0

Jun 2, 2026 16 files

0.1.0

Apr 13, 2026 16 files

nanodisort 0.3.0

nanodisort

Overview

Installation

Quickstart

License

Acknowledgements

Citation

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed