manureshed0.1.2 package

Spatiotemporal Nutrient Balance Analysis Across Agricultural and Municipal Systems

load_user_wwtp

Load User WWTP Data

MANURESHED_CRS

Standard CRS for Manureshed Analysis

manureshed

manureshed: Manureshed Analysis with WWTP Integration

map_agricultural_classification

Create Agricultural Classification Map

map_wwtp_columns

Map WWTP Column Names to Standard Format

map_wwtp_influence

Create WWTP Influence Map

map_wwtp_points

Create WWTP Point Map

P2O5_TO_P

Conversion Factor: P2O5 to P

plot_absolute_changes

Create Absolute Change Plot

plot_before_after_comparison

Create Before/After Comparison Plot

plot_impact_ratios

Create Impact Ratio Plot

quick_analysis

Quick Analysis with Visualization

quick_check

Quick Data Check

quick_state_analysis

Quick State Analysis with Visualization

save_transition_matrix

Save Transition Probability Matrix

summarize_results

Print Summary of Analysis Results

test_osf_connection

Test OSF Connection

validate_columns

Validate Required Columns

view_cheatsheet

View Package Cheat Sheet

wwtp_aggregate_by_boundaries

Aggregate WWTP Data by Spatial Boundaries

wwtp_classify_sources

Classify WWTP Sources by Load Size

wwtp_clean_data

Clean WWTP Data

wwtp_filter_positive_loads

Filter WWTP Data for Positive Loads

agri_classify_nitrogen_custom

Classify Agricultural Nitrogen Status with Custom Efficiency Factor

agri_classify_nitrogen

Classify Agricultural Nitrogen Status

agri_classify_phosphorus_custom

Classify Agricultural Phosphorus Status with Custom Efficiency Factor

agri_classify_phosphorus

Classify Agricultural Phosphorus Status

agri_process_nugis

Process NuGIS Data for Manureshed Analysis

batch_analysis_enhanced

Enhanced Batch Analysis with Full Visualizations

batch_analysis_parallel

Batch Analysis with Parallel Processing

compare_regions

Compare Multiple Regions

integrate_wwtp_agricultural

Integrate WWTP Data with Agricultural Classifications (Updated)

KG_TO_TONS

Conversion Factor: Kilograms to US Tons

launch_dashboard

Launch Interactive Manureshed Dashboard

LBS_TO_KG

Conversion Factor: Pounds to Kilograms

LBS_TO_TONS

Conversion Factor: Pounds to US Tons

list_available_years

List Available Built-in Years

list_regions

List Available Regions

load_builtin_boundaries

Load Built-in Spatial Boundaries from OSF

load_builtin_nugis

Load Built-in NuGIS Data from OSF

load_builtin_wwtp

Load Built-in WWTP Data from OSF

load_texas_huc8_boundaries

Load Texas HUC8 Boundaries from OSF

load_texas_huc8_data

Load Texas HUC8 Data from OSF

compare_analyses

Compare Two Analysis Results

create_regional_summary

Create Regional Summary

create_stacked_area_plot

Create Stacked Area Plot

create_year_comparison_plots

Create Year-over-Year Comparison Plots

create_yoy_change_plot

Create Year-over-Year Change Plot

get_cropland_threshold

Get Cropland Threshold by Scale

get_nutrient_colors

Default Color Schemes for Nutrient Classifications

get_region_definitions

Get Built-in Region Definitions

get_state_boundaries

Get State Boundaries for Mapping

get_state_fips

Get State FIPS Code

health_check

Check Package Health and Dependencies

integrate_complete

Complete Integration Pipeline (Updated)

add_centroid_coordinates

Add Centroid Coordinates to Spatial Data

add_texas_huc8

Add Texas HUC8 Data (Updated for OSF)

agri_classify_complete_custom

Complete Agricultural Classification Pipeline with Custom Efficiency F...

agri_classify_complete

Complete Agricultural Classification Pipeline

batch_analysis_years

Batch Analysis Across Multiple Years

benchmark_analysis

Benchmark Analysis Performance

calculate_cropland_threshold

Calculate Cropland Threshold for Exclusion

calculate_transition_probabilities

Calculate Spatial Transition Probabilities

check_builtin_data

Check Data Availability from OSF

citation_info

Display Package Citation Information

clean_category_names

Clean Category Names for Display

clean_text

Clean Text Data

clear_data_cache

Clear Data Cache

compare_scenarios

Compare Multiple Analysis Scenarios

CONUS_STATES

CONUS States

convert_load_units

Convert Load Units to Tons

create_analysis_report

Create Analysis Report

create_batch_summary_report

Create Batch Summary Report

create_classification_summary

Create Classification Summary Table

create_classification_trend_plot

Create Classification Trend Plot

create_comparison_plots

Create Comparison Plots

create_comparison_summary

Create Comparison Summary Statistics

create_comprehensive_comparisons

Create Comprehensive Batch Comparisons

create_network_plot

Create Network Plot from Transition Probabilities

create_regional_plots

Create Regional Comparison Plots

data_sources

NuGIS and EPA WWTP Data Sources

dot-onAttach

Package Startup Message for OSF Data Approach

dot-package_info

Package Version and Build Information

download_all_data

Download All Datasets from OSF

download_osf_data

Download and Cache Data from OSF

export_for_gis

Export Results for GIS Applications

export_for_policy

Export for Policy Briefs

export_for_publication

Export for Publication

extract_scenario_metrics

Extract Metrics from Analysis Results

extract_trend_data

Extract Trend Data from Batch Results

filter_by_state

Filter Data by State

format_huc8

Format HUC8 Codes

generate_report_content

Generate Report Content

run_builtin_analysis

Complete Manureshed Analysis Workflow (Built-in Data)

run_state_analysis

Run State-Level Analysis

save_analysis_summary

Save Analysis Summary

save_centroid_data

Save Centroid Data

save_plot

Save Plot

save_spatial_data

Save Spatial Data

wwtp_process_complete

Complete WWTP Processing Pipeline

wwtp_to_spatial

Convert WWTP Data to Spatial Format

A comprehensive framework for analyzing agricultural nutrient balances across multiple spatial scales (county, 'HUC8', 'HUC2') with integration of wastewater treatment plant ('WWTP') effluent loads for both nitrogen and phosphorus. Supports classification of spatial units as nutrient sources, sinks, or balanced areas based on agricultural surplus and deficit calculations. Includes visualization tools, spatial transition probability analysis, and nutrient flow network mapping. Built-in datasets include agricultural nutrient balance data from the Nutrient Use Geographic Information System ('NuGIS'; The Fertilizer Institute and Plant Nutrition Canada, 1987-2016) <https://nugis.tfi.org/tabular_data/> and U.S. Environmental Protection Agency ('EPA') wastewater discharge data from the 'ECHO' Discharge Monitoring Report ('DMR') Loading Tool (2007-2016) <https://echo.epa.gov/trends/loading-tool/water-pollution-search>. Data are downloaded on demand from the Open Science Framework ('OSF') repository to minimize package size while maintaining full functionality. The integrated 'manureshed' framework methodology is described in Akanbi et al. (2025) <doi:10.1016/j.resconrec.2025.108697>. Designed for nutrient management planning, environmental analysis, and circular economy research at watershed/administrative to national scales. This material is based upon financial support by the National Science Foundation, EEC Division of Engineering Education and Centers, NSF Engineering Research Center for Advancing Sustainable and Distributed Fertilizer Production (CASFER), NSF 20-553 Gen-4 Engineering Research Centers award 2133576. We thank Dr. Robert D. Sabo (U.S. Environmental Protection Agency) for his valuable contributions to the conceptual development and review of this work.

  • Maintainer: Olatunde D. Akanbi
  • License: MIT + file LICENSE
  • Last published: 2026-01-28