GriddedStats2D_ageBased¶
Doc: Counts particles inside cells of a regular grid as a histogram binned by particle age, useful in tracking ages class of larave Grid is centered at given location, or optionally at the midpoint of each release group The particles counted can be subsetted by status, water depth etc, default is all alive particles not outside open boundaries. Alive particles have stationary, no_bottom, stranded or moving status Output in netcdf file split into release groups and age bis for the entire run ( or user give start to end times) has at least -counts of particles in the requested subset -counts of all alive particles inside the domain, whether in the subset or not -counts_released_age of all release particles in age bin histogram, incudes those which are outside the domain have died etc.t - connectivity_matrix, the probability of a released particle being inside each grid cell. that is the connectivity = counts/counts_released_age
short class_name: GriddedStats2D_ageBased
full class_name : oceantracker.particle_statistics.gridded_statistics2D.GriddedStats2D_ageBased
Warning
Class is under development may not yet work in all cases, if errors contact developer
Inheritance: > ParameterBaseClass> _BaseParticleLocationStats> _BaseGrid2DStats> _BaseAgeStats> GriddedStats2D_ageBased
Parameters:¶
age_bin_size<class 'float'><isrequired>Description: Size of bins to count ages into
default:
Nonedata_type:
<class 'float'>units:
secmin:
1
class_name<class 'str'><optional>Description: Class name as string A.B.C, used to import this class from python path
default:
Nonedata_type:
<class 'str'>
duration<class 'float'><optional>Description: How long to do counting after start time, can be used instead of “end” parameter
default:
Nonedata_type:
<class 'float'>units:
secmin:
0.0
end['str', 'float', 'datetime64', 'int', 'float64', 'float32']<optional>Description: Stop particle counting from this iso date-time, default is end of model run
default:
Nonepossible_types:
[<class 'str'>, <class 'float'>, <class 'numpy.datetime64'>, <class 'int'>, <class 'numpy.float64'>, <class 'numpy.float32'>]units:
ISO8601 date as string eg. "2017-01-01T00:30:00",np.datetime64, or float of seconds since 1/1/1970
grid_center: still working on display of default params of type <class ‘oceantracker.util.parameter_checking.ParameterCoordsChecker’>
grid_size: <optional>Description: - number of (rows, columns) in grid, where rows is y size, cols x size, values should be odd, so will be rounded up to next
a list containing type:
[]default list :
[100, 99]data_type:
<class 'int'>min:
1max:
100000possible_types:
[]make_list_unique:
Falsefixed_len:
2min_len:
0
grid_span:<isrequired>Description: - (width-x, height-y) of the statistics grid
a list containing type:
[]default list :
Nonedata_type:
<class 'float'>units:
meters (dx,dy) or degrees (dlon, dlat) if geographicpossible_types:
[]make_list_unique:
Falsemin_len:
0
max_age_to_bin<class 'float'><isrequired>Description: Max. particle age to count
default:
Nonedata_type:
<class 'float'>units:
secmin:
1.0
min_age_to_bin<class 'float'><optional>Description: Min. particle age to count
default:
0.0data_type:
<class 'float'>units:
secmin:
0.0
name<class 'str'><optional>Description: Name used to refer to class in code and output, = None for core claseses
default:
Nonedata_type:
<class 'str'>
near_seabed<class 'float'><optional>Description: Count only those particles within this distance of bottom
default:
Nonedata_type:
<class 'float'>units:
meters above seabedmin:
0.001
near_seasurface<class 'float'><optional>Description: Count only those particles within this distance of tidal sea surface
default:
Nonedata_type:
<class 'float'>units:
meters below sea surfacemin:
0.001
particle_property_list: <optional>Description: - Create statistics for these named particle properties, list = [“water_depth”], for average of water depth at particle locations inside the counted regions
a list containing type:
[]default list :
Nonedata_type:
<class 'str'>possible_types:
[]make_list_unique:
Truemin_len:
0
release_group_centered_grids<class 'bool'><optional>Description: Center grid on the release groups mean horizontal location or center of release polygon.
default:
Falsedata_type:
<class 'bool'>possible_values:
[True, False]
role_output_file_tag<class 'str'><optional>
default:
stats_gridded_time_2Ddata_type:
<class 'str'>
start['str', 'float', 'datetime64', 'int', 'float64', 'float32']<optional>Description: Start particle counting from this date-time, default is start of model run
default:
Nonepossible_types:
[<class 'str'>, <class 'float'>, <class 'numpy.datetime64'>, <class 'int'>, <class 'numpy.float64'>, <class 'numpy.float32'>]units:
ISO8601 date as string eg. "2017-01-01T00:30:00",np.datetime64, or float of seconds since 1/1/1970
status_list: <optional>Description: - List of particle status types to count,eg [“on_bottom”,”moving”], other status types will be ignored in statistcs
a list containing type:
[]default list :
['stationary', 'stranded_by_tide', 'on_bottom', 'moving']data_type:
<class 'str'>possible_values:
['unknown', 'notReleased', 'dead', 'outside_domain', 'outside_open_boundary', 'stationary', 'stranded_by_tide', 'on_bottom', 'moving']possible_types:
[]make_list_unique:
Falsemin_len:
0
update_interval<class 'float'><optional>Description: Time in seconds between calculating statistics, wil be rounded to be a multiple of the particle tracking time step
default:
3600.0data_type:
<class 'float'>units:
sec
user_note<class 'str'><optional>
default:
Nonedata_type:
<class 'str'>
water_depth_max<class 'float'><optional>Description: Count only those particles in water depths less than this value
default:
Nonedata_type:
<class 'float'>min:
0.0
water_depth_min<class 'float'><optional>Description: Count only those particles in water depths greater than this value
default:
Nonedata_type:
<class 'float'>min:
0.0
write<class 'bool'><optional>Description: Write statistcs to disk
default:
Truedata_type:
<class 'bool'>possible_values:
[True, False]
z_max<class 'float'><optional>Description: Count only those particles with vertical position <= to this value
default:
Nonedata_type:
<class 'float'>units:
meters above mean water level, so is < 0 at depth
z_min<class 'float'><optional>Description: Count only those particles with vertical position >= to this value
default:
Nonedata_type:
<class 'float'>units:
meters above mean water level, so is < 0 at depth