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

Add note of under development and update documentation #147

Merged
merged 1 commit into from
Dec 27, 2021
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
4 changes: 3 additions & 1 deletion .github/workflows/docs_pages_workflow.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,5 +24,7 @@ jobs:
- name: Execute script to build our documentation and update pages
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: "docs/buildDocs.sh"
run: |
git reset --hard origin/$GITHUB_REF_NAME
docs/buildDocs.sh
shell: bash
59 changes: 36 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,65 @@
# BrainChart Toolbox
# [NiBAx] The neuro-imaging brain aging chart

After proper installation, the tools can be used as follows
**This software is under development!**

```shell
QtBrainChart
```

where `istaging.pkl.gz` and `MUSE_harmonization_model.pkl` are the data and
harmonization models, respectively.

#
![](QtBrainChartGUI/resources/workflow.gif)
![](NiBAx/resources/workflow.gif)


## Setup for development
Install Python version 3.8.8 or newer. Verify with
Install Python version 3.8.8 or newer.
The exact procedure depends on the operating system and configuration.
Verify the version with

```shell
python --version # should be 3.8.8 or newer
```

### Prepare environment in Linux (CUBIC)
Assuming current working directory is `BrainChart`.
Assuming current working directory is `NiBAx` and containing the source code
cloned from https://github.com/CBICA/NiBAx.git.

```shell
python -m venv .env
.env/bin/activate
python -m pip install --upgrade pip
```

### Prepare environment in Windows 10 or Windows 11
Assuming current working directory is `BrainChart`.
Assuming current working directory is `NiBAx` and containing the source code
cloned from https://github.com/CBICA/NiBAx.git.

```shell
python -m venv .env
& .env/Scripts/Activate.ps1
python -m pip install --upgrade pip
```

### Install BrainChart Toolbox
To install the `BrainChart Toolbox`, do one of these after activating the
virtual environment:
### Install [NiBAx] Toolbox
To install the [NiBAx], install it in a virtual environment. Depending on the
desired version, use one of the following commands to install it.

```shell
# Editable version for development
python -m pip install -e .
# Editable version for development after cloning https://github.com/CBICA/NiBAx.git
python -m pip install -U -e .

# Version from pull request for testing proposed changes
python -m pip install git+https://github.com/CBICA/iSTAGING-Tools.git@refs/pull/57/head
# Version from pull request (#57 in this example) for testing proposed changes
python -m pip install -U git+https://github.com/CBICA/NiBAx.git@refs/pull/57/head

# Main version of toolbox
python -m pip install -U git+https://github.com/CBICA/NiBAx.git
```

# Main version for testing of what users would get
python -m pip install git+https://github.com/CBICA/iSTAGING-Tools.git

## Useage
After proper installation, the standalone graphical user interface can be launched
in the terminal with:

```shell
NiBAx
```

The data file can be passed as command line argument `--data_file` as shown below.

```shell
NiBAx --data_file istaging.pkl.gz
```
3 changes: 1 addition & 2 deletions docs/contents/datapreprocessing.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
Data Pre-Processing
======================================

contents go here

**The documentation is under active development.**
3 changes: 1 addition & 2 deletions docs/contents/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
Development
======================================

contents go here

**The documentation is under active development.**
3 changes: 1 addition & 2 deletions docs/contents/guiplugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
GUI Plugins
======================================

contents go here

**The documentation is under active development.**
3 changes: 1 addition & 2 deletions docs/contents/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
Installation
======================================

contents go here

**The documentation is under active development.**
3 changes: 1 addition & 2 deletions docs/contents/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
QuickStart
======================================

contents go here

**The documentation is under active development.**
3 changes: 1 addition & 2 deletions docs/contents/userguide.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,4 @@
User Guide
======================================

contents go here

**The documentation is under active development.**