Skip to content

Commit

Permalink
Merge pull request #77 from OCHA-DAP/feature/gdrive-structure-documen…
Browse files Browse the repository at this point in the history
…tation

Add data directory structure info to the readme
  • Loading branch information
turnerm authored May 21, 2021
2 parents 26bd447 + 9953f0a commit 1589deb
Showing 1 changed file with 25 additions and 6 deletions.
31 changes: 25 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,13 +48,8 @@ Create a virtual environment and install the requirements with
```
If an error occurs you might have to install spatialindex, on MacOS this can be done with `brew install spatialindex`

Sync [this](https://drive.google.com/drive/u/3/folders/1RVpnCUpxHQ-jokV_27xLRqOs6qR_8mqQ)
directory from Google drive to your local machine. Create an environment variable called
`AA_DATA_DIR` that points to this directory.

The indicators and analyses folders contain more specific information on the data, processing and how to run the scripts.


## Repository structure
```
Expand All @@ -67,5 +62,29 @@ The indicators and analyses folders contain more specific information on the dat
├── requirements.txt
├── README
└── LICENSE
```

## Data directory

```
Sync [this](https://drive.google.com/drive/u/3/folders/1RVpnCUpxHQ-jokV_27xLRqOs6qR_8mqQ)
directory from Google drive to your local machine. Create an environment variable called
`AA_DATA_DIR` that points to this directory.

The structure of the directory is as follows:
```
├── AA_DATA_DIR
├── public
| ├── exploration <-- data used for notebook analyses, same structure as in raw
| ├── processed <-- data taken from raw and processed by scripts in src,
| | same substructure as raw
| └── raw <-- raw data
| ├── [all country iso3s]
| | ├── glofas <-- example data source name
| | └── etc. (all country data sources)
| └── glb <-- all global-level data
| ├── chirps <-- data source name
| └── etc (all global data sources)
└── private <-- same substructure as public
```
The naming conventions for the data source directories are available in
[this spreadsheet](https://docs.google.com/spreadsheets/d/155buqH6hcox2IG54NSRkdIjiLcPDmrs6JcjwjdFFA8g/edit?usp=sharing)

0 comments on commit 1589deb

Please sign in to comment.