PolygonStats2D_ageBased¶
Doc: Counts particles inside given polygons as a histogram binned by particle age, useful in tracking ages class of larave 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 bins 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: PolygonStats2D_ageBased
full class_name : oceantracker.particle_statistics.polygon_statistics.PolygonStats2D_ageBased
Warning
Class is under development may not yet work in all cases, if errors contact developer
Inheritance: > ParameterBaseClass> _BaseParticleLocationStats> _BasePolygonStats> _BaseAgeStats> PolygonStats2D_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
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
role_output_file_tag<class 'str'><optional>
default:
stats_polygon_agedata_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
use_release_group_polygons<class 'bool'><optional>Description: Omit polygon_list param and use all polygon release polygons as statistics/counting polygons, useful for building release group polygon to polygon connectivity matrix.
default:
Falsedata_type:
<class 'bool'>possible_values:
[True, False]
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