Install & Compatibility
Where this runs
tested against v? · pip install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CropConditionModel
✓ from geocif.models import CropConditionModel
✗ from geocif.crop_condition import CropConditionModel
Older internal module path; models are now under geocif.models
fetch_agdata
✓ from geocif.data import fetch_agdata
✗ import fetch_agdata
Direct import of function without module path fails
Loads agriculture data and runs a crop condition prediction model.
from geocif.models import CropConditionModel
from geocif.data import fetch_agdata
import os
# Optionally set API key via environment variable
api_key = os.environ.get('GEOCIF_API_KEY', '')
# Fetch sample data
data = fetch_agdata(region='us', year=2023, api_key=api_key if api_key else None)
# Initialize and run model
model = CropConditionModel()
result = model.predict(data)
print(result.head())
Debug
Known issues
breakingIn version 0.4.0, the API for data fetching changed: fetch_agdata now requires explicit region and year parameters; older calls with only 'region' as positional argument fail.fixUpdate calls to include both region and year as keyword arguments, e.g., fetch_agdata(region='us', year=2023).
affects: >=0.4.0
deprecatedThe function 'geocif.utils.plot_conditions' was deprecated in 0.4.500 and will be removed in 0.5.0. Use 'geocif.visualization.plot' instead.fixReplace with from geocif.visualization import plot; plot(model_results).
affects: >=0.4.500,<0.5.0
gotchaGeoCIF requires Python >=3.11; installing on Python 3.10 will fail with cryptic distutils errors.fixEnsure you are using Python 3.11 or later.
affects: all
Upgrade
Version history
0.4.742latest on PyPI · released Jun 17, 2026
Audit
Dependencies
geopandasrequiredSpatial data handling required for crop condition models
rasteriorequiredRaster data I/O for yield forecast data
numpyrequiredNumerical operations
matplotliboptionalVisualization of crop condition maps