{ "_id": "69ca3fd17ce0fc79f21e3963", "Package": "pathviewr", "Title": "Wrangle, Analyze, and Visualize Animal Movement Data", "Version": "1.1.8", "Authors@R": "c(person(given = \"Vikram B.\",\nfamily = \"Baliga\",\nrole = c(\"aut\", \"cre\"),\nemail = \"vbaliga87@gmail.com\",\ncomment = c(ORCID = \"0000-0002-9367-8974\")),\nperson(given = \"Melissa S.\",\nfamily = \"Armstrong\",\nrole = \"aut\",\nemail = \"melissa.armstrong@gmail.com\",\ncomment = c(ORCID = \"0000-0002-3059-0094\")),\nperson(given = \"Eric R.\",\nfamily = \"Press\",\nrole = \"aut\",\nemail = \"epress12@gmail.com\",\ncomment = c(ORCID = \"0000-0002-1944-3755\")),\nperson(given = \"Anne-Sophie\",\nfamily = \"Bonnet-Lebrun\",\nrole = \"rev\"),\nperson(given = \"Marco\",\nfamily = \"Sciaini\",\nrole = \"rev\")\n)", "Description": "Tools to import, clean, and visualize movement data,\nparticularly from motion capture systems such as Optitrack's\n'Motive', the Straw Lab's 'Flydra', or from other sources. We\nprovide functions to remove artifacts, standardize tunnel\nposition and tunnel axes, select a region of interest, isolate\nspecific trajectories, fill gaps in trajectory data, and\ncalculate 3D and per-axis velocity. For experiments of visual\nguidance, we also provide functions that use subject position\nto estimate perception of visual stimuli.", "Maintainer": "Vikram B. Baliga ", "License": "GPL-3", "Encoding": "UTF-8", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.1", "VignetteBuilder": "knitr", "URL": "https://github.com/ropensci/pathviewr/,\nhttps://docs.ropensci.org/pathviewr/", "BugReports": "https://github.com/ropensci/pathviewr/issues/", "Config/pak/sysreqs": "libicu-dev", "Repository": "https://ropensci.r-universe.dev", "Date/Publication": "2025-06-13 20:05:39 UTC", "RemoteUrl": "https://github.com/ropensci/pathviewr", "RemoteRef": "master", "RemoteSha": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "NeedsCompilation": "no", "Packaged": { "Date": "2026-03-30 09:13:48 UTC", "User": "root" }, "Author": "Vikram B. Baliga [aut, cre] (ORCID:\n),\nMelissa S. Armstrong [aut] (ORCID:\n),\nEric R. Press [aut] (ORCID: ),\nAnne-Sophie Bonnet-Lebrun [rev],\nMarco Sciaini [rev]", "MD5sum": "f1578dcdee737de239a033693c557395", "_user": "ropensci", "_type": "src", "_file": "pathviewr_1.1.8.tar.gz", "_fileid": "c3f393a86358deccf81f1bfa016fc806f3fa76b2e03e9e7a0c5310048db7567c", "_filesize": 5320640, "_sha256": "c3f393a86358deccf81f1bfa016fc806f3fa76b2e03e9e7a0c5310048db7567c", "_created": "2026-03-30T09:13:48.000Z", "_published": "2026-03-30T09:18:09.345Z", "_distro": "noble", "_jobs": [ { "job": 69144536113, "time": 194, "config": "linux-devel-x86_64", "r": "4.6.0", "check": "OK", "artifact": "6174715019" }, { "job": 69144536011, "time": 204, "config": "linux-release-x86_64", "r": "4.5.3", "check": "OK", "artifact": "6174717546" }, { "job": 69144536034, "time": 124, "config": "macos-devel-arm64", "r": "4.6.0", "check": "OK", "artifact": "6174694689" }, { "job": 69144536090, "time": 131, "config": "macos-release-arm64", "r": "4.5.3", "check": "OK", "artifact": "6174696878" }, { "job": 69143932789, "time": 192, "config": "pkgdown", "r": "4.5.2", "check": "OK", "artifact": "6174639831" }, { "job": 69143932780, "time": 261, "config": "source", "r": "4.5.3", "check": "OK", "artifact": "6174658929" }, { "job": 69144536018, "time": 158, "config": "wasm-release", "r": "4.5.1", "check": "OK", "artifact": "6174704628" }, { "job": 69144536029, "time": 134, "config": "windows-devel", "r": "4.6.0", "check": "OK", "artifact": "6174697602" }, { "job": 69144536044, "time": 139, "config": "windows-release", "r": "4.5.3", "check": "OK", "artifact": "6174699473" } ], "_buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/ropensci/pathviewr", "_commit": { "id": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "author": "vbaliga ", "committer": "vbaliga ", "message": "work out small bugs for 1.1.8\n", "time": 1749845139 }, "_maintainer": { "name": "Vikram B. Baliga", "email": "vbaliga87@gmail.com", "login": "vbaliga", "orcid": "0000-0002-9367-8974", "uuid": 9795391 }, "_registered": true, "_dependencies": [ { "package": "R.matlab", "role": "Imports" }, { "package": "data.table", "version": ">= 1.12.2", "role": "Imports" }, { "package": "magrittr", "version": ">= 1.5", "role": "Imports" }, { "package": "dplyr", "version": ">= 1.0.0", "role": "Imports" }, { "package": "stringr", "version": ">= 1.4.0", "role": "Imports" }, { "package": "tibble", "version": ">= 3.0.1", "role": "Imports" }, { "package": "tidyr", "version": ">= 1.1.0", "role": "Imports" }, { "package": "fANCOVA", "role": "Imports" }, { "package": "purrr", "version": ">= 0.3.3", "role": "Imports" }, { "package": "ggplot2", "version": ">= 3.4.0", "role": "Imports" }, { "package": "tidyselect", "version": ">= 1.1.0", "role": "Imports" }, { "package": "cowplot", "role": "Imports" }, { "package": "lubridate", "role": "Imports" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "testthat", "role": "Suggests" }, { "package": "anomalize", "role": "Suggests" }, { "package": "covr", "role": "Suggests" } ], "_owner": "ropensci", "_selfowned": true, "_usedby": 2, "_updates": [ { "week": "2025-19", "n": 4 }, { "week": "2025-24", "n": 3 } ], "_tags": [], "_topics": [ "animal-movement", "flydra", "motion", "movement-data", "optitrack", "trajectories", "trajectory-analysis", "visual-guidance", "visual-perception" ], "_stars": 11, "_contributors": [ { "user": "vbaliga", "count": 334, "uuid": 9795391 }, { "user": "epress12", "count": 170, "uuid": 60632497 }, { "user": "scienceisfiction", "count": 91, "uuid": 17031458 }, { "user": "teunbrand", "count": 1, "uuid": 49372158 } ], "_userbio": { "uuid": 1200269, "type": "organization", "name": "rOpenSci", "description": "Tools and R Packages for Open Science" }, "_downloads": { "count": 364, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/pathviewr" }, "_devurl": "https://github.com/ropensci/pathviewr", "_pkgdown": "https://docs.ropensci.org/pathviewr", "_searchresults": 143, "_metadata": { "review": { "id": 409, "status": "reviewed", "version": "0.9.4", "organization": "rOpenSci Software Review", "url": "https://github.com/ropensci/software-review/issues/409" }, "ropensci_category": "data-extraction" }, "_rbuild": "4.5.3", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/NEWS.html", "extra/NEWS.txt", "extra/pathviewr.html", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_homeurl": "https://github.com/ropensci/pathviewr", "_realowner": "ropensci", "_cranurl": true, "_releases": [ { "version": "1.0.1", "date": "2021-05-06" }, { "version": "1.1.3", "date": "2022-08-22" }, { "version": "1.1.5", "date": "2022-11-09" }, { "version": "1.1.7", "date": "2023-03-08" }, { "version": "1.1.8", "date": "2025-06-15" } ], "_exports": [ "%>%", "as_viewr", "bind_viewr_objects", "calc_min_dist_box", "calc_min_dist_v", "clean_by_span", "clean_viewr", "clean_viewr_batch", "deg_2_rad", "exclude_by_velocity", "fill_traj_gaps", "find_curve_elbow", "gather_tunnel_data", "get_2d_angle", "get_3d_angle", "get_3d_cross_prod", "get_dist_point_line", "get_full_trajectories", "get_header_viewr", "get_sf", "get_traj_velocities", "get_velocity", "get_vis_angle", "import_and_clean_batch", "import_and_clean_viewr", "import_batch", "insert_treatments", "plot_by_subject", "plot_viewr_trajectories", "quick_separate_trajectories", "rad_2_deg", "read_flydra_mat", "read_motive_csv", "redefine_tunnel_center", "relabel_viewr_axes", "remove_duplicate_frames", "rename_viewr_characters", "rescale_tunnel_data", "rm_by_trajnum", "rotate_tunnel", "section_tunnel_by", "select_x_percent", "separate_trajectories", "set_traj_frametime", "standardize_tunnel", "trim_tunnel_outliers", "visualize_frame_gap_choice" ], "_help": [ { "page": "as_viewr", "title": "Convert data from another format into a viewr object", "concept": "data import functions", "topics": [ "as_viewr" ] }, { "page": "bind_viewr_objects", "title": "Bind viewr objects", "concept": "batch functions", "topics": [ "bind_viewr_objects" ] }, { "page": "calc_min_dist_box", "title": "Calculate minimum distance to lateral and end walls in a box-shaped experimental tunnel", "concept": "visual perception functions", "topics": [ "calc_min_dist_box" ] }, { "page": "calc_min_dist_v", "title": "Calculate minimum distance to lateral and end walls in a V-shaped experimental tunnel", "concept": "mathematical functions", "topics": [ "calc_min_dist_v" ] }, { "page": "clean_by_span", "title": "Remove file_sub_traj entries that do not span the full region of interest", "concept": "utility functions", "topics": [ "clean_by_span" ] }, { "page": "clean_viewr", "title": "All-in-one function to clean imported objects", "concept": "all in one functions", "topics": [ "clean_viewr" ] }, { "page": "clean_viewr_batch", "title": "Batch clean viewr files", "concept": "batch functions", "topics": [ "clean_viewr_batch" ] }, { "page": "deg_2_rad", "title": "Convert degrees to radians", "concept": "mathematical functions", "topics": [ "deg_2_rad" ] }, { "page": "exclude_by_velocity", "title": "Remove trajectories entirely, based on velocity thresholds", "topics": [ "exclude_by_velocity" ] }, { "page": "fill_traj_gaps", "title": "Interpolate gaps within trajectories", "topics": [ "fill_traj_gaps" ] }, { "page": "find_curve_elbow", "title": "Find the \"elbow\" of a curve.", "concept": "mathematical functions", "topics": [ "find_curve_elbow" ] }, { "page": "gather_tunnel_data", "title": "Gather data columns into key-value pairs", "concept": "data cleaning functions", "topics": [ "gather_tunnel_data" ] }, { "page": "get_2d_angle", "title": "Compute an angle in 2D space", "concept": "mathematical functions", "topics": [ "get_2d_angle" ] }, { "page": "get_3d_angle", "title": "Compute an angle in 3D space", "concept": "mathematical functions", "topics": [ "get_3d_angle" ] }, { "page": "get_3d_cross_prod", "title": "Compute the cross product of two 3D vectors", "concept": "mathematical functions", "topics": [ "get_3d_cross_prod" ] }, { "page": "get_dist_point_line", "title": "Compute distance between a point and a line", "concept": "mathematical functions", "topics": [ "get_dist_point_line" ] }, { "page": "get_full_trajectories", "title": "Retain trajectories that span a selected region of interest", "concept": "data cleaning functions", "topics": [ "get_full_trajectories" ] }, { "page": "get_header_viewr", "title": "Extract header info from imported viewr object", "concept": "metadata handling functions", "topics": [ "get_header_viewr" ] }, { "page": "get_sf", "title": "Estimate the spatial frequency of visual stimuli from the subject's perspective in an experimental tunnel.", "concept": "visual perception functions", "topics": [ "get_sf" ] }, { "page": "get_traj_velocities", "title": "Recompute trajectory-specific velocities", "concept": "mathematical functions", "topics": [ "get_traj_velocities" ] }, { "page": "get_velocity", "title": "Get instantaneous velocity for subjects", "concept": "mathematical functions", "topics": [ "get_velocity" ] }, { "page": "get_vis_angle", "title": "Estimate visual angles from a subject's perspective in an experimental tunnel", "concept": "visual perception functions", "topics": [ "get_vis_angle" ] }, { "page": "import_and_clean_batch", "title": "Batch import and clean files", "concept": "batch functions", "topics": [ "import_and_clean_batch" ] }, { "page": "import_and_clean_viewr", "title": "Import + clean_viewr()", "concept": "all in one functions", "topics": [ "import_and_clean_viewr" ] }, { "page": "import_batch", "title": "Batch import of files for either Motive or Flydra (but not a mix of both)", "concept": "batch functions", "topics": [ "import_batch" ] }, { "page": "insert_treatments", "title": "Inserts treatment and experiment information", "concept": "utility functions", "topics": [ "insert_treatments" ] }, { "page": "plot_by_subject", "title": "Plot trajectories and density plots of position by subject", "concept": "plotting functions", "topics": [ "plot_by_subject" ] }, { "page": "plot_viewr_trajectories", "title": "Plot each trajectory within a viewr object", "concept": "plotting functions", "topics": [ "plot_viewr_trajectories" ] }, { "page": "quick_separate_trajectories", "title": "Quick version of separate_trajectories()", "concept": "data cleaning functions", "topics": [ "quick_separate_trajectories" ] }, { "page": "rad_2_deg", "title": "Convert radians to degrees", "concept": "mathematical functions", "topics": [ "rad_2_deg" ] }, { "page": "read_flydra_mat", "title": "Import data from a MAT file exported from Flydra software", "concept": "data import functions", "topics": [ "read_flydra_mat" ] }, { "page": "read_motive_csv", "title": "Import data from a CSV exported from Optitrack's Motive software", "concept": "data import functions", "topics": [ "read_motive_csv" ] }, { "page": "redefine_tunnel_center", "title": "\"Center\" the tunnel data, i.e. translation but no rotation", "concept": "data cleaning functions", "topics": [ "redefine_tunnel_center" ] }, { "page": "relabel_viewr_axes", "title": "Relabel the dimensions as length, width, and height", "concept": "data cleaning functions", "topics": [ "relabel_viewr_axes" ] }, { "page": "remove_duplicate_frames", "title": "Remove any duplicates or aliased frames within trajectories", "concept": "utility functions", "topics": [ "remove_duplicate_frames" ] }, { "page": "remove_vel_anomalies", "title": "Remove any rows which show sharp shifts in velocity that are likely due to tracking errors", "concept": "utility functions", "topics": [ "remove_vel_anomalies" ] }, { "page": "rename_viewr_characters", "title": "Rename subjects in the data via pattern detection", "concept": "data cleaning functions", "topics": [ "rename_viewr_characters" ] }, { "page": "rescale_tunnel_data", "title": "Rescale position data within a 'viewr' object", "topics": [ "rescale_tunnel_data" ] }, { "page": "rm_by_trajnum", "title": "Remove subjects by trajectory number", "topics": [ "rm_by_trajnum" ] }, { "page": "rotate_tunnel", "title": "Rotate a tunnel so that perches are approximately aligned", "concept": "data cleaning functions", "topics": [ "rotate_tunnel" ] }, { "page": "section_tunnel_by", "title": "Bin data along a specified axis", "topics": [ "section_tunnel_by" ] }, { "page": "select_x_percent", "title": "Select a region of interest within the tunnel", "concept": "data cleaning functions", "topics": [ "select_x_percent" ] }, { "page": "separate_trajectories", "title": "Separate rows of data into separately labeled trajectories.", "concept": "data cleaning functions", "topics": [ "separate_trajectories" ] }, { "page": "set_traj_frametime", "title": "Redefine frames and time stamps on a per-trajectory basis", "concept": "utility functions", "topics": [ "set_traj_frametime" ] }, { "page": "standardize_tunnel", "title": "Rotate and center a tunnel based on landmarks", "concept": "data cleaning functions", "topics": [ "standardize_tunnel" ] }, { "page": "trim_tunnel_outliers", "title": "Trim out artifacts and other outliers from the extremes of the tunnel", "concept": "data cleaning functions", "topics": [ "trim_tunnel_outliers" ] }, { "page": "visualize_frame_gap_choice", "title": "Visualize the consequence of using various max_frame_gap values", "concept": "data cleaning functions", "topics": [ "visualize_frame_gap_choice" ] } ], "_pkglogo": "https://github.com/ropensci/pathviewr/raw/master/man/figures/logo.png", "_readme": "https://github.com/ropensci/pathviewr/raw/master/README.md", "_rundeps": [ "cli", "cowplot", "cpp11", "data.table", "dplyr", "fANCOVA", "farver", "generics", "ggplot2", "glue", "gtable", "isoband", "labeling", "lifecycle", "lubridate", "magrittr", "pillar", "pkgconfig", "purrr", "R.matlab", "R.methodsS3", "R.oo", "R.utils", "R6", "RColorBrewer", "rlang", "S7", "scales", "stringi", "stringr", "tibble", "tidyr", "tidyselect", "timechange", "utf8", "vctrs", "viridisLite", "withr" ], "_vignettes": [ { "source": "data-import-cleaning.Rmd", "filename": "data-import-cleaning.html", "title": "Basics of data import and cleaning in pathviewr", "author": "Vikram B. Baliga", "engine": "knitr::rmarkdown", "headings": [ "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" ], "created": "2020-07-27 20:20:52", "modified": "2021-04-19 04:01:30", "commits": 20 }, { "source": "visual-perception-functions.Rmd", "filename": "visual-perception-functions.html", "title": "Estimating visual perceptions from tracking data", "author": "Eric R. Press", "engine": "knitr::rmarkdown", "headings": [ "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!" ], "created": "2020-09-21 15:34:21", "modified": "2022-08-21 01:58:50", "commits": 34 }, { "source": "managing-frame-gaps.Rmd", "filename": "managing-frame-gaps.html", "title": "Managing frame gaps with pathviewr", "author": "Melissa S. Armstrong", "engine": "knitr::rmarkdown", "headings": [ "Defining trajectories with pathviewr", "Inspecting the data", "Visualize frame gap choice", "Autodetect" ], "created": "2020-09-02 16:46:45", "modified": "2022-08-18 05:41:23", "commits": 14 } ], "_score": 7.929122482446255, "_indexed": true, "_nocasepkg": "pathviewr", "_universes": [ "ropensci", "vbaliga" ], "_binaries": [ { "r": "4.6.0", "os": "linux", "version": "1.1.8", "date": "2026-03-30T09:16:42.000Z", "distro": "noble", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "242f3a99b8212818ec84a54c77d441b5f160a6d95dd0243cdd753ff97a3262f6", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.5.3", "os": "linux", "version": "1.1.8", "date": "2026-03-30T09:16:50.000Z", "distro": "noble", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "12e096cde691bd5cac8215241274c6ece004e1c020f5c51551bdf5d941232223", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.6.0", "os": "mac", "version": "1.1.8", "date": "2026-03-30T09:15:44.000Z", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "fd42e6dc1c913066fbba3b5b21811eb16222e825b28d4fe14d5d76e13b08a3c2", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.5.3", "os": "mac", "version": "1.1.8", "date": "2026-03-30T09:15:43.000Z", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "12e03be81501933a0e934c98cc6da0b1b64377635b369c3671f262fa6aa4871c", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.5.1", "os": "wasm", "version": "1.1.8", "date": "2026-03-30T09:16:49.000Z", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "0b139781c324921804ffd9fe0dffcf1c64779e3d1a7328b829c33a6048c1b537", "status": "success", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.6.0", "os": "win", "version": "1.1.8", "date": "2026-03-30T09:15:32.000Z", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "960b1022fc28b918961d3d11767dc417120d0519042c21d89278e2d1a59f5d3d", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" }, { "r": "4.5.3", "os": "win", "version": "1.1.8", "date": "2026-03-30T09:15:39.000Z", "commit": "54d6569845ec1f824161cafd0b72eb7daf6217f5", "fileid": "1510610a630498864bd38a1a9a77bb674e6dd2c911ef795b813c8ca734910590", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ropensci/actions/runs/23736929222" } ] }