PointRelease¶
Description: Release particles at 1 or more given locations. Pulse_size particles are released every release_interval. All these particles are tagged as a single release_group.
class_name: oceantracker.release_groups.point_release.PointRelease
File: oceantracker/release_groups/point_release.py
Inheritance: PointRelease
Parameters:¶
allow_release_in_dry_cells<class 'bool'><optional>Description: Allow releases in cells which are currently dry, ie. either permanently dry or temporarily dry due to the tide.
default:
Falsepossible_values:
[True, False]
class_name<class 'str'><optional>Description: Class name as string A.B.C, used to import this class from python path
default:
None
max_age<class 'float'><optional>Description: Particles older than this age in seconds are culled,ie. status=dead, and removed from computation, very useful in reducing run time
default:
Nonemin:
1.0
max_cycles_to_find_release_points<class 'int'><optional>Description: Maximum number of cycles to search for acceptable release points, ie. inside domain, polygon etc
default:
50min:
50
pointsarray<isrequired>Description: A N by 2 or 3 list of locations where particles are released. eg for 2D
[[25,10],[23,2],....], must be convertible into N by 2 or 3 numpy array
default:
[]
pulse_size<class 'int'><optional>Description: Number of particles released in a single pulse, this number is released every release_interval.
default:
1min:
1
release_duration<class 'float'><optional>Description: Time in seconds particles are released for after they start being released, ie releases stop this time after first release.,an alternative to using “release_end_date”
default:
Nonemin:
0.0
release_end_dateiso8601date<optional>Description: Date to stop releasing particles, ignored if release_duration give, must be an ISO date as string eg. “2017-01-01T00:30:00”
default:
None
release_interval<class 'float'><optional>Description: Time interval between released pulses. To release at only one time use release_interval=0.
default:
0.0min:
0.0units:
sec
release_radius<class 'float'><optional>Description: Particles are released from random locations in circle of given radius around each point.
default:
0.0min:
0.0
release_start_dateiso8601date<optional>Description: Must be an ISO date as string eg. “2017-01-01T00:30:00”
default:
None
user_note<class 'str'><optional>
default:
None
user_release_groupID<class 'int'><optional>Description: User given ID number for this group, held by each particle. This may differ from internally uses release_group_ID.
default:
0
user_release_group_name<class 'str'><optional>Description: User given name/label to attached to this release groups to make it easier to distinguish.
default:
None
z_range: <optional>Description: - z range = [zmin, zmax] to randomly release in 3D, overrides any given release z value
a list containing type:
[<class 'float'>, <class 'int'>]default list :
[]can_be_empty_list:
Truemin_length:
2