Metadata-Version: 2.4
Name: treemun-sim
Version: 1.0.0
Summary: Simulador de crecimiento y rendimiento forestal para evaluar políticas de manejo en la gestión de plantaciones
Home-page: https://github.com/fulloaf/treemun
Author: Felipe Ulloa-Fierro
Author-email: felipe.ulloa@utalca.cl
Project-URL: Bug Reports, https://github.com/fulloaf/treemun/issues
Project-URL: Source, https://github.com/fulloaf/treemun
Keywords: plantation forest,simulation,biomass growth,management policies
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.19.0
Requires-Dist: pandas>=1.2.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# treemun: a growth and yield simulator for chilean plantation forest

A Python package that implements a discrete-time simulation framework for evaluating management policies in Pinus radiata and Eucalyptus globulus forest stands.

## install

```bash
pip install treemun-sim
```

## basic use

```python
import treemun_sim as tm

# simulation with default parameters
bosque, resumen, biomasa_final, biomasa_estimada = tm.simular_bosque()

# custom simulation
bosque, resumen, biomasa_final, biomasa_estimada = tm.simular_bosque(
    policies_pino=[(9, 18), (10, 20), (11, 22)],
    policies_eucalyptus=[(9,), (10,), (11,)],
    horizonte=25,
    num_rodales=50,
    semilla=1234
)

print(f"Se generaron {len(bosque)} combinaciones rodal-política")
```

## parameters

- **policies_pino**: Lista de políticas para pino `[(edad_raleo, edad_cosecha), ...]`
- **policies_eucalyptus**: Lista de políticas para eucalipto `[(edad_cosecha,), ...]`
- **horizonte**: Horizonte temporal en años (default: 30)
- **num_rodales**: Número de rodales a generar (default: 100)
- **semilla**: Semilla para reproducibilidad (default: 5555)

## outputs

- **bosque**: Lista de DataFrames con simulación período a período
- **resumen**: Lista de diccionarios con información de cada rodal
- **biomasa_final**: Diccionario con biomasa al final del horizonte
- **biomasa_estimada**: Diccionario optimizado para algoritmos de optimización

## supported species

- **Pinus**: Con políticas de raleo y cosecha
- **Eucalyptus**: Con políticas de cosecha únicamente

## author

Felipe Ulloa-Fierro

## license

MIT



