Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update installation documentation #47

Merged
merged 3 commits into from
Aug 28, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
blank_issues_enabled: true
contact_links:
- name: Questions
url: https://neurostars.org/tag/fmripost-aroma
about: For general questions, please search Neurostars for existing posts before starting a new one.
8 changes: 3 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,14 @@
# fmripost-aroma

[![Docker Image](https://img.shields.io/badge/docker-nipreps/fmripost--aroma-brightgreen.svg?logo=docker&style=flat)](https://hub.docker.com/r/nipreps/fmripost-aroma/tags/)
[![PyPI - Version](https://img.shields.io/pypi/v/fmripost-aroma.svg)](https://pypi.org/project/fmripost-aroma)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fmripost-aroma.svg)](https://pypi.org/project/fmripost-aroma)

fMRIPost-AROMA is a BIDS App for running ICA-AROMA on a preprocessed
fMRI dataset.
It is intended to replace the built-in workflow in fMRIPrep 23.0 and earlier,
but accepts any BIDS derivatives dataset where BOLD images have been resampled
to MNI152NLin6Asym.

***This is currently a placeholder. The workflow still needs to be copied here
and packaged.***
to MNI152NLin6Asym at 2 mm3 resolution.

-----

Expand All @@ -22,7 +20,7 @@ and packaged.***
## Installation

```console
pip install fmripost-aroma
docker pull nipreps/fmripost-aroma:unstable
```

## License
Expand Down
21 changes: 2 additions & 19 deletions docs/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,9 @@ Installation
------------
*fMRIPost-AROMA* should be installed using container technologies.

The ``fmripost-aroma`` command-line adheres to the `BIDS-Apps recommendations
for the user interface <usage.html#execution-and-the-bids-format>`__.
Therefore, the command-line has the following structure::
.. code-block:: bash
docker pull nipreps/fmripost-aroma:unstable

$ fmripost-aroma <input_bids_path> -d <derivatives_path> <analysis_level> <named_options>

The ``fmripost-aroma`` command-line options are documented in the :ref:`usage`
section.

The command-line will be composed of a preamble to configure the
container execution followed by the ``fmripost-aroma`` command-line options
as if you were running it on a *bare-metal* installation.
The command-line structure above is then modified as follows::

$ <container_command_and_options> <container_image> \
<input_bids_path> <derivatives_path> <analysis_level> <fmriprep_named_options>

Therefore, once specified the container options and the image to be run
the command line is the same as for the *bare-metal* installation but dropping
the ``fmripost-aroma`` executable name.

Containerized execution (Docker and Singularity)
================================================
Expand Down