Merge pull request #4 from terraref/master

Mosty copy-edits, filling out icasa-units

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2018, TERRA REF
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -14,6 +14,8 @@ See the [Design Notes](docs/design.md) for more information on the basic require
 
 The PURL http://purl.org/icasa and currently redirects to this Github repostitory.
 
+See related work by the DSSAT team: https://github.com/DSSAT/icasa-data-ontology
+
 ## Management Info
 
 Each dataset/subset/group is added as an OWL Class. Each variable/code is added as a datatype property with domain as the associated class (dataset/subset/group) and range xsd:string. For example:
@@ -42,10 +44,10 @@ Each dataset/subset/group is added as an OWL Class. Each variable/code is added
 Class names are manually generated from the dataset/subset/group columns and descriptions from White et al (2013).
 
 Files:
-* icasa-mgmt-info.csv: Management_Info sheet exported from Google spreadsheet as CSV
-* icasa-mgmt-info.owl: OWL ontology (output of icasa-mgmt-info.py)
-* icasa-mgmt-info.py: Python script that reads icasa-mgmt-info.csv, icasa-mgmt-info-subgroups.csv and generates icasa-mgmt-info.owl
-* icasa-mgmt-info-subgroups.csv: Manual mapping of dataset/subset/group information to class names.
+* [icasa-mgmt-info.csv](icasa-mgmt-info.csv): Management_Info sheet exported from Google spreadsheet as CSV
+* [icasa-mgmt-info.owl](icasa-mgmt-info.owl): OWL ontology (output of icasa-mgmt-info.py)
+* [icasa-mgmt-info.py](icasa-mgmt-info.py): Python script that reads icasa-mgmt-info.csv, icasa-mgmt-info-subgroups.csv and generates icasa-mgmt-info.owl
+* [icasa-mgmt-info-subgroups.csv](icasa-mgmt-info-subgroups.csv): Manual mapping of dataset/subset/group information to class names.
 
 To run:
 ```
@@ -62,7 +64,7 @@ Of course, there can certainly be other types of measured data.  While ICASA ass
 
 A  different approach is taken for the Measured_Data sheet.  A simple OWL ontology was manually created to describe the top-level concepts of [variables and units](variables-units.owl).  This will likely be replaced by another standard ontology or model, once a suitable candidate is found.
 
-The python script [icasa-measured-data.py]icasa-measured-data.py) converts the Measured_Data into a set of [variable descriptions in RDF](icasa-measured-data.rdf).  We can imagine similar sets of variables for BETYdb, TERRA-REF, and other projects.
+The python script [icasa-measured-data.py](icasa-measured-data.py) converts the Measured_Data into a set of [variable descriptions in RDF](icasa-measured-data.rdf).  We can imagine similar sets of variables for BETYdb, TERRA-REF, and other projects.
 ```
     <!-- http://http://purl.org/icasa/variables#irrd -->
     <rdf:Description rdf:about="http://purl.org/icasa/variables#irrd">
@@ -77,13 +79,13 @@ The python script [icasa-measured-data.py]icasa-measured-data.py) converts the M
 
 
 Files:
-* icasa-mgmt-info-subgroups.csv: Manual mapping of dataset/subset/group information to RDF Class Names. Descriptions taken from White et al (2013).
-* measured-data.owl: Owl ontology describing Variables and Units (manually created)
-* icasa-measured-data.csv: Measured_Data sheet as CSV
-* icasa-measured-data.py: Python script that reads icasa-measured-data.csv and generates icasa-measured-data.rdf
-* icasa-measured-data.rdf: RDF descriptions of each variable
-* icasa-measured-data-subgroups.csv: Mapping of dataset/subset/group to category
-* icasa-measured-data-units-types.csv: List of units and types (not currently used)
+* [icasa-mgmt-info-subgroups.csv](icasa-mgmt-info-subgroups.csv): Manual mapping of dataset/subset/group information to RDF Class Names. Descriptions taken from White et al (2013).
+* [measured-data.owl](measured-data.owl): Owl ontology describing Variables and Units (manually created)
+* [icasa-measured-data.csv](icasa-measured-data.csv): Measured_Data sheet as CSV
+* [icasa-measured-data.py](icasa-measured-data.py): Python script that reads icasa-measured-data.csv and generates icasa-measured-data.rdf
+* [icasa-measured-data.rdf](icasa-measured-data.rdf): RDF descriptions of each variable
+* [icasa-measured-data-subgroups.csv](icasa-measured-data-subgroups.csv): Mapping of dataset/subset/group to category
+* [icasa-measured-data-units-types.csv](icasa-measured-data-units-types.csv): List of units and types (not currently used)
 
 
 ## Units

examples/units/icasa-units.csv

@@ -3,7 +3,6 @@ Unit_or_type,Data_type
 %/day,single
 C,single
 MJ/m2.d,single
-Mg/ha,
 Mg/ha,single
 cm,single
 cm/cm2,single
@@ -18,7 +17,6 @@ cm2/m2.d,single
 cm2/plant,single
 cm3/cm3,single
 code,text
-dap,
 dap,single
 date,single
 day,single
@@ -37,12 +35,10 @@ g/plant,single
 g/plant.d,single
 g/shoot,single
 g/unit,single
-kg/ha,
 kg/ha,single
 kg/ha.d,single
 kg/hl,single
 kg[N]/ha,single
-kg[water]/kg[harvest],
 kg[water]/kg[harvest],single
 l/kg,single
 m,single
@@ -64,7 +60,6 @@ number/plant,single
 number/shoot,single
 ppm,single
 ratio,single
-single
 t/ha,single
 unitless,single
 year,single