From a021d0a2ed3c7b70e9b9130c141ef956583b4b3a Mon Sep 17 00:00:00 2001 From: Marco Duering Date: Wed, 11 Nov 2020 09:03:54 +0100 Subject: [PATCH] v1.7 Singularity Beta --- README.md | 13 ++++++++++--- singularity/README.md | 18 ++++++++++-------- singularity/singularity-psmd.txt | 10 +++++++--- 3 files changed, 27 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 544b149..326d491 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,13 @@ PSMD is a robust, fully-automated and easy-to-implement marker for cerebral smal **For more information on usage, including FAQ, please visit [www.psmd-marker.com](https://www.psmd-marker.com).** +## Usage -## Contents +We recommend downloading one of our [releases](https://github.com/miac-research/psmd/releases) (for a new project, take the latest release). It is best practice to stick with one release in a given project. For even better replicability and traceability, consider using the [container version](https://github.com/miac-research/psmd/tree/main/singularity) of PSMD. + +For more information, please see the project website at [www.psmd-marker.com](https://www.psmd-marker.com). + +## Contents of download packages * `psmd.sh` - Main analysis script * `skeleton_mask_2019.nii.gz` - Updated (2019) skeleton mask image @@ -21,12 +26,14 @@ See the [GitHub releases page](https://github.com/miac-research/psmd/releases) f ## Roadmap of future development -See the [GitHub issues page](https://github.com/miac-research/psmd/issues) for current development topics. +See the [GitHub issues page](https://github.com/miac-research/psmd/issues) for current development topics. If you found a bug or have suggestions for new features, please feel free to open an issue. ## License -BSD 3-clause. Please see the `LICENSE` file provided in this repository. +The script itself is published under the BSD 3-clause license. Please see the `LICENSE` file provided in this repository. + +An [FSL license](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/Licence) is required to run PSMD. ## Support diff --git a/singularity/README.md b/singularity/README.md index ae6137b..9b7d8f1 100644 --- a/singularity/README.md +++ b/singularity/README.md @@ -1,10 +1,12 @@ -# PSMD Singularity Conatiner +# PSMD Singularity Conatainer BETA -Using containers can solve issues arising from dependencies and heterogeneous environments. +**The container version is still in Beta. Please report any bugs on the [issues page](https://github.com/miac-research/psmd/issues). + +Using containers can solve problems arising from dependencies and heterogeneous environments. Singularity is a well-established container solution, developed with scientific computing and deployment on HPC infrastructure (compute cluster) in mind. -This singularity recipe installs FSL 6.0.3 and the latest version of the PSMD script into a container using Ubuntu Bionic as the operating system. +This singularity recipe installs FSL 6.0.3 and the latest version of the PSMD script into a container using Ubuntu Bionic as operating system. > If you want to build the container with a specific version of PSMD, please see the detailed instructions below! @@ -14,7 +16,7 @@ This singularity recipe installs FSL 6.0.3 and the latest version of the PSMD sc - Installation of [singularity](https://sylabs.io) version 3.6 or newer, preferably installed on Linux - Linux is needed for building the container. A virtual machine setup is available for Windows and Mac users, please consult the [Singularity user guide](https://sylabs.io/docs/) for details. -- After building, the built container can also be executed on macOS using [Singularity Desktop](https://sylabs.io/singularity-desktop-macos/). +- After building the container, besides Linux, it can also be executed on macOS using [Singularity Desktop](https://sylabs.io/singularity-desktop-macos/). ### Build the container @@ -26,11 +28,11 @@ wget https://raw.githubusercontent.com/miac-research/psmd/main/singularity/singu sudo singularity build psmd.sif singularity-psmd.txt ``` -> Please note that the container will be very large, usually around 2.5 GB. Also note that in order to save space, some parts of the FSL installation are deleted. The container does not contain a fully functional FSL installation, but a minimal install suited for diffusion processing and PSMD calculation. You can modify the recipe file in order to retain a full FSL install. +> Please note that the container will be quite large, usually around 2.5 GB. Also note that in order to save space, some parts of the FSL installation are deleted. The container does not contain a fully functional FSL installation, but a minimal install suited for diffusion processing and PSMD calculation. You can modify the recipe file in order to retain a full FSL install. ### Using a specific version of PSMD in the container -By default, the container will use the latest version of the psmd script from the repository. To run a specific version, you need to edit the recipe file. Find the following line: `wget -O /psmd/psmd.sh https://raw.githubusercontent.com/miac-research/psmd/main/psmd.sh` and substitute the URL with one of the following URLs: +By default, the container will use the latest version of the psmd script from the repository. To run a specific version (from a specific release, you need to edit the recipe file. Find the following line: `wget -O /psmd/psmd.sh https://raw.githubusercontent.com/miac-research/psmd/main/psmd.sh` and substitute the URL with one of the following URLs: | version | URL | | --- | --- | @@ -47,7 +49,7 @@ By default, the container will use the latest version of the psmd script from th singularity exec psmd.sif psmd.sh ``` -- After this command, specify the options as usually for the psmd script, e.g. +- After this command, specify the options as usually for the psmd script (see [www.psmd-marker.com](https://www.psmd-marker.com) for details on available options), e.g. ```bash singularity exec psmd.sif psmd.sh -d data.nii.gz -b data.bvals \ @@ -72,4 +74,4 @@ The container recipe was in part generated by [Neurodocker](https://github.com/R ## License -The container will contain an FSL installation. Please make sure to comply with the [FSL license conditions](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/Licence). Especially commercial use requires a paid license of FSL! \ No newline at end of file +The container will contain an (incomplete) FSL installation. Please make sure to comply with the [FSL license conditions](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/Licence). Especially commercial use requires a paid license of FSL! \ No newline at end of file diff --git a/singularity/singularity-psmd.txt b/singularity/singularity-psmd.txt index 6b3e349..6ceaab9 100644 --- a/singularity/singularity-psmd.txt +++ b/singularity/singularity-psmd.txt @@ -1,18 +1,22 @@ # PSMD Singularity Container Definition File -# https://www.psmd-marker.com ###### ADD UPDATED URL HERE ###### +# https://www.psmd-marker.com # Partly generated by: Neurodocker version 0.7.0 # https://github.com/ReproNim/neurodocker +# Executing this container requires a valid license of FSL. +# Please see https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/Licence + Bootstrap: docker From: ubuntu:bionic-20200921 %help -Visit the PSMD repository for help: https://github.com/miac-research/psmd +Visit the PSMD repository https://github.com/miac-research/psmd +or the PSMD homepage https://www.psmd-marker.com for help. %labels Author Marco Duering - Maintainer MIAC AG + Maintainer MIAC AG Recipe_version v1.0 %post