Skip to content

A template to accelerate the release of state of the art software accompanying papers released at Prof. Hamarneh's medicalimageanalysis.com

License

Notifications You must be signed in to change notification settings

sfu-mial/mial-hamarneh-repository-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mysoftware

Motivation

Short description of

  • problem in field (e.g. cancer)
  • what is current solution (handdrawn segmentation)
  • what this software does to solve it (sota segmentation)
  • proposed impact (accelerated/accurate diagnosis)

Status

CircleCI License: AGPL v3

Installation

Local

git clone <thisrepo>
# build instructions
Pip
pip install mysoftware
Conda
conda install mysoftware

or using the environment

conda env create --name myproject --file=myproject.yml

Container

Singularity
Building from recipes
sudo singularity build container/singularityrecipe.def
Released images
singularity pull repo:image.version

Test

To run the tests ensuring the installation is valid, please run

python -m mymodule.testmycode

Which should result in

Usage

Example snippets

Example inference on in silico data

import seaborn as sns
import mysoftware.preprocessing as stk
import numpy as np
np.random.seed(42)
silico_data = stk.generate_insilico(args)
q = stk.infer(silico_data)
sns.boxplot(x='method', y='accuracy', data=q)

Notebooks

See notebooks/example.ipynb for an example interactive workflow.

API

See TODO for the complete API documentation

Cite

[your citation here]

Reproducing our published results

Data

In silico

See [mysoftware/insilico] on how to generate our in silico datasets. For your convenience, this can be downloaded as well:

mkdir insilico && cd insilico
wget -O insilico.hdf5 https://mydatarepo/insilico.hdf5
Real world
mkdir mydata
wget -O dataset.hdf5 https://mydatarepo/dataset.hdf5

Ensure the checksums match

md5sum dataset.hdf5

should produce

4a4f224c7b7c871855fd307ae323be93 dataset.hdf5

Pre/post processing code

See scripts/preprocessing.py for the preprocessing scripts that configure the dataset and generate the plots

FAQ

Help I can't figure out how function5 works

Please create a new issue detailing concisely, yet complete what issue you encountered, in a reproducible way.

About

A template to accelerate the release of state of the art software accompanying papers released at Prof. Hamarneh's medicalimageanalysis.com

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages