download_instructions.md

### Downloading data 

We aim to show a very quick overview on how you can download data with `idc_index` a python package developed by the IDC team to help with basic operations on IDC data.

Learn more @ https://github.com/ImagingDataCommons/idc-index

Detailed Tutorial @ https://github.com/ImagingDataCommons/IDC-Tutorials/blob/master/notebooks/getting_started/part2_searching_basics.ipynb

#### Download idc-index package
```
pip install --upgrade idc-index
```

#### Import module and initialize client
```
from idc_index import index
client = index.IDCClient()
```

#### Download data
```
client.download_from_selection(
   seriesInstanceUID='<enter your seriesInstanceUID or list of seriesInstanceUIDs>',
   downloadDir= '<Download destination folder>' )

```
Below are a couple of examples:

Example 1:
```
client.download_from_selection(
   seriesInstanceUID='1.2.276.0.7230010.3.1.3.313263360.15851.1706325185.577017',
   downloadDir= 'idc_data' )

```

Example 2:
```
client.download_from_selection(
   seriesInstanceUID=['1.2.276.0.7230010.3.1.3.313263360.15851.1706325185.577017',
                     '1.2.840.113654.2.55.257926562693607663865369179341285235858'            
   ],
   downloadDir= 'idc_data' )

```