Changes between Version 4 and Version 5 of udg/ecoms/dataserver/interfaces/matlab


Ignore:
Timestamp:
Apr 22, 2013 7:12:48 PM (9 years ago)
Author:
rodri
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • udg/ecoms/dataserver/interfaces/matlab

    v4 v5  
    55
    66{{{
    7  [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,season,leadMonth,'members',members,'xlim',xlim,'ylim',ylim,'user',user,'password',password);
     7 [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,season,leadMonth,varargin);
    88}}}
    99
    10 The input arguments are next described:
     10Obligatory input arguments:
     11* `dataset`: A string indicating the ''url'' of the dataset to be read (check the catalog of available datasets [https://www.meteo.unican.es/trac/meteo/wiki/SpecsEuporias/DataServer/Datasets here]).
     12* `var`: A string indicating the variable to be read. Variables currently available are `tas`, `tasmin`, `tasmax` and `pr` (or `mslp`).
     13* `season`: A cell of two strings indicating the first and final months to be read. Single months ({'Jan';'Jan'}) or seasons defined by consecutive months ({'Dec';'Feb'}) can be specified. Note that months are denoted by their three first letters.
     14* `leadMonth`: Forecast lead time (in months) to be considered. For instance, `leadMonth = 1` for January refers to forecasts issued the first of December.
    1115
    12 * `dataset`: A string indicating the ''url'' of the dataset (check the catalog of available datasets [https://www.meteo.unican.es/trac/meteo/wiki/SpecsEuporias/DataServer/Datasets here]).
    13 * `var`: Variable code. Values currently accepted are `tas`, `tasmin`, `tasmax`, `pr` or `mslp`. However, note that new variables and datasets will be progressively included.
    14 * `season`: A cell of two strings indicating the first and final months of analysis. A single month ({'Jan';'Jan'}) or a standard season ({'Dec';'Feb'}) can be specified. Note that months are indicated by their three first letters.
    15 * `leadMonth`: Lead time (in months) to consider. For instance, `leadMonth = 1` for January forecasts means considering the initialization of the first of December .
    16 * `members`: Vector of length ''n'' indicating the ''n'' members to consider.
    17 * `xlim`: Vector of length = 2 with minimum and maximum longitude coordinates (in decimal degrees) of the bounding box selected.
    18 * `ylim`: Vector of length = 2 with minimum and maximum latitude coordinates (in decimal degrees) of the bounding box selected.
    19 * `user`: Username for accessing the OPeNPAD dataset.
    20 * `password`: Password for accessing the OPeNPAD dataset.
     16Optional input arguments (''varargin''):
     17* `members`: Vector indicating the members to consider. By default all available members are considered.
     18* `xlim`: Vector of length = 2 with minimum and maximum longitude (in degrees) of the selected bounding box. By default the whole domain of the dataset is considered.
     19* `ylim`: Vector of length = 2 with minimum and maximum latitude (in degrees) of the selected bounding box. By default the whole domain of the dataset is considered.
     20* `user`: Username for ccessing the OPeNPAD server. By default it is set to 'euporias'.
     21* `password`: Password for accessing the OPeNPAD server. By default it is set to 'uc123'.
    2122
    22 These are the arguments returned by the function:
    23 
    24 * `data`: Cell with ''n'' elements (one for each year), in which each element (a 2-D matrix) is the data for a particular year. A 2-D matrix of ''i'' rows and ''j'' columns, ''i'' represents the forecast times and ''j'' the grid-points selected.
    25 * `run`: Cell with ''n'' elements (one for each year) corresponding to the initialization times selected. Note that there is an initialization time associated to each forecast time.
    26 * `ens`: List of length ''n'', where ''n'' is the number of members of the ensemble selected by the `members` argument.
    27 * `frc`: Cell with ''n'' elements (one for each year) corresponding to the forecasts times.
    28 * `lat`: Vector with the latitudes of the selected domain.
    29 * `lon`: Vector with the longitudes of the selected domain.
     23Outputs returned by the function:
     24* `data`: Cell with ''n = number of years'' 5-D matrices. Each matrix contains the forecasts for a particular year. Its first and second dimension of the matrix refers to the dataset and variable read. The third dimension correspondons to the forecasts times. Forth and fifth dimensions refer to the latitudes and longitudes of the grid boxes selected.
     25* `run`: Cell with ''n = number of years'' vectors. Each vector indicates the initialization time (in ''datevec'' format) for a particular year.
     26* `ens`: Cell of ''n = number of years'' vectors. Each vector contains the ensemble members considered.
     27* `frc`: Cell with ''n = number of years'' 2-D matrices. Each matrix contains the forecasts times (in ''datevec'' format) for a particular year.
     28* `lat`: Cell of ''n = number of years'' vectors. Each vector contains the latitudes of the selected domain.
     29* `lon`: Cell of ''n = number of years'' vectors. Each vector contains the longitudes of the selected domain.
    3030
    3131==  Example: ==
     
    3636dataset = 'http://www.meteo.unican.es/tds5/dodsC/system4/System4_Seasonal_15Members.ncml';
    3737var = 'Maximum_temperature_at_2_metres_since_last_24_hours_surface';
    38  [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,{'Aug';'Aug'},2,'members',5,'xlim',[-10 5],'ylim',[35 45]);
     38[data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,{'Aug';'Aug'},2,'members',5,'xlim',[-10 5],'ylim',[35 45]);
    3939}}}
    4040