Versions Compared

Old Version 3

changes.mady.by.user Iain Russell

Saved on

compared with

New Version Current

changes.mady.by.user Iain Russell

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column
width76px


Column

This icon allows you to compute a set of percentiles of a given input fieldset. A percentile is a number such that the given percentage of a distribution is equal to or below it. For instance, the median is the 50th percentile - 50% of the values are equal to or below it.

The generated fields can simply be visualised or saved as GRIB files.The macro language equivalent is

Info

From Macro/Python this icon can be called as percentile().



The Percentile Editor

Data

Specifies the data required for the application. This can be any icon returning GRIB data (e.g. MARS Retrieval, GRIB Filter, Formula, Simple Formula). The icon field assist button provides a tailor made MARS request in case you need some guidance in the data specification. Alternatively, parameter Source can be used.

Source

Specifies the GRIB file path and name. Type the full file path and name. Alternatively, parameter Data can be used.

...

Specifies a list of values from 0 to 100 separated by a forward slash "/". The total number of values should be equal to or smaller than the number of input fields, as each output field (which corresponds to each percentile value) will use the same input field structure. This will save computer resources and optimize the processing time.

Interpolation

Specifies the interpolation method used to compute the percentiles: nearest_neighbour or linear. The default value is: nearest_neighbour.

Nearest Neighbour or Linear. Given a list of numbers V, the algorithm used to compute a percentile is the following.:

  1. Compute the rank (R) of a Pth P-th percentile. This is done using the following formula:
    R = P/100 x (N + 1)
    where P is the desired percentile and N is the number of input fields.

  2. Compute the percentile:

    1. If R is an integer, the Pth P-th percentile will be the number with rank R.

    2. If R is not an integer, the Pth P-th percentile is computed by interpolation as follows:

      1. If the interpolation method is Nearest Neighbour, the following equation is used:
        Pth P-th = V[int(R + 0.5)]

      2.  If the interpolation method is Linear, the following steps are used:

        1. Define IR as the integer portion of R

        2. Define FR as the fractional portion or R

        3. Find the scores with Rank IR and with Rank IR + 1, e.g. V[IR] and vV[IR+1]

        4. Interpolate by multiplying the difference between the scores by FR and add the result to the lower score, e.g.
          Pth = FR * (vV[IR+1] - V[IR]) + V[IR]

Compute if Missing

Specifies how to handle the presence of missing values in the input data.

  • On  (this is the default)
    • for each grid point, the percentiles are computed using only the non-missing values
  • Off
    • for each grid point, if there are any missing values, the result for that point will be a missing value