zju-scatt-interface 0.9.0__tar.gz

zju_scatt_interface-0.9.0/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## Unreleased
+
+## 0.9.0 - 2026-10-13 (prepared, not published)
+
+- Set the initial public release candidate to `0.9.0`; plan further testing and
+  `0.9.x` fixes before considering `1.0.0`. Earlier `1.0.0a1` entries below
+  describe internal development checkpoints, not this public release.
+
+- Included the September 2026 revised dust and black-carbon statistics and six
+  material reference CSVs in the release candidate.
+- Recognized `Wavelength (in micrometers)` reference-table headers and tested all
+  twelve explicit ice temperature-column pairs.
+- Added a regression check for the revised black-carbon means, clean staging and
+  artifact verification for releases, and a PyPI publication guide.
+- Read build-time version metadata directly from `_version.py` and included tests,
+  Python scheme configurations, and the changelog in source distributions.
+
+- Revised single-particle interpolation to combine logarithmic dimensional cross
+  sections and projected area, derive SSA/efficiencies afterward, interpolate
+  source-normalized phase ratios, and expose solid-angle-weighted phase L2 metrics.
+- Added template-driven optical table export from in-memory results or canonical
+  NetCDF4/HDF5 products, with JSON/Python format specifications, unit transforms,
+  fixed-width rows, per-particle files, and phase-matrix long tables.
+- Added retained multidimensional bulk-optics grids through `BulkDimension`,
+  `SingleBulkScheme`, and `MultiBulkScheme`, including particle-specific NetCDF4
+  and HDF5 dimensions, coordinate variables, phase matrices, and validation.
+- Separated single-population calculation, custom aggregation, and output;
+  removed implicit `mixing_fraction` and `include_mixture` scheme behavior.
+- Added Phase 11 eight-profile exact/interpolated fixture coverage, trusted
+  numerical references, output-corruption tests, opt-in live tests, expanded CI,
+  artifact checks, and clean-install validation.
+- Corrected interpolation aliases so source symbols `n` and `alpha` map to
+  `roundness` and `aspect_ratio`.
+- Separated package identity, exceptions, endpoints, and optical models from the
+  private compatibility engine.
+- Completed Phase 10 user workflows with full BC, dust, sea-salt, and
+  multi-temperature ice recipes.
+- Added observed-PSD CSV and interpolation/nearest/no-extrapolation examples.
+- Added `bulk-opt schema` and Python machine-reference APIs for deterministic
+  GPT-assisted scheme creation.
+- Added complete parameter, recipe, GPT-safety, and troubleshooting documentation,
+  plus Phase 10 tests and graphical validation.
+
+## 1.0.0a1 - Phase 2 registry work
+
+- Added canonical scientific profiles for all eight local L1 particle families.
+- Added `zju-scatt describe [PARTICLE_TYPE]` and JSON metadata output.
+- Added optional L1 NetCDF source-schema and major-revision validation.
+- Added automatic extended-length Windows paths for long scientific filenames.
+- Documented empirical profile coverage, RH storage conventions, and size meanings.
+- Converted L1 `cext = k^2 Cext` to physical cross sections in `m2`.
+- Converted `xsize_veq` and `xsize_maxd` to physical radii in `um`.
+- Converted user number concentrations from `cm-3` to `m-3` internally so bulk
+  coefficients are returned in `m-1`.
+- Prevented silent flattening of multidimensional RH, volume-fraction, and shape
+  dimensions.
+
+## 1.0.0a1 - Phase 1 checkpoint (2026-07-23)
+
+- Preserved the tested earlier command behavior behind the modular package.
+- Added explicit direct and browser-assisted registration methods.
+- Added actionable first-run and expired-session recovery guidance.
+- Added the read-only `zju-scatt doctor` command with human and JSON reports.
+- Added Windows, Linux, and macOS installation documentation.
+- Added clean-install CI coverage for supported platforms and Python versions.
+- Recorded the Python-first bulk-scheme design and minimal single-scattering-variable
+  policy for subsequent phases.

zju_scatt_interface-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Senyi Kong and ZJU-SCATT Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zju_scatt_interface-0.9.0/MANIFEST.in

@@ -0,0 +1,7 @@
+recursive-include configs *.json *.py
+recursive-include docs *.md
+recursive-include examples *.py *.csv
+recursive-include tests/data *.json
+recursive-include tests *.py
+include CHANGELOG.md
+include tools/prepare_release.py

zju_scatt_interface-0.9.0/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: zju-scatt-interface
+Version: 0.9.0
+Summary: Search, retrieve, integrate, and visualize ZJU-SCATT optical data
+Author: Senyi Kong
+Maintainer: ZJU-SCATT Team
+License-Expression: MIT
+Project-URL: Homepage, https://zju_radiation.deep-time.org/
+Project-URL: Data browser, https://zju_radiation.deep-time.org/download
+Keywords: ZJU-SCATT,atmospheric-radiation,remote-sensing,climate,optical-properties
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: native
+Requires-Dist: numpy>=1.23; extra == "native"
+Requires-Dist: h5py>=3.9; extra == "native"
+Requires-Dist: netCDF4>=1.6; extra == "native"
+Provides-Extra: netcdf
+Requires-Dist: h5py>=3.9; extra == "netcdf"
+Requires-Dist: netCDF4>=1.6; extra == "netcdf"
+Provides-Extra: plot
+Requires-Dist: matplotlib>=3.7; extra == "plot"
+Provides-Extra: all
+Requires-Dist: numpy>=1.23; extra == "all"
+Requires-Dist: h5py>=3.9; extra == "all"
+Requires-Dist: matplotlib>=3.7; extra == "all"
+Requires-Dist: netCDF4>=1.6; extra == "all"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: h5py>=3.9; extra == "dev"
+Requires-Dist: netCDF4>=1.6; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# ZJU-SCATT Interface
+
+`zju_scatt_interface` is the modular Python and command-line interface for finding,
+downloading, extracting, integrating, and plotting ZJU-SCATT optical data. It is
+designed for users in atmospheric radiation, remote sensing, weather, and climate
+modeling without requiring knowledge of the database's remote directory layout.
+
+The current release candidate is `0.9.0`, intended for testing before `1.0.0`.
+
+## Install from PyPI (after publication)
+
+```console
+python -m pip install "zju-scatt-interface[all]==0.9.0"
+zju-scatt doctor --offline
+```
+
+Use `zju-scatt-interface==0.9.0` for the standard-library-only core. The `[all]`
+extra adds scientific file support and plotting. The import name is
+`zju_scatt_interface`. Database downloads require separate registration.
+
+This package provides the same `zju-scatt` command as the earlier `zju-scatt`
+distribution; install them in separate virtual environments to avoid command
+collisions. See `docs/PYPI_PUBLICATION.md` for release preparation and updates.
+
+## Install for development
+
+```console
+python -m pip install -e ".[all]"
+zju-scatt doctor --offline
+zju-scatt --help
+```
+
+The short command remains `zju-scatt`; the descriptive package and long command are
+`zju_scatt_interface` and `zju-scatt-interface`.
+
+See `docs/INSTALLATION.md` for Windows, Linux, and macOS setup plus first-run
+diagnostics.
+
+Run a complete online diagnostic after registration:
+
+```console
+zju-scatt doctor
+```
+
+## Registration
+
+Direct CLI registration is the default and covers normal use:
+
+```console
+zju-scatt register
+```
+
+For users who must complete the website form, the alternative is explicit:
+
+```console
+zju-scatt register --method browser
+```
+
+The terminal opens or prints the official page, explains how to obtain the session
+token, validates it, and stores it without echoing it. `--browser-assisted` remains a
+deprecated compatibility alias. Tokens must never be pasted into chat, committed, or
+included in logs.
+
+## Existing workflows retained
+
+All v1 commands are retained during modular migration: `browse`, `list`, `search`,
+`estimate`, `retrieve`, `download`, `bulk`, `register`, `session`, `metadata`, and
+`check`. Retrieval and explicit downloads create their output directories as needed.
+
+```console
+zju-scatt retrieve --particle-type super_spheroid_ice \
+  --target-wavelength 0.67um --target-wavelength-mode interp \
+  --output-dir zju_scatt_data --yes
+```
+
+The retrieval selector identifies source files in refractive-index `(n,k)` space and
+records provenance. The completed calculation pipeline separately records when a
+single-particle interpolated product was generated, integrates the user PSD, runs
+physical QA, and can write equivalent NetCDF4 or HDF5 bulk products.
+
+## Python modules
+
+| Module | Responsibility |
+|---|---|
+| `auth` | Direct registration, browser-token import, session validation |
+| `catalog` | Browse/search, scientific filename metadata, manifests |
+| `download` | Resumable downloads and automatic local storage |
+| `retrieval` | High-level parameter requests and source selection |
+| `planning` | Scheme dependency plans, verified cache, manifests, offline reports |
+| `size_distribution` | Array/function/file PSDs, validation, conservative remapping |
+| `bulk` | NetCDF loading and PSD-integrated optical properties |
+| `schemes` | Typed multi-particle configs and NetCDF4/HDF5 output orchestration |
+| `plotting` | Optional scientific plotting |
+
+See `docs/ARCHITECTURE.md`, `docs/REGISTRATION.md`,
+`docs/PARTICLE_PROFILES.md`, `docs/L1_CEXT_AND_BULK_UNITS.md`,
+`docs/REFRACTIVE_INDEX_RESOLUTION.md`,
+`docs/SOURCE_DEPENDENCY_PLANNING.md`,
+`docs/SIZE_DISTRIBUTIONS.md`,
+`docs/BULK_CALCULATION.md`, `docs/OUTPUT_FORMATS.md`,
+`docs/SCHEME_API_AND_CLI.md`, `docs/MULTIDIMENSIONAL_BULK_SCHEMES.md`,
+`docs/CUSTOM_OPTICAL_TABLE_OUTPUT.md`,
+`docs/PARTICLE_PARAMETER_REFERENCE.md`, `docs/PARTICLE_RECIPES.md`,
+`docs/GPT_USAGE_GUIDE.md`, `docs/TROUBLESHOOTING.md`,
+`docs/LIVE_TESTING.md`, `docs/RELEASE_CHECKLIST.md`,
+`docs/PROJECT_TASK_LIST.md`,
+`docs/STATUS_REPORT_2026-07-23.md`, `docs/STATUS_UPDATE_2026-07-24.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE8.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE9.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE10.md`,
+`docs/STATUS_UPDATE_2026-07-28_PHASE11.md`, the
+configuration in `configs/`, and the runnable
+scripts in `examples/`. Validate a scheme before running any network or scientific
+calculation:
+
+```console
+zju-scatt scheme configs/bulk_scheme.example.json
+zju-scatt scheme-sources configs/bulk_scheme.example.json \
+  --workspace zju_scatt_data
+zju-scatt psd-check configs/bulk_scheme.example.json
+zju-scatt bulk-opt validate configs/bulk_scheme.example.json
+zju-scatt bulk-opt plan configs/bulk_scheme.example.json --dry-run
+```
+
+Generate the authoritative machine-readable reference or start from a complete
+particle recipe:
+
+```console
+zju-scatt bulk-opt schema --json
+zju-scatt bulk-opt schema --particle-type super_spheroid_ice --json
+zju-scatt bulk-opt validate configs/recipes/ice_multi_temperature_bulk.json
+python examples/example_04_observed_psd_csv.py
+python examples/example_05_interpolation_modes.py
+python examples/example_16_phase11_release_readiness_validation.py
+```
+
+## Verification
+
+Native ARTS 2.x XML, CRTM CloudCoeff release-3 NetCDF/binary, and RTTOV13 HDF5
+exports are available through structured JSON templates. See
+[Native model formats](docs/NATIVE_MODEL_FORMATS.md) for the format assessment,
+required variables and normalization, supported versions, and reference checks.
+
+```console
+python -m pip install -e ".[native]"
+python examples/example_17_native_model_formats.py --output native_model_output
+```
+
+First install the package from the project root:
+
+```console
+python -m pip install -e .
+python -m unittest discover -s tests -v
+python -m zju_scatt_interface --help
+```
+
+Run only the CLI tests:
+
+```console
+python tests/test_cli.py
+```
+
+For a quick source-tree run without installation:
+
+```console
+PYTHONPATH=src python tests/test_cli.py
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+In Windows PowerShell, replace the inline assignment with:
+
+```powershell
+$env:PYTHONPATH = (Resolve-Path src).Path
+python tests\test_cli.py
+```

zju_scatt_interface-0.9.0/README.md

@@ -0,0 +1,175 @@
+# ZJU-SCATT Interface
+
+`zju_scatt_interface` is the modular Python and command-line interface for finding,
+downloading, extracting, integrating, and plotting ZJU-SCATT optical data. It is
+designed for users in atmospheric radiation, remote sensing, weather, and climate
+modeling without requiring knowledge of the database's remote directory layout.
+
+The current release candidate is `0.9.0`, intended for testing before `1.0.0`.
+
+## Install from PyPI (after publication)
+
+```console
+python -m pip install "zju-scatt-interface[all]==0.9.0"
+zju-scatt doctor --offline
+```
+
+Use `zju-scatt-interface==0.9.0` for the standard-library-only core. The `[all]`
+extra adds scientific file support and plotting. The import name is
+`zju_scatt_interface`. Database downloads require separate registration.
+
+This package provides the same `zju-scatt` command as the earlier `zju-scatt`
+distribution; install them in separate virtual environments to avoid command
+collisions. See `docs/PYPI_PUBLICATION.md` for release preparation and updates.
+
+## Install for development
+
+```console
+python -m pip install -e ".[all]"
+zju-scatt doctor --offline
+zju-scatt --help
+```
+
+The short command remains `zju-scatt`; the descriptive package and long command are
+`zju_scatt_interface` and `zju-scatt-interface`.
+
+See `docs/INSTALLATION.md` for Windows, Linux, and macOS setup plus first-run
+diagnostics.
+
+Run a complete online diagnostic after registration:
+
+```console
+zju-scatt doctor
+```
+
+## Registration
+
+Direct CLI registration is the default and covers normal use:
+
+```console
+zju-scatt register
+```
+
+For users who must complete the website form, the alternative is explicit:
+
+```console
+zju-scatt register --method browser
+```
+
+The terminal opens or prints the official page, explains how to obtain the session
+token, validates it, and stores it without echoing it. `--browser-assisted` remains a
+deprecated compatibility alias. Tokens must never be pasted into chat, committed, or
+included in logs.
+
+## Existing workflows retained
+
+All v1 commands are retained during modular migration: `browse`, `list`, `search`,
+`estimate`, `retrieve`, `download`, `bulk`, `register`, `session`, `metadata`, and
+`check`. Retrieval and explicit downloads create their output directories as needed.
+
+```console
+zju-scatt retrieve --particle-type super_spheroid_ice \
+  --target-wavelength 0.67um --target-wavelength-mode interp \
+  --output-dir zju_scatt_data --yes
+```
+
+The retrieval selector identifies source files in refractive-index `(n,k)` space and
+records provenance. The completed calculation pipeline separately records when a
+single-particle interpolated product was generated, integrates the user PSD, runs
+physical QA, and can write equivalent NetCDF4 or HDF5 bulk products.
+
+## Python modules
+
+| Module | Responsibility |
+|---|---|
+| `auth` | Direct registration, browser-token import, session validation |
+| `catalog` | Browse/search, scientific filename metadata, manifests |
+| `download` | Resumable downloads and automatic local storage |
+| `retrieval` | High-level parameter requests and source selection |
+| `planning` | Scheme dependency plans, verified cache, manifests, offline reports |
+| `size_distribution` | Array/function/file PSDs, validation, conservative remapping |
+| `bulk` | NetCDF loading and PSD-integrated optical properties |
+| `schemes` | Typed multi-particle configs and NetCDF4/HDF5 output orchestration |
+| `plotting` | Optional scientific plotting |
+
+See `docs/ARCHITECTURE.md`, `docs/REGISTRATION.md`,
+`docs/PARTICLE_PROFILES.md`, `docs/L1_CEXT_AND_BULK_UNITS.md`,
+`docs/REFRACTIVE_INDEX_RESOLUTION.md`,
+`docs/SOURCE_DEPENDENCY_PLANNING.md`,
+`docs/SIZE_DISTRIBUTIONS.md`,
+`docs/BULK_CALCULATION.md`, `docs/OUTPUT_FORMATS.md`,
+`docs/SCHEME_API_AND_CLI.md`, `docs/MULTIDIMENSIONAL_BULK_SCHEMES.md`,
+`docs/CUSTOM_OPTICAL_TABLE_OUTPUT.md`,
+`docs/PARTICLE_PARAMETER_REFERENCE.md`, `docs/PARTICLE_RECIPES.md`,
+`docs/GPT_USAGE_GUIDE.md`, `docs/TROUBLESHOOTING.md`,
+`docs/LIVE_TESTING.md`, `docs/RELEASE_CHECKLIST.md`,
+`docs/PROJECT_TASK_LIST.md`,
+`docs/STATUS_REPORT_2026-07-23.md`, `docs/STATUS_UPDATE_2026-07-24.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE8.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE9.md`,
+`docs/STATUS_UPDATE_2026-07-26_PHASE10.md`,
+`docs/STATUS_UPDATE_2026-07-28_PHASE11.md`, the
+configuration in `configs/`, and the runnable
+scripts in `examples/`. Validate a scheme before running any network or scientific
+calculation:
+
+```console
+zju-scatt scheme configs/bulk_scheme.example.json
+zju-scatt scheme-sources configs/bulk_scheme.example.json \
+  --workspace zju_scatt_data
+zju-scatt psd-check configs/bulk_scheme.example.json
+zju-scatt bulk-opt validate configs/bulk_scheme.example.json
+zju-scatt bulk-opt plan configs/bulk_scheme.example.json --dry-run
+```
+
+Generate the authoritative machine-readable reference or start from a complete
+particle recipe:
+
+```console
+zju-scatt bulk-opt schema --json
+zju-scatt bulk-opt schema --particle-type super_spheroid_ice --json
+zju-scatt bulk-opt validate configs/recipes/ice_multi_temperature_bulk.json
+python examples/example_04_observed_psd_csv.py
+python examples/example_05_interpolation_modes.py
+python examples/example_16_phase11_release_readiness_validation.py
+```
+
+## Verification
+
+Native ARTS 2.x XML, CRTM CloudCoeff release-3 NetCDF/binary, and RTTOV13 HDF5
+exports are available through structured JSON templates. See
+[Native model formats](docs/NATIVE_MODEL_FORMATS.md) for the format assessment,
+required variables and normalization, supported versions, and reference checks.
+
+```console
+python -m pip install -e ".[native]"
+python examples/example_17_native_model_formats.py --output native_model_output
+```
+
+First install the package from the project root:
+
+```console
+python -m pip install -e .
+python -m unittest discover -s tests -v
+python -m zju_scatt_interface --help
+```
+
+Run only the CLI tests:
+
+```console
+python tests/test_cli.py
+```
+
+For a quick source-tree run without installation:
+
+```console
+PYTHONPATH=src python tests/test_cli.py
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+In Windows PowerShell, replace the inline assignment with:
+
+```powershell
+$env:PYTHONPATH = (Resolve-Path src).Path
+python tests\test_cli.py
+```

zju_scatt_interface-0.9.0/configs/bulk_scheme.all_profiles.example.json

@@ -0,0 +1,173 @@
+{
+  "schema_version": "1.0",
+  "name": "all_profile_parameter_reference",
+  "wavelength_unit": "um",
+  "wavelengths": [0.55],
+  "interpolation": "linear",
+  "particles": [
+    {
+      "name": "dust",
+      "particle_type": "super_spheroid",
+      "size_distribution": {
+        "size": [0.1, 0.3, 1.0, 3.0],
+        "dndr": [10.0, 40.0, 30.0, 5.0],
+        "size_unit": "um",
+        "size_definition": "volume_equivalent_sphere_radius"
+      },
+      "refractive_index": {
+        "mode": "fixed",
+        "real": 1.5,
+        "imaginary": 0.01
+      },
+      "shape_parameters": {
+        "roundness": {
+          "values": [2.0, 2.5],
+          "weights": [0.4, 0.6]
+        },
+        "aspect_ratio": 1.5
+      }
+    },
+    {
+      "name": "black_carbon",
+      "particle_type": "encapsulated_fractal_aggregates_black_carbon",
+      "size_distribution": {
+        "size": [0.03, 0.1, 0.3, 1.0],
+        "dndr": [20.0, 100.0, 40.0, 2.0],
+        "size_unit": "um",
+        "size_definition": "volume_equivalent_sphere_radius"
+      },
+      "refractive_index": {
+        "mode": "fixed",
+        "black_carbon": {
+          "real": 1.85,
+          "imaginary": 0.55
+        },
+        "hygroscopic": {
+          "real": 1.4,
+          "imaginary": 0.05
+        }
+      },
+      "shape_parameters": {
+        "df": {
+          "values": [1.8, 2.4],
+          "weights": [0.5, 0.5]
+        },
+        "vf": 0.2
+      }
+    },
+    {
+      "name": "sea_salt",
+      "particle_type": "coated_super_spheroid_seasalt",
+      "size_distribution": {
+        "size": [0.05, 0.2, 1.0, 5.0],
+        "dndr": [50.0, 100.0, 20.0, 1.0],
+        "size_definition": "maximum_dimension_radius"
+      },
+      "refractive_index": {
+        "mode": "database"
+      },
+      "shape_parameters": {
+        "relative_humidity": {
+          "values": [0.5, 0.8],
+          "weights": [0.3, 0.7]
+        },
+        "humidity_branch": "deliquescence"
+      }
+    },
+    {
+      "name": "ice",
+      "particle_type": "super_spheroid_ice",
+      "size_distribution": {
+        "size": [5.0, 10.0, 30.0, 100.0],
+        "dndr": [1.0, 10.0, 5.0, 0.5],
+        "size_definition": "volume_equivalent_sphere_radius"
+      },
+      "refractive_index": {
+        "mode": "database_temperature",
+        "temperature_k": 250.0
+      },
+      "shape_ensemble": [
+        {
+          "roundness": 2.0,
+          "aspect_ratio": 1.0,
+          "weight": 0.4
+        },
+        {
+          "roundness": 2.5,
+          "aspect_ratio": 1.5,
+          "weight": 0.6
+        }
+      ]
+    },
+    {
+      "name": "sulfate",
+      "particle_type": "sphere_sulfate",
+      "size_distribution": {
+        "size": [0.03, 0.1, 0.3, 1.0],
+        "dndr": [100.0, 500.0, 100.0, 5.0]
+      },
+      "refractive_index": {
+        "mode": "database"
+      },
+      "shape_parameters": {
+        "relative_humidity": 0.8
+      }
+    },
+    {
+      "name": "nitrate",
+      "particle_type": "sphere_nitrate",
+      "size_distribution": {
+        "size": [0.03, 0.1, 0.3, 1.0],
+        "dndr": [100.0, 500.0, 100.0, 5.0]
+      },
+      "refractive_index": {
+        "mode": "database"
+      },
+      "shape_parameters": {
+        "relative_humidity": 0.8
+      }
+    },
+    {
+      "name": "organic_carbon",
+      "particle_type": "sphere_organic_carbon",
+      "size_distribution": {
+        "size": [0.03, 0.1, 0.3, 1.0],
+        "dndr": [100.0, 500.0, 100.0, 5.0]
+      },
+      "refractive_index": {
+        "mode": "database"
+      },
+      "shape_parameters": {
+        "relative_humidity": 0.8
+      }
+    },
+    {
+      "name": "water_cloud",
+      "particle_type": "sphere_water_cloud",
+      "size_distribution": {
+        "size": [1.0, 3.0, 10.0, 30.0],
+        "dndr": [1.0, 10.0, 50.0, 5.0]
+      },
+      "refractive_index": {
+        "mode": "database"
+      }
+    }
+  ],
+  "calculation": {
+    "include_phase_matrix": true,
+    "scattering_angles_degrees": [0, 30, 60, 90, 120, 150, 180],
+    "truncation_policy": "truncate",
+    "check_convergence": true,
+    "convergence_tolerance": 0.05,
+    "strict_convergence": false,
+    "strict_qa": true
+  },
+  "output": {
+    "path": "outputs/all_profile_reference.h5",
+    "format": "hdf5",
+    "compression": true,
+    "compression_level": 4,
+    "chunk_wavelength": 32,
+    "atomic": true
+  }
+}