to_lp_file#

movement.io.save_poses.to_lp_file(ds, file_path)[source]#

Save a movement dataset to a LightningPose file.

Parameters:

ds (xarray.Dataset) – movement dataset containing pose tracks, confidence scores, and associated metadata.
file_path (pathlib.Path or str) – Path to the file to save the poses to. File extension must be .csv.

Return type:

None

Notes

LightningPose saves pose estimation outputs as .csv files, using the same format as single-animal DeepLabCut projects. Therefore, under the hood, this function calls movement.io.save_poses.to_dlc_file() with split_individuals=True. This setting means that each individual is saved to a separate file, with the individual’s name appended to the file path, just before the file extension, i.e. “/path/to/filename_individual1.csv”.