hurahura - formerly miresearch
Organisation and automation tools for medical imaging research data
hurahura is māori for "to investigate" or "to look around"
Installation:
pip install hurahura
# formerly: pip install imaging-research
About
This is a collection of classes for following OOP principles for organisation of research data for medical imaging research studies.
The intention is to provide a framework that will store imaging data on a "per examination" basis in a structured format. This structured format then permits simple interrogation, and automation.
It takes advantage of the dicom standard and the package spydcmtk for automating and generalising many typical steps with the intention of making the researcher's life easier.
This package may be easily adapted and expanded upon for a high level control over your research data. Or, it may be used as is for basic structure and organisation of data and automation of common tasks.
Class structure
AbstractSubject class is top level class taking inputs:
- subjectNumber : an integer
- dataRoot : the root directory where subjects to be stored
- subjectPrefix : a prefix to be combined with subjectNumber for naming each subject
- Optional: will be guessed from subjects already present in dataRoot if not given.
- DIRECTORY_STRUCTURE_TREE : DirectoryStructureTree class to define directory structure for each subject directory (see wiki for construction shortcuts)
- Optional: Defaults to RAW and META directories.
This is the basic parent class containing fundamental methods for organisation and management. See hurahura docs for advanced usage, epsecially via inheritance and polymorphism.
Configuration
hurahura uses a miresearch.conf file for configuration.
By default miresearch.conf files are search for in the following locations:
- source_code_directory/miresearch.conf (file with default settings)
- $HOME/miresearch.conf
- $HOME/.miresearch.conf
- $HOME/.config/miresearch.conf
- Full file path defined at environment variable: "MIRESEARCH_CONF"
- Full path passed as commandline argument to
hurahura
Files are read in the above order with each subsequent variable present overwritting any previously defined. For information on files found and variables used run:
hurahura -INFO
File system watcher
hurahura can watch a directory for new subjects and load them into the system. This works nicely with AUTORTHANC
hurahura -WatchDirectory /path/to/watch_directory
UI
hurahura can be run with a UI for easy management of subjects and data.
hurahura -UI
Documentation
For full documentation see hurahura docs
1 maintainer
Release files for hurahura 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hurahura-0.2.2.tar.gz | 46.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hurahura-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 97.6 kB
Release files / hurahura-0.2.2.tar.gz
| Download URL | hurahura-0.2.2.tar.gz |
|---|---|
| Size | 46.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5a9c879cdd1b83bbe6dba6143c89d8bc26b842a274c8d3499bec9bb27835df71
|
|
BLAKE2b-256 checksum How to use checksums |
43d2dcaab5b16bf8053fcf5a7c7ef89620f41cb742f17f6f4d1d9f13a2b5503a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.12
|
Release files / hurahura-0.2.2-py3-none-any.whl
| Download URL | hurahura-0.2.2-py3-none-any.whl |
|---|---|
| Size | 51.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab8c7e52bad485a0fbf6c8f920d6a379917639397fd37717712ccff72a0ad977
|
|
BLAKE2b-256 checksum How to use checksums |
85c2ea1eb3842fac1e1157041e1211b60ce502bab316ff2ead0731ee323ec0c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.12
|
