FrameTree

FrameTree is Python framework that is used to map categorical data organised into trees (e.g. MRI sessions for multiple subjects and visits saved in a file-system directory) onto virtual "data frames" for analysis. Cells in these data frames can be scalars, arrays or a set of files and/or directories stored at each node across a level in the given tree. Derivatives are stored, along with the parameters used to derive them, back into the store for reference and reuse by subsequent analysis steps. Extracted metrics can be exported to actual data frames for statistical analysis.

Documentation

Detailed documentation on FrameTree can be found at https://frametree.readthedocs.io

Quick Installation

FrameTree can be installed for Python 3 using pip

    python3 -m pip install frametree

Extensions for backends

Support for specific data repository platforms software or data structures (e.g. XNAT or BIDS) are provided by extension packages (see frametree-xnat and frametree-bids). They can be installed with

    python3 -m pip install frametree-xnat frametree-bids

See the extension template to get started with support for different backends

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

Acknowledgements

The authors acknowledge the facilities and scientific and technical assistance of the National Imaging Facility, a National Collaborative Research Infrastructure Strategy (NCRIS) capability.