Skip to main content
License: Apache-2.0 Documentation PyPI version Total PyPI downloads Read Publication Ask Teams APSIM Next Generation version Run APSIM simulation

apsimNGpy: The Next Generation Agroe-cosystem Simulation Library

apsimNGpy is an open-source framework for advanced agroecosystem modeling, built entirely in Python. It enables object-oriented, data-driven workflows for interacting with APSIM Next Generation models, offering capabilities for:

  • Batch file simulation and model evaluation

  • APSIMX file editing and parameter inspection

  • Weather data retrieval and pre-processing

  • Optimization and performance diagnostics

  • Efficient soil profile development and validation

  • Parameter sensitivity analysis

Python serves as the execution environment, integrating scientific computing, data analysis, and automation for sustainable agricultural systems.

Requirements

  1. .NET SDK — install from https://learn.microsoft.com/en-us/dotnet/core/install/

  2. Python 3.10+

  3. APSIM Next Generation — ensure the directory containing Models.exe is added to your system PATH.

  4. (Optional) Use the official APSIM installer for easiest setup.

  5. Minimum 8 GB RAM recommended.

Installation

## Run APSIM in Python

Option 1 – Install from PyPI (stable)

pip install apsimNGpy

If using the uv virtual environment manager:

uv pip install apsimNGpy

Option 2 – Clone the development repository

git clone https://github.com/MAGALA-RICHARD/apsimNGpy.git
cd apsimNGpy
pip install .

Option 3 – Install directly from GitHub

pip install git+https://github.com/MAGALA-RICHARD/apsimNGpy.git

APSIM Next Generation (NG) Installation Tip

Use the pinned APSIM release indicated on the documentation homepage to avoid forward-compatibility issues. The pinned version represents the latest APSIM NG build verified against apsimNGpy’s API and unit tests.

Download files

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

Source Distribution

apsimngpy-1.5.6.tar.gz (12.9 MB view details)

Uploaded Source

Built Distribution

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

apsimngpy-1.5.6-py3-none-any.whl (9.6 MB view details)

Uploaded Python 3

File details

Details for the file apsimngpy-1.5.6.tar.gz.

File metadata

  • Download URL: apsimngpy-1.5.6.tar.gz
  • Upload date:
  • Size: 12.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for apsimngpy-1.5.6.tar.gz
Algorithm Hash digest
SHA256 8dc7fdbf02d4580a5794f7dbaff2cefa4e258c176baf58cc6c8ffa296b79d2dd
MD5 12bf3dba859530b4232ef6f0fd47e572
BLAKE2b-256 3e875bfea75bdb0a98ee8a000f6612d8ef0a224df29543521a86d232cf223d72

See more details on using hashes here.

File details

Details for the file apsimngpy-1.5.6-py3-none-any.whl.

File metadata

  • Download URL: apsimngpy-1.5.6-py3-none-any.whl
  • Upload date:
  • Size: 9.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for apsimngpy-1.5.6-py3-none-any.whl
Algorithm Hash digest
SHA256 dc4dcf0de8082c10132461212d47aebaf2a36d74681c61fe3799f7d5eeb3d956
MD5 f76e1184378f30b55636c1047befa430
BLAKE2b-256 17035aa22450c0615d424fa3a648f74f0fec24c116990d0cc3055388feb7d1c2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.5.6

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page