tathu.tracking package

Submodules

tathu.tracking.descriptors module

class tathu.tracking.descriptors.ConvectiveCellsDescriptor(cellTemp, minarea=None)

Bases: object

This class implements a convective system descriptor that computes the number of convectives cells.

describe(image, systems)
class tathu.tracking.descriptors.DBZStatisticalDescriptor(stats=['max', 'mean', 'std', 'count'], prefix='', rasterOut=False)

Bases: object

This class implements a convective system descriptor that defines a set of statistical attributes for each system. Note: This class uses dBZ radar calculations.

describe(image, systems)
class tathu.tracking.descriptors.MaxValueGeolocationDescriptor

Bases: object

This class implements a descriptor that calculates geolocation (i.e. latitude and longitude coordinates) of the maximum value found within the system boundaries.

describe(image, systems)
class tathu.tracking.descriptors.MovementDescriptor

Bases: object

This class implements a convective system descriptor that computes the movement parameters (velocity, u, v and direction).

describe(previous, current)
class tathu.tracking.descriptors.NormalizedAreaExpansionDescriptor(scale=None)

Bases: object

This class implements a convective system descriptor that computes the normalized area expansion.

describe(previous, current)
class tathu.tracking.descriptors.OpticalFlowDescriptor(previousImage)

Bases: object

This class implements a descriptor that computes the median optical flow for each system.

describe(image, systems)
class tathu.tracking.descriptors.StatisticalDescriptor(stats=['min', 'mean', 'std', 'count'], prefix='', rasterOut=False, all_touched=False)

Bases: object

This class implements a convective system descriptor that defines a set of statistical attributes for each system.

describe(image, systems)
class tathu.tracking.descriptors.StatisticalDescriptorMT(stats=['min', 'mean', 'std', 'count'], prefix='', rasterOut=False)

Bases: object

* Note: Experimental multithread version. * This class implements a convective system descriptor that defines a set of statistical attributes for each system.

describe(image, systems)
tathu.tracking.descriptors.chunks(data, n)

Yield successive n-sized chunks from a slice-able iterable.

tathu.tracking.detectors module

class tathu.tracking.detectors.GreaterThan(value, minarea=None)

Bases: ThresholdDetector

Auxiliary class that can be used to detect system GreaterThan (>) operator.

class tathu.tracking.detectors.GreaterThanOrEqualTo(value, minarea=None)

Bases: ThresholdDetector

Auxiliary class that can be used to detect system GreaterThanOrEqualTo (>=) operator.

class tathu.tracking.detectors.LessThan(value, minarea=None)

Bases: ThresholdDetector

Auxiliary class that can be used to detect system LessThan operator.

class tathu.tracking.detectors.LessThanOrEqualTo(value, minarea=None)

Bases: ThresholdDetector

Auxiliary class that can be used to detect system LessThanOrEqualTo (<=) operator.

class tathu.tracking.detectors.MultiThresholdDetector(thresholds, op, minareas=None)

Bases: object

This class implements a convective system detector that uses multi-thresholding operations.

detect(image)
class tathu.tracking.detectors.RangeThresholdDetector(min, max, minarea=None)

Bases: object

This class implements a convective system detector that uses thresholding operation based on a given range [min, max].

detect(image)
class tathu.tracking.detectors.ThresholdDetector(value, op, minarea=None)

Bases: object

This class implements a convective system detector that uses thresholding operation.

detect(image)
class tathu.tracking.detectors.ThresholdOp(value)

Bases: Enum

Enumeration that represents threshold operators.

GREATER_THAN = (2,)
GREATER_THAN_OR_EQUAL_TO = 3
LESS_THAN = (0,)
LESS_THAN_OR_EQUAL_TO = (1,)
class tathu.tracking.detectors.WatershedDetector(value, op, pickMinDistance, minarea=None)

Bases: object

This class implements a convective system detector that uses an image processng method called watershed.

detect(image)

tathu.tracking.forecasters module

class tathu.tracking.forecasters.Conservative(previous, intervals, applyScale=False)

Bases: object

This class implements a conservative forecaster.

forecast(current)
tathu.tracking.forecasters.compute_distance(p1, p2)
tathu.tracking.forecasters.compute_elapsed_time(sys)
tathu.tracking.forecasters.compute_last_centroid(sys)
tathu.tracking.forecasters.compute_scale_factor(sys, elapsed_time=1.0)
tathu.tracking.forecasters.delta(p1, p2, elapsed_time=1.0)

tathu.tracking.system module

class tathu.tracking.system.ConvectiveSystem(geom)

Bases: object

This class represents a convective system.

addAtributes(attrs)
fitEllipse()
getAttrNames()
getCentroid()
getConvexHull()
getGeomWKT()
getMBR()

This method get the extent from OGRGeometry encapsulated by system object. The retrieved extent is converted automatically to interleaved representation.

getRelationshipNames()
getRelationshipNamesAsString(separator=' ')
hasGeom()
class tathu.tracking.system.ConvectiveSystemFamily

Bases: object

This class represents a convective system family, i.e. the convective system spatio-temporal history.

addSystem(system)
getAttribute(attr)
getCentroids()
getConvexHulls()
getEllipses()
getEvents()
getExtent()
getPolygons()
getRasters()
getTimestamps()
hasSplitOrMerge()
class tathu.tracking.system.ConvectiveSystemManager(systems)

Bases: object

This class implements a manager for convective systems objects.

getSystemsFromExtent(e)
getSystemsFromGeom(geom)
getSystemsFromSystem(system)
class tathu.tracking.system.LifeCycleEvent(value)

Bases: Enum

Enumeration that represents the life cycle events of convective systems.

CONTINUITY = 2
INTERPOLATION = 5
MERGE = 4
NATURAL_DISSIPATION = 1
SPLIT = 3
SPONTANEOUS_GENERATION = 0

tathu.tracking.trackers module

class tathu.tracking.trackers.AbsoluteOverlapAreaStrategy(threshold)

Bases: OverlapAreaStrategy

Absolute value strategy: it computes the intersection area and compares with the given area threshold.

hasRelationship(current_system, previous_system)
class tathu.tracking.trackers.EdgeTracker(previous)

Bases: object

This class implements a convective system tracker that verifies topology at edges. It can be used on global data, e.g. mosaic of satellite images covering the Earth territory.

track(current)
class tathu.tracking.trackers.IntersectsStrategy

Bases: OverlapAreaStrategy

hasRelationship(current_system, previous_system)
class tathu.tracking.trackers.OverlapAreaStrategy

Bases: object

hasIntersection(current_system, previous_system)
hasRelationship(current_system, previous_system)
class tathu.tracking.trackers.OverlapAreaTracker(previous, strategy, picker=<function pick_system_by_max_area>)

Bases: object

This class implements a convective system tracker that uses the overlap area criterion.

track(current)
class tathu.tracking.trackers.RelativeOverlapAreaStrategy(threshold)

Bases: OverlapAreaStrategy

‘Relative value strategy: it computes the intersection area and compares with the area of current system using percent relation.

hasRelationship(current_system, previous_system)
class tathu.tracking.trackers.TitanStrategy(threshold=0.5)

Bases: OverlapAreaStrategy

TITAN Strategy: Thunderstorm Identification, Tracking, Analysis and Nowcasting. More info: http://www.rap.ucar.edu/projects/titan/home/storm_tracking.php

hasRelationship(current_system, previous_system)
tathu.tracking.trackers.pick_system_by_max_area(systems)
tathu.tracking.trackers.pick_system_by_max_intensity(systems)

tathu.tracking.utils module

tathu.tracking.utils.area2degrees(km2)
tathu.tracking.utils.copyImage(image)
tathu.tracking.utils.polygonize(image, minArea=None, progress=None)
tathu.tracking.utils.verify_edges(extent, systems)

Module contents