global_food_assessment
Get ERS Global Food Assessment - grain food demand, other demand, total demand, production, and the implied additional supply required to close the food gap, pivoted to a wide layout with the subregions as columns and the base year and ten-year projection horizon as rows.
Examples
from openbb import obb
obb.usda.global_food_assessment(provider='usda')
# Get the implied additional grain supply required across Sub-Saharan Africa's subregions.
obb.usda.global_food_assessment(element='Implied additional supply required', region='Sub-Saharan Africa', provider='usda')
# Get grain production for the Middle East and North Africa.
obb.usda.global_food_assessment(element='Grain production', region='Middle East and North Africa', provider='usda')
Parameters
- standard
- usda
element: str | None
Default: Total grain demand
Description
Measure to retrieve. The measure selects one series whose subregions spread into the wide columns while the base year and the ten-year projection horizon stay in the rows. Valid measures are:
Food grain demand, Other grain demand, Grain production, Implied additional supply required, Total grain demand
region: str | None
Description
Filter to a single region's subregions, e.g. 'Sub-Saharan Africa'. If None, every subregion is spread into the columns. Valid regions are:
Asia, Former Soviet Union, Latin America and the Caribbean, Middle East and North Africa, Sub-Saharan Africa, GFA countries
start_year: int | None
Start year for filtering the data, compared against the observation year. If None, returns from the base year.
end_year: int | None
End year for filtering the data, compared against the observation year. If None, returns through the projection horizon.
Returns
results: GlobalFoodAssessment
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
year: str
Year of the observation: the base year or the ten-year projection horizon, e.g. '2025' or '2035'.
element: str | None
Measure spread into the subregion columns, as published.
unit: str | None
Unit shared by every value column for the selection, as published in the source value-column header: 'Millions of metric tons'.