Skip to main content
Ctrl+K
PyRadtran - Home

Getting Started

  • Installation
  • PyRadtran Quickstart

User Guide

  • Configuration
  • Parameters & Validation
  • Atmosphere & ERA5
  • Results & Post-Processing
  • Debugging
  • The Parameter System: A Deep Dive

Tutorials

  • Notebook Gallery
  • Quickstart: Surface Albedo
  • Quickstart: Broadband Thermal
  • Quickstart: Brightness Temperature
  • Quickstart: Solar Spectral
  • Quickstart: ERA5 Atmosphere
  • Advanced: Water Clouds
  • Advanced: Mixed-Phase Clouds (+ ERA5 data)
  • Radiosonde Atmosphere Generator

Case Studies

  • Advanced: Multi-Dimensional Cloud Experiment
  • Realistic simulation of VELOX thermal infrared channels
  • Advanced: Custom Dimension Iteration
  • Cloud Radiative Forcing with Real ACLOUD Data
  • Advanced: Reproducing Shupe & Intrieri (2004)
  • Advanced: Reproducing Shupe & Intrieri (2004) Part 2: Adding seasonal ERA5 Profiles
  • Advanced: Solar Validation Against HALO-(AC)³ Aircraft Measurements
  • Advanced: Realistic Clouds from Observations (Thermal)
  • Advanced: Realistic Clouds from Observations (Solar Spectral)
  • Processing: ERA5 Sea Ice Profiles
  • Arctic Atmosphere in a Warming Climate: ERA5 Sea-Ice Profiles
  • Processing: CARRA Reanalysis Atmosphere
  • Processing: Station Nord 2024
  • Advanced: Ny-Ålesund Radiation

Reference

  • Examples
  • Configuration Gallery
  • API Reference
    • pyradtran.channels
      • pyradtran.channels.brightness_temperature
      • pyradtran.channels.convolve_channels
    • pyradtran.clouds
      • pyradtran.clouds.generate_cloud_file_from_era5
      • pyradtran.clouds.CloudFileWriter
      • pyradtran.clouds.CloudGenerator
      • pyradtran.clouds.CloudLayer
    • pyradtran.config
      • pyradtran.config.create_example_config
      • pyradtran.config.list_atmosphere_profiles
      • pyradtran.config.list_solar_spectra
      • pyradtran.config.load_config
      • pyradtran.config.save_master_config
      • pyradtran.config.CloudParameters
      • pyradtran.config.ExecutionConfig
      • pyradtran.config.OutputConfig
      • pyradtran.config.PathsConfig
      • pyradtran.config.SimulationConfig
      • pyradtran.config.SimulationDefaults
    • pyradtran.core
      • pyradtran.core.Simulation
    • pyradtran.era5
      • pyradtran.era5.cloud_profiles
      • pyradtran.era5.era5_atmosphere_file
      • pyradtran.era5.normalize_era5
      • pyradtran.era5.recommend_atmosphere
      • pyradtran.era5.select_profile
      • pyradtran.era5.write_atmosphere_file
    • pyradtran.exceptions
      • pyradtran.exceptions.ConfigurationError
      • pyradtran.exceptions.InputGenerationError
      • pyradtran.exceptions.OutputParsingError
      • pyradtran.exceptions.PyRadtranError
      • pyradtran.exceptions.RadiosondeError
      • pyradtran.exceptions.UvspecExecutionError
      • pyradtran.exceptions.ValidationError
    • pyradtran.input_builder
      • pyradtran.input_builder.calculate_solar_zenith_angle
      • pyradtran.input_builder.effective_output_altitudes
      • pyradtran.input_builder.effective_output_columns
      • pyradtran.input_builder.InputFileBuilder
      • pyradtran.input_builder.InputLine
    • pyradtran.interface
      • pyradtran.interface.execute_simulation_batch
      • pyradtran.interface.run_pyradtran_simulation
      • pyradtran.interface.PointOutcome
      • pyradtran.interface.PyRadtranAccessor
      • pyradtran.interface.SimPoint
    • pyradtran.io
      • pyradtran.io.ERA5AtmosphereGenerator
      • pyradtran.io.InputDataLoader
      • pyradtran.io.NetCDFSaver
      • pyradtran.io.OutputParser
      • pyradtran.io.OutputToXarray
      • pyradtran.io.OutputType
      • pyradtran.io.ParsedOutput
      • pyradtran.io.RadiosondeAtmosphereGenerator
    • pyradtran.params
      • pyradtran.params.describe
      • pyradtran.params.get_schema
      • pyradtran.params.search_options
      • pyradtran.params.validate_against_schema
      • pyradtran.params.ParamResolver
      • pyradtran.params.ParamSpec
      • pyradtran.params.Raw
      • pyradtran.params.Var
    • pyradtran.schema
      • pyradtran.schema.extract_schema
      • pyradtran.schema.find_libradtran_root
      • pyradtran.schema.load_schema
    • pyradtran.utils
      • pyradtran.utils.RadiosondeFinder
  • Contributing
  • Changelog
  • .md

Notebook Gallery

Contents

  • Tutorials — learn one thing at a time
  • Case studies — full research workflows

Notebook Gallery#

All notebooks run locally once pyRadtran and libRadtran are installed and ~/.pyradtran/config.yaml points to your installation (see Installation). Case studies using non-public campaign data are adaptable — swap in your own file paths.

Tutorials — learn one thing at a time#

Notebook

Teaches

PyRadtran Quickstart

The full basic workflow in ten minutes

The Parameter System: A Deep Dive

The parameter system end to end: params, Var, validation, describe(), explain(), channels, jacobians

Quickstart: Surface Albedo

Per-point surface albedo with Var

Quickstart: Broadband Thermal

Broadband thermal irradiance

Quickstart: Brightness Temperature

Brightness temperatures for a nadir imager

Quickstart: Solar Spectral

Spectral solar irradiance

Quickstart: ERA5 Atmosphere

ERA5 reanalysis as the atmosphere profile

Advanced: Water Clouds

A parametric water cloud via wc_file

Advanced: Mixed-Phase Clouds (+ ERA5 data)

Mixed-phase cloud profiles from files

Radiosonde Atmosphere Generator

Atmosphere files from IGRA radiosondes

Case studies — full research workflows#

Arctic radiation science built from the tutorial ingredients: campaign simulations, instrument forward models, sensitivity studies.

Notebook

Topic

Advanced: Multi-Dimensional Cloud Experiment

Cloud parameter sweeps over sea ice

Realistic simulation of VELOX thermal infrared channels

Six-channel VELOX thermal imager forward model

Advanced: Custom Dimension Iteration

Thermal imager with realistic atmospheres

Cloud Radiative Forcing with Real ACLOUD Data

Spectral albedo shifts under clouds

Advanced: Reproducing Shupe & Intrieri (2004)

Shupe & Intrieri cloud-forcing analysis

Advanced: Reproducing Shupe & Intrieri (2004) Part 2: Adding seasonal ERA5 Profiles

Seasonal ERA5 profiles over sea ice

Advanced: Solar Validation Against HALO-(AC)³ Aircraft Measurements

HALO-(AC)³ broadband radiometer validation

Advanced: Realistic Clouds from Observations (Thermal)

Campaign radiosonde-driven thermal runs

Advanced: Realistic Clouds from Observations (Solar Spectral)

Campaign radiosonde-driven spectral runs

Processing: ERA5 Sea Ice Profiles

Sea-ice ERA5 download & processing

Arctic Atmosphere in a Warming Climate: ERA5 Sea-Ice Profiles

Visualising the processed ERA5 data

Processing: CARRA Reanalysis Atmosphere

CARRA regional reanalysis profiles

Processing: Station Nord 2024

Station Nord 2024 thermal study

Advanced: Ny-Ålesund Radiation

Ny-Ålesund radiation with radiosondes

Tip

Something looks off? Check your input file! — inspecting the generated uvspec input is the fastest route to a diagnosis.

previous

The Parameter System: A Deep Dive

next

Quickstart: Surface Albedo

Contents
  • Tutorials — learn one thing at a time
  • Case studies — full research workflows

By PyRadtran Developers

© Copyright 2025.