FLOCK.PacsFeats
index
c:\users\james\gitrepos\gps-ruck\flock\pacsfeats.py

Functions for extracting features from the Path Adapted Coordinate System (PACS) transformed data
 
Including spatial exploraion index, neighbor distance, and distribution consistency measures

 
Modules
       
numpy
pandas

 
Functions
       
LW_ratio(movement_slices_oriented)
get the length to width ratio
furthest separation front/back (length) divided by furthest separation side/side (width)
 
Args:
    movement_slices_oriented (list): list of oriented dataset dfs
 
Returns:
    LW_ratios (list): list of L/W ratios over time for each movement period
dist_consistency_Ftest(movement_slices_oriented, names)
Measure the consistency of soldier positions across movement periods
F-test statistic as a metric for each soldier's oriented position consistency across movement periods
 
Args:
    movement_slices_oriented (list): list of oriuented datasets as dfs
    names (list): list of soldier names
 
Returns:
    X_ftest (Series): A series of F-statistic values for each soldier in the X axis
    Y_ftest (Series): A series of F-statistic values for each soldier in the Y axis
dist_consistency_wasserstein(movement_slices_oriented, names)
get the wasserstein distance, a metric for each soldier's PACS location consistency across movement periods
 
Args:
    movement_slices_oriented (list): oriented soldier positions for movement periods
    names (list): list of names.
 
Returns:
    X_wass_df: (Series): average Wasserstein distance for each soldier in the X axis
    Y_wass_df: (Series): average Wasserstein distance for each soldier in the Y axis
get_SEIs(movement_slices_oriented, names)
get the spatial explioration index for each soldier during each movement period from oriented data
SEI is considered the distance of a soldier from their own average location during a movement period
we include distances over the whole period, so that mean, max ect can be captured elsewhere
 
Args:
    movement_slices_oriented (list): list of oriented dataset dfs
    names (list): list of names
 
Returns:
    SEIs (list): list of dataframes with the individuals SEI (distance to their mean location) over time for each movement period
get_neighbor_dists(move_slices_oriented, names)
Get distance to nearest neightbor
both left/right and front/back (X and Y)
 
Args:
    move_slices_oriented (list): list of oriented dataset dfs
    names (list): list of names
 
Returns:
    x_neighbors (list): list of dfs with nearest neighbor distances in the X direction
    y_neighbors (list): list of dfs with nearest neighbor distances in the Y direction