get_vortex_properties#
- sunkit_image.asda.get_vortex_properties(vx, vy, edge_prop, image=None)[source]#
Calculate expanding, rotational speed, equivalent radius and average intensity of given swirls.
- Parameters:
vx (
numpy.ndarray
) – Velocity field in the x direction.vy (
numpy.ndarray
) – Velocity field in the y direction.edge_prop (
dict
) – The keys and their meanings of the dictionary are:center
: Center locations of vortices, in the form of[x, y]
.edge
: Edge locations of vortices, in the form of[x, y]
.points
: All points within vortices, in the form of[x, y]
.peak
: Maximum/minimum gamma1 values in vortices.radius
: Equivalent radius of vortices. All results are in pixel coordinates.image (
numpy.ndarray
) – Has to have the same shape asvx
observational image, which will be used to calculate the average observational values of all swirls.
- Returns:
tuple
– The returned tuple has four components, which are:ve
: expanding speed, in the same unit asvx
orvy
.vr
: rotational speed, in the same unit asvx
orvy
.vc
: velocity of the center, in the form of[vx, vy]
.ia
: average of the observational values within the vortices if the parameter image is given.