pyFIA

The Python API for forest inventory data

A high-performance Python library for analyzing USDA Forest Inventory and Analysis (FIA) data. Built on DuckDB and Polars for speed, with statistical methods that match EVALIDator exactly.

Why pyFIA?

Feature	pyFIA	EVALIDator
Speed	10-100x faster	Baseline
Interface	Python API	Web UI
Reproducibility	Code-based	Manual
Custom analysis	Unlimited	Limited options
Statistical validity	✓ Exact match	✓ Reference

Quick Start

pip install pyfia

from pyfia import FIA, tpa, volume, area

with FIA("path/to/FIA_database.duckdb") as db:
    db.clip_by_state(37)  # North Carolina
    db.clip_most_recent(eval_type="VOL")

    # Core estimates
    trees = tpa(db, tree_domain="STATUSCD == 1")
    timber = volume(db, land_type="timber")
    forest = area(db, land_type="forest")

Core Functions

Function	Description	Example
`tpa()`	Trees per acre	`tpa(db, tree_domain="DIA >= 5.0")`
`biomass()`	Above/belowground biomass	`biomass(db, by_species=True)`
`volume()`	Merchantable volume (ft³)	`volume(db, land_type="timber")`
`area()`	Forest land area	`area(db, grp_by="FORTYPCD")`
`site_index()`	Site productivity index	`site_index(db, grp_by="COUNTYCD")`
`mortality()`	Annual mortality rates	`mortality(db)`
`growth()`	Net growth estimation	`growth(db)`

Statistical Methods

pyFIA implements design-based estimation following Bechtold & Patterson (2005):

Post-stratified estimation with proper variance calculation
Ratio-of-means estimators for per-acre values
EVALID-based filtering for statistically valid estimates
Temporal methods: TI, annual, SMA, LMA, EMA

Installation

# Recommended: use uv for fast, reliable installs
uv pip install pyfia

# Or with pip
pip install pyfia

# With spatial support (polygon clipping, spatial joins)
uv pip install pyfia[spatial]

Tip: Always use a virtual environment (uv venv or python -m venv .venv).

For development setup, see the Getting Started guide.

Documentation

Full documentation: pyfia.mintlify.app

Citation

@software{pyfia2025,
  title = {pyFIA: A Python Library for Forest Inventory Applications},
  author = {Mihiar, Christopher},
  year = {2025},
  url = {https://github.com/mihiarc/pyfia}
}

Affiliation

Developed in collaboration with USDA Forest Service Research & Development. pyFIA provides programmatic access to Forest Inventory and Analysis (FIA) data but is not part of the official FIA Program.

_{Built by Chris Mihiar}

Metadata

Release files for pyfia 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyfia 1.7.0
File	Size	Uploaded
pyfia-1.7.0.tar.gz	343.8 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyfia 1.7.0
File	Interpreter	ABI	Platform	Reset
pyfia-1.7.0-py3-none-any.whl 393.9 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 737.7 kB

Release files / pyfia-1.7.0.tar.gz

Download URL	pyfia-1.7.0.tar.gz
Size	343.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`5ababbfd90c99b68e4302cbd746c8390d839a88e0bb2b23ccf7bbe03900f9f9e`
BLAKE2b-256 checksum How to use checksums	`8ff766af6e385a9127f48240a8468602940bbefdbd918b17b9fac46d5ba4017d`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mihiarc/pyfia
Publishing commit: github.com/mihiarc/pyfia/tree/023427817c0e8097b539f639bd631a08b61bdf35

Workflow

Publishing configuration: github.com/mihiarc/pyfia/blob/023427817c0e8097b539f639bd631a08b61bdf35/.github/workflows/publish.yml
Publishing logs: github.com/mihiarc/pyfia/actions/runs/36566174299/attempts/1

Artifact

Subject: pyfia-1.7.0.tar.gz
SHA-256 checksum: 5ababbfd90c99b68e4302cbd746c8390d839a88e0bb2b23ccf7bbe03900f9f9e Verifying attestations

Release files / pyfia-1.7.0-py3-none-any.whl

Download URL	pyfia-1.7.0-py3-none-any.whl
Size	393.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`04677c0f070de5809fe1b850875cb5307c309d91f94b08266fa22504f2fbf10c`
BLAKE2b-256 checksum How to use checksums	`23ca8bc8e8c82d11eedd18eda475f9914ebe28f881675287611b360d5d6d9b86`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mihiarc/pyfia
Publishing commit: github.com/mihiarc/pyfia/tree/023427817c0e8097b539f639bd631a08b61bdf35

Workflow

Publishing configuration: github.com/mihiarc/pyfia/blob/023427817c0e8097b539f639bd631a08b61bdf35/.github/workflows/publish.yml
Publishing logs: github.com/mihiarc/pyfia/actions/runs/36566174299/attempts/1

Artifact

Subject: pyfia-1.7.0-py3-none-any.whl
SHA-256 checksum: 04677c0f070de5809fe1b850875cb5307c309d91f94b08266fa22504f2fbf10c Verifying attestations