us_bioenergy_statistics
Get ERS U.S. Bioenergy Statistics - ethanol, biodiesel, and renewable diesel supply, use, capacity, consumption, and prices, each pivoted to a wide layout by period.
Examples
from openbb import obb
obb.usda.us_bioenergy_statistics(provider='usda')
# Get fuel ethanol supply and disappearance by calendar year since 2015.
obb.usda.us_bioenergy_statistics(table='ethanol_supply_calendar_year', start_year=2015, provider='usda')
# Get fuel ethanol production capacity by State.
obb.usda.us_bioenergy_statistics(table='ethanol_capacity_by_state', provider='usda')
Parameters
- standard
- usda
table: str | None
Default: ethanol_supply_marketing_year
Description
Bioenergy-statistics table to retrieve. Each table is a set of named supply, use, capacity, or price series indexed by year and period; the series become the wide value columns while a single period column, with any varying location folded in, stays as the pinned row column. Valid tables are:
ethanol_supply_marketing_year, ethanol_supply_calendar_year, ethanol_supply_monthly, biodiesel_supply_marketing_year, biodiesel_supply_calendar_year, renewable_diesel_supply_marketing_year, renewable_diesel_supply_calendar_year, corn_supply_and_ethanol_share, soybean_oil_supply_and_biofuel_share, oils_and_fats_supply_and_prices, distillers_grains_supply, corn_gluten_meal_supply, corn_gluten_feed_supply, distillers_dried_grains_price, ethanol_capacity_and_utilization, ethanol_capacity_by_state, biodiesel_renewable_diesel_plants_by_state, alternative_fuel_stations, corn_ethanol_gasoline_prices_monthly, ethanol_gasoline_consumption_and_share, biodiesel_and_diesel_prices, retail_diesel_prices_monthly
start_year: int | None
Start year for filtering the data, compared against the observation year. If None, returns from the beginning of the series.
end_year: int | None
End year for filtering the data, compared against the observation year. If None, returns up to the most recent year.
Returns
results: UsBioenergyStatistics
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- usda
period: str
Row label of the observation: the year for annual tables ('2020'), the year and month or quarter for sub-annual tables ('2020 Jan', '2020 Q1 Sep-Nov'), with any varying State or market city folded in so each row is uniquely labeled ('Texas — 2025').