recolo.data_structures.fieldstack.kinematic_fields_from_deflections

recolo.data_structures.fieldstack.kinematic_fields_from_deflections(defl_fields, pixel_size, sampling_rate, acceleration_field=None, filter_space_sigma=None, filter_time_sigma=None)

Calculate kinematic fields from a series of deflection fields. The following fields are calculated are:

  • Slopes

  • Curvatures

  • Out of plane acceleration

defl_fieldsndarray

The deflection fields with shape [frame,x,y]

pixel_sizefloat

The physical pixel size

sampling_ratefloat

The sampling rate at which the fields are acquired

acceleration_fieldndarray (Optional)

The deflection fields with shape [frame,x,y] If given, the acceleration fields are not determined by differentiation of the deflection fields along the time axis.

filter_space_sigmafloat

The standard deviation of the gaussian low-pass filter used to filter the deflection fields spatially prior to differentiation.

filter_time_sigmafloat

The standard deviation of the gaussian low-pass filter used to filter the deflection fields temporally prior to differentiation.

fieldstackFieldStack

The kinematic fields