ystafdb 0.6.0
CLI tool to parse YSTAFDB and produce ttl/nt/xml.

# YSTAFDB

YSTAFDB creates turtle files of the instances of data based on an ontology.
The turtle files are needed for the BONSAI knowledge graph.

The turtle files generated are stored in the BONSAI [rdf repository](https://github.com/BONSAMURAIS/rdf).

Currently generates the following:

* Activity types, flow objects, locations and flows for YSTAFDB v1.0.

## Installation

### with package manager pip from pypi

Installable via `pip`:

```
pip install ystafdb
```

### manual

Clone git repo
```
$ git clone git@github.com:BONSAMURAIS/ystafdb.git
```

Enter cloned repo
```
$ cd ystafdb
```

Now install package

```
$ python setup.py install
```

## Usage

First download the Base Data, and then use `ystafdb-cli` to produce the ttl/nt/xml files.

For the full syntax, invoke `ystafdb-cli -h`:

```
usage: ystafdb-cli [-h] [-i INDIR] [-o OUTDIR] [-f {nt,ttl,xml}]

Extract rdf from ystafdb

optional arguments:
  -h, --help            show this help message and exit
  -i INDIR, --input INDIR
                        path to ystafdb csv files
  -o OUTDIR, --output OUTDIR
                        Output directory
  -f {nt,ttl,xml}, --format {nt,ttl,xml}
                        The output format

```

### Download Base Data

The data can be downloaded [here](https://www.sciencebase.gov/catalog/file/get/5b9a7c28e4b0d966b485d915?f=__disk__0f%2F58%2Fa7%2F0f58a74db669ee5418f36a698bc85781e867e0ab) as a zip file.

Extract the contents of the zip file. As an example, the data can be placed under `ystafdb-input`.
The following files from the Base Data are _mandatory_ to have in the folder (`ystafdb-input` in our example):

- `material_names.csv`
- `subsystems.csv`
- `flows.csv`
- `publications.csv`
- `reference_spaces.csv`
- `reference_materials.csv`
- `reference_timeframes.csv`


Under a Linux terminal, you can acomplish the previous two operations with:

```
curl -L "https://www.sciencebase.gov/catalog/file/get/5b9a7c28e4b0d966b485d915?f=__disk__0f%2F58%2Fa7%2F0f58a74db669ee5418f36a698bc85781e867e0ab" -o YSTAFDB_CSV_files.zip
unzip -d ystafdb-input YSTAFDB_CSV_files.zip
```

### Generate the ttl or nt or xml files

If the package is correctly installed, you can use the command line tool `ystafdb-cli` to produce the rdfs as follows:

```
$ ystafdb-cli -i <indir> -o <outdir> -f [ttl|nt|xml]
```


Where:
+ `<indir>` is the location of the ystafdb csv files, and 
+ `<outdir>` is the directory where the output triples graphs will be placed. This is optional,
  if not supplied, the output directory will be `output`
+ `-f` is the format of the files to generate (`ttl`, `nt` or `xml`). This is optional, if not supplied, it is `ttl`.

In the Linux terminal example from above, this would be done with:

```
ystafdb-cli -i ystafdb-input
```

The `<outputdir>` directory will have the following contents:

```
output
├── [ 4.0K]  activitytype
│   └── [ 4.0K]  ystafdb
│       └── [ 249K]  ystafdb.ttl
├── [ 4.0K]  flow
│   └── [ 4.0K]  ystafdb
│       └── [ 4.0K]  huse
│           └── [  41M]  huse.ttl
├── [ 4.0K]  flowobject
│   └── [ 4.0K]  ystafdb
│       └── [  63K]  ystafdb.ttl
├── [ 4.0K]  foaf
│   └── [ 4.0K]  ystafdb
│       └── [ 1.4K]  ystafdb.ttl
├── [ 4.0K]  location
│   └── [ 4.0K]  ystafdb
│       └── [ 158K]  ystafdb.ttl
└── [ 4.0K]  prov
    └── [ 4.0K]  ystafdb
        └── [ 1.0M]  ystafdb.ttl
```

## Contributing
Please do not edit this package directly.
All contributions should be via pull request.