The Secondary Price Index Domain

You can filter the available data series using one or more of the following criteria:

• Period: Filters by the collection/reporting period.

  • Start date:

  • End date:

• Geographic*: Filters by country.

*You can search using any of the above criteria marked with an asterisk. You can also search, but not filter, by:

• Data Source Document: The name of the document used as the primary source of information or data.

• Data Source Organization: The name of the organization that provided the data source document.

• Data Series: The name of a particular data series.

Once you have applied your search terms and filters, you will be presented with a list of all available data series that match your criteria. A data series is a collection of related data points from a single data source that are viewable as a single row within a table of data. They represent the change over time of a specific indicator. Data series are presented in table format where each row represents a single data series.

The SPI domain data selection table includes the following columns:

• Name:

• Country: Country where the exchange rate was observed.

• Data source organization: The name of the organization that provided the data source document.

• Data source document: The name of the document used as the primary source of information or data.

• First: Period date for the first collection/reporting period in the data series.

• Last: Period date for the last collection/reporting period in the data series.

• Count: The number of data points in the data series.

In addition to selecting data series, you can interact with the data selection table in the following ways:

• Selected data series can be viewed in the Selected tab.

• You can clear your selections using the Clear Selected button.

• By default the series are ordered alphabetically by country. You can click on the header of any column to sort by that column instead of by country.

Options within the Exchange Rate domain allow for aggregation or conversion of the trade data into reporting schedules and units of measures specified by the user. The available parameters are:

• Reporting schedule: Specifies the intervals that the search result data is displayed. The available intervals include daily, weekly, monthly, quarterly, annual.

Chart

The Chart tab in the SPI domain displays a line graph where each data series is represented by a line of a different color. The chart plots the value of the price index (y-axis) against time (x-axis).

You can interact with the chart in the following ways:

• Hover over a line to see more details including period and quantity.

• Single click on a legend item to exclude it from the graph.

• Double click on a legend item to display only its trace.

• Use your mouse to draw a box around any part of the graph, or move the sliders in the timeline bar below the graph, to zoom in.

• Double click on the graph background to return it into the initial zoom state.

• Click the pan icon in the top right to enable panning functionality. This will allow you to use your mouse to drag the graph left or right.

• Click the autoscale icon in the top right to have the graph automatically select to the best period to display.

• Click the camera icon in the top right to download the chart as a .png file.

The Table tab for the SPI domain is organized by each column representing a reporting country. The rows provide the following metadata:

• fewsnet_region: Grouping of countries or regions based on the FEWS NET regional Classifications. They are similar to the UN M49 Groups but they use the M49 code values between 900 and 999.

• geographic_group: Grouping of countries or regions based on the United Nations Standard Country or Area Codes for Statistical (UN M49) Classifications.

• country: Represents the national, dependent territory, or special area of geographical interest level administrative unit, standardized to ISO 3166 naming.

• country_code: The ISO 3166-1 alpha-2 two letter code for a country.

• geographic_unit: A geographic area or point such as a portion of a country or other region delineated for a specific purpose, such as an Administrative Unit (Province, District, County, etc.), Livelihood Zone, or Market.

• index_name:

• admin_1: Represents the first level administrative units.

• admin_2: Represents the second level administrative units.

• base_period_start:

• base_period_end:

• base_value:

• start_date: The start date of a collection period. For monthly data, this is the first day of the month of the reporting period. For example, data from January 2021 have a start_date of January 1, 2021.

• period_date: The last day of the collection period. For monthly data, this is the last day of the month of the reporting period. For example, data from January 2021 have a period date of January 31, 2021.

• value: The value of the data point during the reporting period.

• source_organization: The organization that provided the source document.

• source_document: The document used as the primary source of information or data.

• dataseries_name: The name of a data series derived from the full set of metadata added at the time of creation.

• value_one_month_ago: The mean averaged value of the price of the product in the prior calendar month.

• value_one_year_ago: The mean averaged value of the price of the product for the calendar month one year ago.

• value_two_years_ago: The value of the price of the product two years ago.

• value_three_years_ago: The value of the price of the product three years ago.

• value_four_years_ago: The value of the price of the product four years ago.

• value_five_years_ago: The value of the price of the product five years ago.

• value_one_year_ahead: A value forecast one year from the current period.

• two_year_average: The average price during the reporting period from the previous two years.

• five_year_average: The average price during the reporting period from the previous five years.

• pct_change_from_one_month_ago: The percentage change in value between the current value and the value_one_month_ago.

• pct_change_from_one_year_ago: The percentage change in value between the current value and the value_one_year_ago.

• description: Any extra information or detail that is relevant to the object. In the case of a source document, it can contain more information about the datasource including the name of document in the native language of the country the source document belongs to.

• geographic_unit_id:

• id: Unique identifier assigned by the system.

• datacollectionperiod: A specific period for which Data Points are collected as specified by a datasource document. For example, if the Data Source Document specifies that its data is collected Monthly then we may have Data Collection Periods for Jan 2013, Feb 2013, Mar 2013, etc. All the data points for a Collection Period must be part of the same data collection.

• datacollection: A collection of data points for a single source document. A Data Collection can contain data points for more than one data collection period.

• datasourcedocument: The document used as the primary source of information or data.

• datasourceorganization: The unique numeric id of the organization that provided the data source document.

• dataseries: The internal id for a Data Series.

• dataseries_specialization_type: Shows which data domain/classification a data series belongs to. For example, Market Product.

• specialization_type: Shows which data domain/classification a record belongs to.

• data_usage_policy:

• created: The date of the creation of the datapoint, specified in YYYY-MM-DD format.

• modified: Date the datapoint was last modified, specified in YYYY-MM-DD format.

• status: The status of a data point value (i.e., Collected, Not Collected, Not Available, Missing Historic Data, Calculated, and Interpolated) for a specific collection period.

• status_changed: Date the status was last changed, specified in YYYY-MM-DD format.

• collection_status_changed: Date the collection status was last changed or modified, specified in YYYY-MM-DD format.

• collection_schedule: The frequency of the data collections (e.g., monthly or weekly).

• collection_status: The status of a data collection (i.e., Draft, Submitted, Under Review or Published).

The Export tab includes the following options:

• Download as: Provides a download of a static dataset. This will export only the data series that you have selected. Downloads are available in the following formats:

  • Flat format CSV

• Refreshable link: Connects directly to the FEWS NET Data Warehouse database server, allowing Excel, your browser, or another application to automatically fetch data from the server whenever the link is accessed. Refreshable links are available in the following formats:

  • Flat CSV

  • Flat HTML

  • JSON

  • XML