Global Information and Early Warning System (GIEWS) FOOD PRICE MONITORING AND ANALYSIS (FPMA) TOOL USER MANUAL

Transcription

1 Global Information and Early Warning System (GIEWS) FOOD PRICE MONITORING AND ANALYSIS (FPMA) TOOL USER MANUAL

2 FOOD PRICE MONITORING AND ANALYSIS TOOL The FPMA Tool 3 is a web-based application for visualization and analysis of price data developed by the Global Information and Early Warning Unit in the Food and Agriculture Organization of the United Nations. FAO FPMA Tool 3 User manual (This document refers to version 3.x.x) CONTENTS 1. Home Screen 3 2. Browsing data in Grid View 4 3. Browsing data in Map View 6 4. The Working Area 8 The Chart panel 9 The Legend panel 12 The Options panel 13 The Chart Data panel 14 The Statistics panel 15 The Information panel 17 2

3 FOOD PRICE MONITORING AND ANALYSIS TOOL 1. Home screen 1. HOME SCREEN The home screen of the FPMA Tool provides information about the data available in the database, such as the number of series in each dataset and the commodity coverage. To start using the tool it is necessary to select one of the datasets available in the side menu. 3

4 FOOD PRICE MONITORING AND ANALYSIS TOOL 2. BROWSING DATA IN GRID VIEW To cancel all filters use the big X on the left. It is possible to download the list of series displayed in the data grid from the download command in the dropdown menu in the top right corner of the grid view panel. Once a price dataset has been selected from the side menu the home screen will be replaced by a data grid showing the available series of price data. It s possible to scroll down the grid to view all of the available series in the selected dataset, which by default come ordered alphabetically on the values in the first column. Filters can be multiple and applied to all columns in any order. To remove a filter cancel it from the list HINT To facilitate the viewing of the working area, especially if you have a smaller screen, the side menu can easily be collapsed from its minimize tab. You can order alphabetically on any of the data grid fields by clicking on the column headers. To facilitate a search for specific data, use the column head filter boxes. Click inside one of the boxes and pick from the list or Begin to type what you are looking for and you will find it quicker. HINT You can expand the grid to full screen from the enlarge arrows on the top right of the data grid panel. 4

5 FOOD PRICE MONITORING AND ANALYSIS TOOL 2. Browsing data in Grid View When you have found the series you are looking for, simply click on it in the list and a chart with this data will appear in the Working Area. To remove the series, click on it again, or replace it by clicking another series. To add multiple series to the working area select the series using the check boxes. NOTE When series with different weight units are selected simultaneously the data will automatically be harmonized to kg and when series with different currencies are selected simultaneously it will automatically be harmonized to US dollars. To remove all selected series from the working area click the Clear All button in the top right corner of the working area. 5

6 FOOD PRICE MONITORING AND ANALYSIS TOOL 3. BROWSING DATA IN MAP VIEW Map View is an alternative to Grid View for browsing the data inside the Tool. In Map View it is possible to see the geographic locations where data is available. NOTE The Map View will always reflect the filters that have been applied to the data grid. i.e. the map will show exactly the countries/markets/series that are listed in the data grid at any moment. Hint You can expand the map to full screen from the enlarge arrows on the top right of the map panel. 6

7 FOOD PRICE MONITORING AND ANALYSIS TOOL 3. Browsing data in Map View Click a series in the dialog list and a chart with this data will appear in the working area. To remove the series, click on it again, or replace it by clicking another series. To add multiple series to the working area select the series using the check boxes. NOTE When series with different weight units are selected simultaneously the data will automatically be harmonized to kg and when series with different currencies are selected simultaneously it will automatically be harmonized to US dollars. Clicking on a marker on the map will open a popup dialog with a list of the series available at that location. Whenever a price series is selected (from map view or grid view), the marker on the map for the corresponding market will change colour to green and the border of the corresponding country will be highlighted. To remove all selected series from the working area click the Clear All button in the top right corner of the working area. 7

8 FOOD PRICE MONITORING AND ANALYSIS TOOL 4. THE WORKING AREA When one or more series are selected in Grid View or Map View, these series are added to the Working Area. Hint You can expand the working area to full screen from the enlarge arrows on the top right of the working area panel. 8

9 THE CHART PANEL By default, the chart will show the full series of data available for the selected series. Hovering the mouse over the chart, while the options panel is in the foreground, will display information about the corresponding data points in a popup window. The chart is dynamic and the period of data to display can be adjusted using the shortcut buttons, the slider below the chart or by selecting a section of the chart directly with the mouse. 9

10 Hovering the mouse over the chart, while the legend panel is in the foreground, will display information about the corresponding data points in the corresponding legend items. 10

11 In the top right corner of the chart panel, there is a dropdown menu giving access to features related to the active chart. download chart a PNG image will be generated of the current chart. widget chart a dialog will open allowing the generation of an embeddable HTML widget of the current chart. Some aspects of the widget such as size and legend content can be customized from the widget builder dialog and it is possible to see a preview of the widget that will be reproduced using the script provided. permalink - a permanent link can be generated for the current selected price series. Such a link can be: (i) saved as a bookmark, permitting quick return to regularly used analysis; (ii) used as a hyperlink to create a direct link to a particular chart from a web page or inside a document, or (iii) shared (e.g. by ). 11

12 THE LEGEND PANEL Hovering the mouse over an item in the Legend panel will highlight the corresponding series on the chart. This is useful to facilitate the focus on a particular series while analysing multiple series. Price series can be removed from the working area individually by clicking the x on the corresponding legend item. To facilitate identification and geographic localization of markets, when hovering the mouse over items in the legend panel the corresponding market marker in map view will change colour to highlight its location. The legend panel can be collapsed by clicking on the dark rectangle of the division between the chart and the option/ legend panels. 12

13 THE OPTIONS PANEL The Options panel gives access to several useful analysis features available in the Tool. NOTE The Market Season/Year-on-Year and Price Trend/Volatility options are only available while viewing a single price series. Periodicity By default the shortest periodicity available is loaded when a price series is selected or the shortest common periodicity if more than one series is selected. These buttons will activate according to the available periodicities for the series selected and it is possible to switch between available periodicities by clicking on the buttons. Currency By default prices are displayed in nominal terms. By selecting real, for every series on the chart, an additional series in real terms, deflated by general CPI will be added to the chart. By selecting US dollar, for every series on the chart, an additional series in US dollar terms, will be added to the chart. It is possible to view all three currency options simultaneously or individually. Measure If data is displayed in in local measure units, it can be converted to either kg or tonnes by using the kg or tonnes options. (Note: This feature only applies to units of weight.) Type of chart By default a normal times series chart is displayed. The Market Season/Year-on- Year option allows visualization of the data divided into 12-month segments to facilitate analysis of seasonal behaviour in series. The Price Trend/Volatility shows a chart of volatility (measured as the standard deviation over 12 months) and a trend (measured as the 12 month moving average). 13

14 THE CHART DATA PANEL It is possible to visualize and download the data for any chart on the Chart Data panel. It is possible to download data table is available in the dropdown menu in the top right corner of the Chart Data panel. By default the most recent value will appear at the top of the table but it is possible to invert the data order or sort on any of the other columns by clicking the respective column header. 14

15 THE STATISTICS PANEL It is possible to change the period of analysis directly from the calendar controls on the statistics panel. Two sets of statistics are provided in the Statistics panel: Statistics for selected time period These statistics refer to the selected time period. Whenever the period of data displayed on the chart is changed, these statistics will update to reflect the new period of analysis. The statistics provided in this analysis include: Start date of the period of analysis End data of the period of analysis Number of non-null data points in the period of analysis Average of all non-null data points over the period of analysis Standard deviation of all non- Null data points over the period of analysis Minimum price observed during the period and the corresponding date Maximum price observed during the period and the corresponding date The range of values from min to max over the period of analysis It is possible to download this set of statistics from the download command in the dropdown menu in the top right corner of the Statistics panel. 15

16 Percent changes from selected end date This set of statistics provides some pre-set percentage changes in respect to the most recent value in the selected period. Whenever the end date of the period of data displayed on the chart is changed, these statistics will update to reflect the new end date. The statistics provided in this analysis vary depend on the periodicity of the series being analysed. For data with monthly periodicity the following statistics are provided: Hint When working with a multiple selection of price series it is possible to sort the statistics table by any of provided statistics by clicking on the header of the corresponding column. It is possible to change the end date directly from the calendar controls on the statistics panel. Latest available value and corresponding date Value one month earlier Percent change from previous month Percent same month-on-month percent change over the past 5 years (more years can be selected if available) Value in the same month a year earlier Percent change from a year earlier Percent change from n months earlier where n can be selected by the user. It is possible to download this set of statistics from the download command in the dropdown menu in the top right corner of the statistics panel. 16

17 THE INFORMATION PANEL The information panel provides information relating to the market, commodity and source of the selected price series. It is possible to download this information from the download command in the dropdown menu in the top right corner of the statistics panel. 17