ECOSYS

ECOSYS calculates time-dependent radionuclide concentrations and potential human radiation doses following one or more dated deposition events. The Python implementation builds on ECOSYS-87 and subsequent extensions in ECOSYS for Excel. It represents deposition, soil and plant transfer, animal products, food processing and storage, inhalation and external irradiation.

Local time-integrated air concentration, wet deposition and rainfall prescribe the atmospheric input. Seasonal parameter sets and age-dependent behaviour determine the subsequent transfer and exposure. Results include per-event and superposed concentrations, per-capita dose in Sv and collective dose in person-Sv under the specified environmental and food-supply conditions.

The engine reads packaged SQLite parameter data. Inputs and outputs carry Astropy units; the bundled Excel workbooks are used only for parameter export.

Install

From a checkout of this repository:

python -m pip install .

Python 3.9 or newer is required. Installation supplies astropy, numpy and xlrd. For an editable development checkout and the test dependencies, use python -m pip install -e ".[dev]".

Start Here

• Scalar dose introduces EcosysEngine, validated request records, and the complete result tree.
• Multiple events shows event superposition within one request.
• Time support and reports explains integration nodes, interval doses and report selection.
• Raster inputs and chunking cover spatial execution.
• Population cohorts demonstrates explicit cohort inputs.
• Nuclides and dry/wet deposition compares isotope time histories, deposition routes, and rainfall sensitivity.
• API guide documents units, shapes, outputs, errors, and parameter-set selection.
• Parameter sets lists the three packaged regional parameter sets.
• Validation evidence describes verification tests, original-model comparisons and their limits.
• Scientific decisions is the register of approved and open modelling choices.
• Development history records how the engine was built and validated.

Model reference and scope

The LaTeX model reference specifies the equations, assumptions and numerical methods; the accompanying chapter sources are maintained in docs/model-reference/ in the repository. Individual nuclides undergo radioactive decay, without daughter ingrowth. Cloud external exposure is opt-in, and skin contamination is treated as a separate tissue-dose calculation.

Original-model reference runs cover the valley parameter set. Mountain and Ticino/Valais have no corresponding reference runs, and no comparison with environmental measurements is available. The verification tests establish specified numerical behaviour within their tested scenarios.