ActiPASS FAQ and troubleshooting - Ergo-Tools/ActiPASS GitHub Wiki

ActiPASS FAQ

Some of the frequently asked questions are listed below. If your specific question is not mentioned in this wiki page, perhaps it is already discussed at ActiPASS discussions. Otherwise raise your question there.

General questions

  • How can get help processing, quality checking, understanding variables and generating statistics?

    Please use Github discussions. Use the section "Help with processing, quality checking or generating statistics". Be concise and very specific. Attach execution logs and quality check figures if applicable. Remove sensitive information from files you attach.

  • How can I give feedback?

    Please use Github discussions.

  • How can I report a bug?

    Please use Github discussions. Use the section "Report a bug". Be concise and very specific. Attach execution logs and quality check figures if applicable. Remove sensitive information from files you attach.

  • Can I use ActiPASS with chort "XXXXXX" who are not healthy adults or have special physical or sedentary behaviours?

    ActiPASS algorithms are validated against healthy adults populations. However it might be possible to use ActiPASS with other populations. Also it might be necessary to disable (or ignore) certain detection of certain behaviours (like sleep, stair-walking, bicycling etc.)

  • Is ActiPASS free software?

    Yes, it's free to use. Please read the license terms.

  • Is ActiPASS open source?

    Our aim is to always publish all ActiPASS algorithms and workflow as open source. Currently all algorithms are available as open source except code related GUI itself and workflow controlled by the GUI.

  • How do I renew an expired license?

    To renew an expired license, please follow the guide Renew an existing license.

  • How do I uninstall ActiPASS?

    First uninstall the Matlab runtime from Windows "Add or Remove Programs". Then delete the folder containing ActiPASS executable files.

  • How do I reset ActiPASS settings to defaults?

    ActiPASS default settings are called "ProPASS" settings. Press "Edit -> ProPASS mode -> Set all settings to ProPASS defaults"

  • How do I enable ActiPASS advanced mode of processing?

    Press "Edit -> ProPASS mode -> Disable ProPASS mode". In order to do this ActiPASS advanced mode license is required.

  • How do I disable ActiPASS advanced mode and enable ProPASS mode?

    ActiPASS default settings are called "ProPASS" settings. Press "Edit -> ProPASS mode -> Set all settings to ProPASS defaults"

  • Does ActiPASS connect to internet (and talk to mothership)?

    No. ActiPASS works completely offline. It will open the default browser for displaying help.

  • Does ActiPASS collect usage statistics or any other information from user?

    No. No usage statistics are collected.

Questions related to Processing accelerometer data

  • How can I add accelerometer files to a batch if they exist in their own folders?

    See accelerometer file lists

  • How to run a batch process with only a selected list of accelerometer files?

    See accelerometer file lists

  • If ActiPASS has automatic orientation detection, why is it necessary to specify orientation?

    See Adding accelerometer files section 1

  • How automatic orientation detection work?

    It uses walking detection based on frequency profiling vector magnitude for detecting rotations (upside down) and a crude "Sit" detection for identifying flips (inside out).

  • What is accelerometer device specific calibration?

    It accounts for small sensor errors using free living data using the autocalibration algorithm by Hees et al..

  • What is participant specific calibration (called reference-positions)?

    This is called reference-positions in ActiPASS terminology. This process accounts for the individual factors (such as shape of thigh, walking gait) and accelerometer placement deviations. ActiPASS uses periods of walking to do such an individual calibration.

Questions related to quality checking ActiPASS output

  • What are ActiPASS quality-check visualization and how to use them?

    See Quality checking a project

  • Can you give some hints for efficient quality-checking?

    Make full use of the quality check figures. One can browser through them very fast and still see peculiar patterns in activities/behaviours. Also don't forget to read Quality checking a project

Questions related to variables and stats generation process

  • What are ActiPASS outlier and exclusion criteria?

    Under ProPASS mode ActiPASS exclude days according to ProPASS daily validity criteria

  • How can I exclude certain participants (files) from statistics?

    The stats generation module takes the "QC_Status" column of ActiPASS_QC_MasterFile.xlsx into consideration. Set "QC_Status" to "NotOK" to manually exclude participants from final statistics.

  • How can I have my own daily validity criteria?

    The file ActiPASS_Daily_LongFormat_MasterFile.csv include all days with accelerometer data. Use this file and include/exclude days according to your own validation criteria. This file already contains valuable quality check flags which can be used derive such a customized validity criteria.

  • Can you add variable "X" which defines "XXXXXXXXX"?

Troubleshooting

  • ActiPASS crashed, what can I do now?

    Please use Github discussions. Use the section "Report a bug". Be concise and very specific.

  • ActiPASS produces unrealistic results (or complete garbage). What went wrong?

    Please use Github discussions. Use the section "Report a bug". Be concise and very specific.

  • ActiPASS is slow to process data. Is it possible to make it faster?

    Set the "visualization" level to "QC" or "none". However no visualizations are not recommended.