Quick Start

Get NMDC submission values in 3 steps

Step 1: Install

uv add biosample-enricher

Step 2: Get values

from biosample_enricher.environmental_metadata import get_environmental_metadata

result = get_environmental_metadata(
    lat=37.7749,   # San Francisco
    lon=-122.4194,
    slots=["annual_precpt", "annual_temp"]
)

print(result["values"])
# {'annual_precpt': 519.3, 'annual_temp': 14.1}

Step 3: Use in your NMDC submission

The values are already in the correct units and format for NMDC submission-schema.

Next Steps

Common Use Cases

Get climate data

result = get_environmental_metadata(
    lat=42.3601,
    lon=-71.0589,
    slots=["annual_precpt", "annual_temp"]
)

Get elevation

result = get_environmental_metadata(
    lat=40.7128,
    lon=-74.0060,
    slots=["elev"]
)

Mix multiple slot types

result = get_environmental_metadata(
    lat=46.7867,
    lon=-121.7365,
    slots=["annual_precpt", "annual_temp", "elev"]
)

Handle errors

try:
    result = get_environmental_metadata(
        lat=37.7749,
        lon=-122.4194,
        slots=["annual_precpt", "invalid_slot"]
    )
except ValueError as e:
    print(f"Error: {e}")
    # Error includes list of supported slots

Need Help?