# Getting Started

We provide custom code and sample data to export your XNAT imaging session to BIDS format. Our process relies on few basic principles:

* Naming of sequences in a BIDS friendly manner at the scanner as outined in the [BIDS Ready Protocols section.](https://docs.ccv.brown.edu/bnc-user-manual/xnat/bids-compliant-protocols)
* DICOMS exported from XNAT using our software is converted to BIDS using [Heudiconv](https://github.com/nipy/heudiconv)
* We rely on the [ReproIn](https://github.com/repronim/reproin) specification and heuristic 
* Our code is available in the [xnat-tools repository](https://github.com/brown-bnc/xnat-tools)

## Requirements

Before exporting, you'll need to have available, XNAT authentication and session information as well as our software.

### 1. Familiarize with BNC's Demo Dataset

We will use the [BNC's Demo Dataset](#1.-xnat-login-information) in the following walk-through examples. It is helpful to be familiar with the general description and protocol details of the data

### 1. XNAT Login Information

If you have not registered to use our XNAT, please follow instructions [here](https://docs.ccv.brown.edu/bnc-user-manual/xnat/accessing-xnat#first-time-users)

* XNAT Username
* XNAT Password

### 2. Image Session Identifier

In order to export an imaging session, we need to find XNAT's ID for that session. You can do so as follows:

#### 2.1 Navigate to project of interest

![](https://4276957606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtSg7ZEM6EHbi9iE84a%2Fuploads%2FbprwnsWojcH23KFvLH1N%2Fdemodat-landing.png?alt=media\&token=894835cf-6c33-4812-99ab-0e44006b0941)

#### 2.2 Navigate to subject of interest

![Participants associated with a project](https://4276957606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtSg7ZEM6EHbi9iE84a%2Fuploads%2F4TZ8YyBVy6kvy0W5UaeA%2Fdemodat-subj.png?alt=media\&token=f32f7db9-b499-4f71-8e35-237665275478)

#### 2.3 Navigate to MR Session 

![MR Sessions associated with a participant](https://4276957606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtSg7ZEM6EHbi9iE84a%2Fuploads%2FDlSrGgHZ46o6lRcsnmKy%2Fmr-session.png?alt=media\&token=aeb84b42-ae6b-4880-85cb-baff9ec3e3f0)

#### 2.4. Find Accession \#

![Accession # for a session](https://4276957606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtSg7ZEM6EHbi9iE84a%2Fuploads%2Fi4IKvdgEPGnrwCwDfctB%2Faccession.png?alt=media\&token=d60a6c01-4b76-47f3-ac20-4a992a4f37df)

###