Created on Jul 29, 2013
@author: Christoph Paulik christoph.paulik@geo.tuwien.ac.at
Bases: object
Container class for ASCAT time series
Parameters: | gpi : int
lon : float
lat : float
cell : int
data : pandas.DataFrame
topo_complex : int, optional
wetland_frac : int, optional
porosity_gldas : float, optional
porosity_hwsd : float, optional
|
---|
Attributes
gpi | int | grid point index |
longitude | float | longitude of grid point |
latitude | float | latitude of grid point |
cell | int | cell number of grid point |
data | pandas.DataFrame | DataFrame which contains the data |
topo_complex | int | topographic complexity at the grid point |
wetland_frac | int | wetland fraction at the grid point |
porosity_gldas | float | porosity taken from GLDAS model |
porosity_hwsd | float | porosity calculated from Harmonised World Soil Database |
Methods
Bases: pytesmo.io.sat.ascat.AscatNetcdf
class for reading ASCAT SSM data. It extends AscatNetcdf and provides the information necessary for reading SSM data
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
advisory_flags_path : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
netcdftemplate : string, optional
include_in_df : list, optional
|
---|
Attributes
include_in_df | list | list of variables in the netcdf file that should be returned to the user after reading |
Methods
read_ssm(*args,**kwargs) | read surface soil moisture |
function to read SSM takes either 1 or 2 arguments. It can be called as read_ssm(gpi,**kwargs) or read_ssm(lon,lat,**kwargs)
Parameters: | gpi : int
lon : float
lat : float
mask_ssf : boolean, optional
mask_frozen_prob : int,optional
mask_snow_prob : int,optional
absolute_values : boolean, optional
|
---|---|
Returns: | ASCATTimeSeries : object
|
Bases: object
Class that provides access to ASCAT data stored in netCDF format which is downloadable from the HSAF website.
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
netcdftemplate : string, optional
|
---|
Attributes
path | string | path to data folder which contains the zip files from the FTP server |
grid_path | string | path to grid_info folder which contains txt files with information about grid point index,latitude, longitude and cell |
grid_info_filename | string, optional | name of the grid info netCDF file in grid_path default ‘TUW_WARP5_grid_info_2_1.nc’ |
topo_threshold | int | if topographic complexity of read grid point is above this threshold a warning is output during reading |
wetland_threshold | int | if wetland fraction of read grid point is above this threshold a warning is output during reading |
grid_info_loaded | boolean | true if the grid information has already been loaded |
grid | grids.CellGrid object | CellGrid object, which provides nearest neighbor search and other features |
advisory_flags_path | string | path to advisory flags .dat files, if not provided they will not be used |
include_advflags | boolean | True if advisory flags are available |
Bases: pytesmo.io.sat.ascat.Ascat_data
class for reading ASCAT SSM data. It extends Ascat_data and provides the information necessary for reading SSM data
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
advisory_flags_path : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
|
---|
Attributes
gp_filename_template | string | defines how the gpi is put into the template string to make the filename |
gp_filestruct | numpy.dtype | structure template of the SSM .dat file |
scale_factor | dict | factor by which to multiply the raw data to get the correct values for each field in the gp_filestruct |
include_in_df | list | list of fields that should be returned to the user after reading |
nan_values | dict | nan value saved in the file which will be replaced by numpy.nan values during reading |
datatype | dict | datatype of the fields that the return data should have |
Methods
read_ssm(*args,**kwargs) | read surface soil moisture |
function to read SSM takes either 1 or 2 arguments. It can be called as read_ssm(gpi,**kwargs) or read_ssm(lon,lat,**kwargs)
Parameters: | gpi : int
lon : float
lat : float
mask_ssf : boolean, optional
mask_frozen_prob : int,optional
mask_snow_prob : int,optional
|
---|---|
Returns: | ASCATTimeSeries : object
|
Bases: pytesmo.io.sat.ascat.Ascat_data
class for reading ASCAT SWI data. It extends Ascat_data and provides the information necessary for reading SWI data
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
advisory_flags_path : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
|
---|
Attributes
gp_filename_template | string | defines how the gpi is put into the template string to make the filename |
gp_filestruct | numpy.dtype | structure template of the SSM .dat file |
scale_factor | dict | factor by which to multiply the raw data to get the correct values for each field in the gp_filestruct |
include_in_df | list | list of fields that should be returned to the user after reading |
nan_values | dict | nan value saved in the file which will be replaced by numpy.nan values during reading |
datatype | dict | datatype of the fields that the return data should have |
T_SWI | dict | information about which numerical T-Value maps to which entry in the datastructure |
T_QFLAG | dict | information about which numerical T-Value maps to which entry in the datastructure |
Methods
read_swi(*args,**kwargs) | read soil water index |
function to read SWI takes either 1 or 2 arguments being. It can be called as read_swi(gpi,**kwargs) or read_swi(lon,lat,**kwargs)
Parameters: | gpi : int
lon : float
lat : float
T : int, optional
mask_qf : int, optional
mask_frozen_prob : int,optional
mask_snow_prob : int,optional
|
---|---|
Returns: | df : pandas.DataFrame
|
Bases: object
Class that provides access to ASCAT data stored in userformat which is downloadable from the TU Wien FTP Server after registration at http://rs.geo.tuwien.ac.at .
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
advisory_flags_path : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
|
---|
Attributes
path | string | path to data folder which contains the zip files from the FTP server |
grid_path | string | path to grid_info folder which contains txt files with information about grid point index,latitude, longitude and cell |
grid_info_filename | string | name of the grid info txt file in grid_path |
grid_info_np_filename | string | name of the numpy save file to the grid information |
topo_threshold | int | if topographic complexity of read grid point is above this threshold a warning is output during reading |
wetland_threshold | int | if wetland fraction of read grid point is above this threshold a warning is output during reading |
grid_info_loaded | boolean | true if the grid information has already been loaded |
grid | pytesmo.grid.grids.CellGrid object | CellGrid object, which provides nearest neighbor search and other features |
advisory_flags_path | string | path to advisory flags .dat files, if not provided they will not be used |
include_advflags | boolean | True if advisory flags are available |
Methods
unzip_cell(cell) | unzips zipped grid point files into subdirectory |
read_advisory_flags(gpi) | reads the advisory flags for a given grid point index |
Read the advisory flags located in the self.advisory_flags_path Advisory flags include frozen probability, snow cover probability topographic complexity and wetland fraction.
Parameters: | gpi : long
|
---|---|
Returns: | df : pandas.DataFrame
topo : numpy.uint8
wetland : numpy.uint8
|
Created on Oct 22, 2013
@author: Christoph Paulik christoph.paulik@geo.tuwien.ac.at
Bases: pytesmo.io.sat.ascat.ASCATTimeSeries
Extends pytesmo.io.sat.ascat.ASCATTimeSeries and provides correct string representation for ERS data
Methods
Bases: pytesmo.io.sat.ascat.AscatNetcdf
class for reading ERS SSM data. It extends pytesmo.io.sat.ascat.AscatNetcdf instance and provides the information necessary for reading SSM data
Parameters: | path : string
grid_path : string
grid_info_filename : string, optional
advisory_flags_path : string, optional
topo_threshold : int, optional
wetland_threshold : int, optional
netcdftemplate : string, optional
include_in_df : list, optional
|
---|
Attributes
include_in_df | list | list of variables in the netcdf file that should be returned to the user after reading |
Methods
read_ssm(*args,**kwargs) | read surface soil moisture |
function to read SSM takes either 1 or 2 arguments. It can be called as read_ssm(gpi,**kwargs) or read_ssm(lon,lat,**kwargs)
Parameters: | gpi : int
lon : float
lat : float
mask_frozen_prob : int,optional
mask_snow_prob : int,optional
absolute_values : boolean, optional
|
---|---|
Returns: | ERSTimeSeries : object
|