A Python wrapper for the HOLOS 4.0 CLI - enabling estimations of Canadian agricultural greenhouse gas emissions.
PyHolos provides a Python interface to the HOLOS CLI, allowing you to:
- Launch HOLOS simulations from Python scripts
- Model farm systems with minimal input data (PyHolos estimates missing parameters)
- Generate structured input files for the HOLOS CLI
- Process and visualize simulation results
- Farm Modeling: Support for livestock (beef, dairy, sheep) and land management systems (crops, carbon sequestration)
- Data Integration: Automatic integration with Soil Landscapes of Canada (SLC) data
- Flexible Input: Work with JSON configurations or pre-structured farm data
- Post-processing: Built-in tools for analyzing and plotting simulation results
- Python >= 3.12
- Dependencies:
geojson,shapely,pandas,pydantic
For detailed installation instructions including prerequisites (Git, conda, PyCharm setup), see the documentation.
from pathlib import Path
from pyholos import launching
# Launch HOLOS using a JSON farm configuration
launching.launch_holos(
path_dir_farms=Path('path/to/farm_data'),
name_farm_json='farm.json',
path_dir_outputs=Path('path/to/outputs'),
id_slc_polygon=851003
)See the examples directory for more usage patterns.
Full documentation is available in the documentation directory. Build it locally using Sphinx or refer to individual .rst files for:
This project is licensed under the terms specified in LICENSE.
Contributions are welcome! Please submit issues and pull requests via the GitHub repository.
For questions or issues, please open an issue on the issue tracker.