Data Series Management

The Data Series Management module provides a collection of navigation and editing features for the management of all data series and data points stored within the FEWS NET Data Warehouse.

The module ties into other modules, such as Data Entry and Metadata Management, to perform the following operations within a single module:

• Data Series operations

  • Browse published and unpublished Data Series by Data Domain category

  • Chart Data Series

  • Add new Data Series

  • Edit existing Data Series

  • Delete unpublished Data Series

  • Download Data Series

  • View Data Series audit history

• Data Point operations

  • Browse Data Points

  • Add new Data Points

  • Edit existing Data Points

  • Delete unpublished Data Points

  • View Data Point audit history

Only users with the appropriate administrative rights can perform the operations outlined above. To review data viewing and editing permissions, visit Categorization and Permissions.

Data Series operations

Browsing Data Series

Data Series are organized into categories corresponding to specific Data Domains, which are reflected in the dropdown menu (e.g., Data Series Management > Price > Exchange Rates).

Once a Data Series category is selected, the corresponding Data Series are visible in a table format.

The table's column headers, filters, and organization are dynamic based on the data series selected. For example, the first column header for Acute Food Insecurity Classification data series is titled Geographic Unit versus Reporting Country for Trade data series.

Adding new Data Series

To add a new Data Series:

1. Click Add from the Data Series table view. The system will then display the add Data Series page.

2. Complete the fields within the add Data Series page.

3. Select one of the Save prompts. A confirmation message will appear when complete.

To add a new Data Series, the necessary metadata must exist within the FEWS NET Data Warehouse system. If the required metadata does not exist, it must be added using the Metadata Management module.

For each data series category, there are unique metadata requirements:

Data Series Requirements by Domain

Each Data Source Document has a Document Type which specifies the Domain the data is in. At minimum, Data Series within a given Data Source Document consist of an Indicator, Geographic Unit, and Source Document, but can also contain other metadata as described below.

Exchange Rates

To add a new exchange rate Data Series, the following information is required:

• From currency

• To currency

• Rate type:

  • Interbank: the monthly averages from OANDA

  • Government: For example, official fixed exchange rates

  • Secondary: For example, unofficial exchange rates

Add any new currency types as metadata through the Metadata Management > Common > Currency page.

Market Products

To add a new market products Data Series, the following information is required:

• Market

• Product

• Unit

• Currency

• Price Type

• Product Source

Add any new products as metadata through the Metadata Management > Common > Classified Products page.

Price Index

To add a new price index Data Series, the following information is required:

• Name

• Base value

Trade Flow Quantities

To add a new trade flow quantity Data Series, the following information is required:

• Reporting Country

• Border Point

• Source

• Destination

• Product

• Unit

• Flow Type:

  • Export

  • Import

  • Re-export

• Documentation Type

  • Formal: Level of documentation is fully documented

  • Informal: Level of documentation is not fully documented

Acute Food Insecurity Phases

To add a new acute food insecurity phase Data Series, the following information is required:

• Scale

• Scenario

Acutely Food Insecure Population Estimates

To add a new acutely food insecure population estimate Data Series, the following information is required:

• Scale

• Scenario

Humanitarian Food Assistance

To add a new humanitarian food assistance Data Series, the following information is required:

• Scale

• Scenario

Humanitarian Response

To add a new humanitarian response Data Series, the following information is required:

• Operator

• Operation type

Crop Production Estimate

Adding crop production indicator Data Series is done through automated import into the system via the import functionality page. To access the import functionality page, navigate to: Data Entry > Import Data Points > Import Crop Production Estimate Values.

Crop Yield Forecast

Crop yield forecast indicator Data Series are added through automated import into the system via the import functionality page. To access the import functionality page, navigate to: Data Series Management > Data Points > Crop Yield Forecast Values > Import Crop Yield Forecast Values.

Nutrition Indicator

Nutrition indicator Data Series are added through automated import into the system via the import functionality page. To access the import functionality page, navigate to: Data Entry > Import Data Points > Import Nutrition Indicator Values.

Population Estimate and Census

Population indicator Data Series are added through automated import into the system via the import functionality page. To access the import functionality page, navigate to: Data Entry > Import Data Points > Import Population Estimate and Census Values.

Semi-Structured

Requirements beyond the Source Document, Geographic Unit, and Indicator may vary based on the Document Type.

Commodity Balance

To add a new commodity balance Data Series, the following information is required:

• Product

• Unit

Charting data series

Several Data Series categories include options to display the Data Points as a time series chart. To view a Data Series chart:

1. Click the hyperlinked text of the desired Data Series from the table view to navigate to the Data Series information page.

2. Select the Chart button.

3. The system will display a Data Series chart page. You can interact with the chart in the following ways:

   1. Hover over a point in the chart to view Data Point values.

   2. Adjust the start and end dates using the zoom options, the From and To date fields, or the time slider at the bottom.

   3. Print or download the chart using the options from the button to the right of the From and To date fields.

Editing Data Series

To edit a given Data Series:

1. Click the hyperlinked text of the desired Data Series from the table view to navigate to the Data Series information page.

2. Modify the information with the fields as needed.

3. Select one of the Save options at the bottom of the page. A success message will display if the edits have been applied.

Deleting Data Series

If necessary, unpublished Data Series can be deleted. This functionality is not available for published Data Series. To delete Data Series, follow the steps below:

1. Using the Checkboxes, select the desired Data Series from the Data Series table view. Multiple Data Series can be selected at once.

2. From the Action drop-down list, select the option to Delete selected Data Series. Confirm the selection by clicking, Go. This will open a summary page.

3. From the summary page, confirm the intent to delete the selected Data Series.

Deleted Data Series cannot be recovered.

Downloading Data Series

Data series can be downloaded in CSV format. To download a Data Series, follow the steps below:

1. Click the hyperlinked text of the desired Data Series from the table view to navigate to the Data Series information page.

2. Select the Download button.

Data series history

The FEWS NET Data Warehouse system tracks various events that are performed against Data Series including the addition, update or deletion of data in the system. To view the Data Series history, follow the steps below:

1. Click the hyperlinked text of the desired Data Series from the table view to navigate to the Data Series information page.

2. Select the History button.

3. Review the change history table for details of the updates and other operations carried out against the selected Data Series record.

Data Point operations

Individual Data Points are organized by Data Domain within the Data Points submenu, accessible via Data Warehouse > Data Series Management > Data Points.

The Data Points pages list the currently available Data Series values in a table format with the following column headers:

• Data Series: the Data Series the data point belongs to.

• Period Date: the last day of the Collection Period.

• Collection Status: the status of the Data Collection.

• Value: the value of the Data Point.

Browsing Data Points

Unlike the Data Series table, the Data Point table uses standardized column headings that are not unique to the Data Domain category and cannot be sorted.

Use keyword searches and the filters options to quickly locate specific Data Point values.

Adding data points

Users can upload/import a bulk file of Data Point values into the system using the import functionality. To import Data Point values in a file into the system:

1. From the Data Point value table view, select the Import data series value button. This will open the Import page.

2. Select Choose File to choose the file to be imported.

3. Specify the file format from the Format drop-down list.

4. Click Submit to start the import process.

5. Once the file is uploaded, the system will display the summary including:

   • New: the data in the file that will be imported.

   • Updated: the data in the file that are updates to existing data in the system.

   • Delete: the records in the file that will be deleted from the system.

   • Skip: the records in the file that will be skipped.

   • Error: the records in the file that have errors in the data and will not be added to the system.

   • Total: total number of records in the file.

6. To continue with the import, select Confirm Import. The data series will be imported and a confirmation message will appear when complete.

Editing data points

An existing unpublished Data Point value can be modified. To edit a Data Point value:

1. Click the hyperlinked text of the desired Data Point value from the table view to navigate to the change value page.

2. Modify the record information as needed.

3. Select one of the Save options at the bottom of the page. A confirmation message will appear when complete.

Deleting Data Points

If necessary, unpublished Data Point values can be deleted. This functionality is not available for published Data Point values. To delete Data Point values, follow the steps below:

1. Using the checkboxes, select the desired Data Point values from the table view. Multiple Data Points can be selected at once.

2. From the Action drop-down list, select the option Delete selected unpublished values. Confirm the selection by clicking Go. This will open a summary page.

3. From the summary page, confirm the intent to delete the selected Data Series.

Deleted records cannot be recovered.

Viewing data points history

The FEWS NET Data Warehouse system tracks various events that are performed against Data Series including the addition, update or deletion of data in the system. To view the data series history, follow the steps below:

1. Click the hyperlinked text of the desired Data Point value from the table view to navigate to the Data Point value information page.

2. Select the History button.

3. Review the change history table for details of the updates and other operations carried out against the selected Data Series record.