ystafdb

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


License
BSD-3-Clause
Install
pip install ystafdb==0.6.0

Documentation

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.

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 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.