Package: pathviewr 1.1.8

pathviewr: Wrangle, Analyze, and Visualize Animal Movement Data

Tools to import, clean, and visualize movement data, particularly from motion capture systems such as Optitrack's 'Motive', the Straw Lab's 'Flydra', or from other sources. We provide functions to remove artifacts, standardize tunnel position and tunnel axes, select a region of interest, isolate specific trajectories, fill gaps in trajectory data, and calculate 3D and per-axis velocity. For experiments of visual guidance, we also provide functions that use subject position to estimate perception of visual stimuli.

Authors:Vikram B. Baliga [aut, cre], Melissa S. Armstrong [aut], Eric R. Press [aut], Anne-Sophie Bonnet-Lebrun [rev], Marco Sciaini [rev]

pathviewr_1.1.8.tar.gz
pathviewr_1.1.8.zip(r-4.7)pathviewr_1.1.8.zip(r-4.6)pathviewr_1.1.8.zip(r-4.5)
pathviewr_1.1.8.tgz(r-4.6-any)pathviewr_1.1.8.tgz(r-4.5-any)
pathviewr_1.1.8.tar.gz(r-4.7-any)pathviewr_1.1.8.tar.gz(r-4.6-any)
pathviewr_1.1.8.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
pathviewr/json (API)

# Install 'pathviewr' in R:
install.packages('pathviewr', repos = c('https://vbaliga.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/ropensci/pathviewr/issues

Pkgdown/docs site:https://docs.ropensci.org

On CRAN:

Conda:

animal-movementflydramotionmovement-dataoptitracktrajectoriestrajectory-analysisvisual-guidancevisual-perception

7.59 score 11 stars 2 packages 132 scripts 442 downloads 47 exports 38 dependencies

Last updated from:54d6569845. Checks:9 OK. Indexed: no.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK163
source / vignettesOK302
linux-release-x86_64OK194
macos-release-arm64OK220
macos-oldrel-arm64OK220
windows-develOK150
windows-releaseOK169
windows-oldrelOK135
wasm-releaseOK159

Exports:%>%as_viewrbind_viewr_objectscalc_min_dist_boxcalc_min_dist_vclean_by_spanclean_viewrclean_viewr_batchdeg_2_radexclude_by_velocityfill_traj_gapsfind_curve_elbowgather_tunnel_dataget_2d_angleget_3d_angleget_3d_cross_prodget_dist_point_lineget_full_trajectoriesget_header_viewrget_sfget_traj_velocitiesget_velocityget_vis_angleimport_and_clean_batchimport_and_clean_viewrimport_batchinsert_treatmentsplot_by_subjectplot_viewr_trajectoriesquick_separate_trajectoriesrad_2_degread_flydra_matread_motive_csvredefine_tunnel_centerrelabel_viewr_axesremove_duplicate_framesrename_viewr_charactersrescale_tunnel_datarm_by_trajnumrotate_tunnelsection_tunnel_byselect_x_percentseparate_trajectoriesset_traj_frametimestandardize_tunneltrim_tunnel_outliersvisualize_frame_gap_choice

Dependencies:clicowplotcpp11data.tabledplyrfANCOVAfarvergenericsggplot2gluegtableisobandlabelinglifecyclelubridatemagrittrpillarpkgconfigpurrrR.matlabR.methodsS3R.ooR.utilsR6RColorBrewerrlangS7scalesstringistringrtibbletidyrtidyselecttimechangeutf8vctrsviridisLitewithr

Estimating visual perceptions from tracking data
Introduction | Data preparation | Add experiment information with insert_treatments() | V-shaped tunnel example | Box-shaped tunnel example | Calculating visual angles | Start by calculating distances to visual stimuli | Now get visual angles | Calculating spatial frequency | Stay tuned as additional features for image motion estimation are coming soon!
Rendered fromvisual-perception-functions.Rmdusingknitr::rmarkdown

Last update: 2022-08-21
Started: 2020-09-21

Managing frame gaps with pathviewr
Defining trajectories with pathviewr | Inspecting the data | Visualize frame gap choice | Autodetect
Rendered frommanaging-frame-gaps.Rmdusingknitr::rmarkdown

Last update: 2022-08-18
Started: 2020-09-02

Basics of data import and cleaning in pathviewr
Overview | What do movement data sets look like? | Data import via pathviewr | Motive CSV files | Flydra Matlab files | Data from other sources | Data cleaning | Relabeling axes, gathering data columns, and trimming outliers | Standardization of tunnel position and coordinates | Selecting a region of interest | Isolating each trajectory | Retain only complete trajectories | All-in-one cleaning functions
Rendered fromdata-import-cleaning.Rmdusingknitr::rmarkdown

Last update: 2021-04-19
Started: 2020-07-27

Readme and manuals

Help Manual

Help pageTopics
Convert data from another format into a viewr objectas_viewr
Bind viewr objectsbind_viewr_objects
Calculate minimum distance to lateral and end walls in a box-shaped experimental tunnelcalc_min_dist_box
Calculate minimum distance to lateral and end walls in a V-shaped experimental tunnelcalc_min_dist_v
Remove file_sub_traj entries that do not span the full region of interestclean_by_span
All-in-one function to clean imported objectsclean_viewr
Batch clean viewr filesclean_viewr_batch
Convert degrees to radiansdeg_2_rad
Remove trajectories entirely, based on velocity thresholdsexclude_by_velocity
Interpolate gaps within trajectoriesfill_traj_gaps
Find the "elbow" of a curve.find_curve_elbow
Gather data columns into key-value pairsgather_tunnel_data
Compute an angle in 2D spaceget_2d_angle
Compute an angle in 3D spaceget_3d_angle
Compute the cross product of two 3D vectorsget_3d_cross_prod
Compute distance between a point and a lineget_dist_point_line
Retain trajectories that span a selected region of interestget_full_trajectories
Extract header info from imported viewr objectget_header_viewr
Estimate the spatial frequency of visual stimuli from the subject's perspective in an experimental tunnel.get_sf
Recompute trajectory-specific velocitiesget_traj_velocities
Get instantaneous velocity for subjectsget_velocity
Estimate visual angles from a subject's perspective in an experimental tunnelget_vis_angle
Batch import and clean filesimport_and_clean_batch
Import + clean_viewr()import_and_clean_viewr
Batch import of files for either Motive or Flydra (but not a mix of both)import_batch
Inserts treatment and experiment informationinsert_treatments
Plot trajectories and density plots of position by subjectplot_by_subject
Plot each trajectory within a viewr objectplot_viewr_trajectories
Quick version of separate_trajectories()quick_separate_trajectories
Convert radians to degreesrad_2_deg
Import data from a MAT file exported from Flydra softwareread_flydra_mat
Import data from a CSV exported from Optitrack's Motive softwareread_motive_csv
"Center" the tunnel data, i.e. translation but no rotationredefine_tunnel_center
Relabel the dimensions as length, width, and heightrelabel_viewr_axes
Remove any duplicates or aliased frames within trajectoriesremove_duplicate_frames
Remove any rows which show sharp shifts in velocity that are likely due to tracking errorsremove_vel_anomalies
Rename subjects in the data via pattern detectionrename_viewr_characters
Rescale position data within a 'viewr' objectrescale_tunnel_data
Remove subjects by trajectory numberrm_by_trajnum
Rotate a tunnel so that perches are approximately alignedrotate_tunnel
Bin data along a specified axissection_tunnel_by
Select a region of interest within the tunnelselect_x_percent
Separate rows of data into separately labeled trajectories.separate_trajectories
Redefine frames and time stamps on a per-trajectory basisset_traj_frametime
Rotate and center a tunnel based on landmarksstandardize_tunnel
Trim out artifacts and other outliers from the extremes of the tunneltrim_tunnel_outliers
Visualize the consequence of using various max_frame_gap valuesvisualize_frame_gap_choice