Merge pull request #87 from jyucsiro/readme

adding intro docs to tools

Author: mo-marqh

README.md

@@ -72,3 +72,51 @@ $ python setup.py --quiet install
 #running the tests
 $ python -m unittest discover -s bald.tests -v
 ```
+
+## Command line tools
+
+### ncldDump
+
+A HTML 'hot-linked' version of the `ncdump` command-line utility. 
+The output of `ncldDump` is a something similar but with links to the standard names
+and definitions of the attributes to source documentation. See https://binary-array-ld.github.io/netcdf-ld/examples/avhrr-only-v2.19810901_a.html for 
+example output HTML.
+
+See more here https://github.com/jyucsiro/bald/tree/master/ncldDump 
+
+Getting started:
+```
+$ cd ncldDump
+#Install requirements
+$ pip install -r ../requirements.txt
+
+#run
+$ python ncldDump.py -a aliases.json -o test.html test.nc
+```
+
+
+### nc2rdf
+
+A command-line tool that takes a netCDF or CDL file and outputs an RDF or JSON-LD encoding of the 
+content. The RDF can then be imported into RDF triple stores or used with RDF libraries for 
+reasoning, SPARQL querying and the like.
+
+The RDFLib package is used so serialisation options to RDF are: `n3`, `nquads`, `nt`, `rdfxml`, `turtle` or `ttl`.
+
+See more here https://github.com/jyucsiro/bald/tree/master/nc2rdf 
+
+```
+$ cd nc2rdf
+
+# turn CDL into RDF
+$ python nc2rdf.py  test.cdl
+
+# turn NC into RDF
+$ python nc2rdf.py  test.nc
+
+# specify RDF formats/flavours 
+$ python nc2rdf.py -o turtle test.nc
+
+```
+
+