# 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)
Comment:

--

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

 v4 {{{ [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,season,leadMonth,'members',members,'xlim',xlim,'ylim',ylim,'user',user,'password',password); [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,season,leadMonth,varargin); }}} The input arguments are next described: Obligatory input arguments: * 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]). * var: A string indicating the variable to be read. Variables currently available are tas, tasmin, tasmax and pr (or mslp). * 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. * leadMonth: Forecast lead time (in months) to be considered. For instance, leadMonth = 1 for January refers to forecasts issued the first of December. * 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]). * var: Variable code. Values currently accepted are tas, tasmin, tasmax, pr or mslp. However, note that new variables and datasets will be progressively included. * 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. * leadMonth: Lead time (in months) to consider. For instance, leadMonth = 1 for January forecasts means considering the initialization of the first of December . * members: Vector of length ''n'' indicating the ''n'' members to consider. * xlim: Vector of length = 2 with minimum and maximum longitude coordinates (in decimal degrees) of the bounding box selected. * ylim: Vector of length = 2 with minimum and maximum latitude coordinates (in decimal degrees) of the bounding box selected. * user: Username for accessing the OPeNPAD dataset. * password: Password for accessing the OPeNPAD dataset. Optional input arguments (''varargin''): * members: Vector indicating the members to consider. By default all available members are considered. * 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. * 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. * user: Username for ccessing the OPeNPAD server. By default it is set to 'euporias'. * password: Password for accessing the OPeNPAD server. By default it is set to 'uc123'. These are the arguments returned by the function: * 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. * 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. * ens: List of length ''n'', where ''n'' is the number of members of the ensemble selected by the members argument. * frc: Cell with ''n'' elements (one for each year) corresponding to the forecasts times. * lat: Vector with the latitudes of the selected domain. * lon: Vector with the longitudes of the selected domain. Outputs returned by the function: * 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. * run: Cell with ''n = number of years'' vectors. Each vector indicates the initialization time (in ''datevec'' format) for a particular year. * ens: Cell of ''n = number of years'' vectors. Each vector contains the ensemble members considered. * frc: Cell with ''n = number of years'' 2-D matrices. Each matrix contains the forecasts times (in ''datevec'' format) for a particular year. * lat: Cell of ''n = number of years'' vectors. Each vector contains the latitudes of the selected domain. * lon: Cell of ''n = number of years'' vectors. Each vector contains the longitudes of the selected domain. ==  Example: == dataset = 'http://www.meteo.unican.es/tds5/dodsC/system4/System4_Seasonal_15Members.ncml'; var = 'Maximum_temperature_at_2_metres_since_last_24_hours_surface'; [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,{'Aug';'Aug'},2,'members',5,'xlim',[-10 5],'ylim',[35 45]); [data,run,ens,frc,lat,lon] = loadSystem4(dataset,var,{'Aug';'Aug'},2,'members',5,'xlim',[-10 5],'ylim',[35 45]); }}}