Merge branch 'master' of github.com:terraref/tutorials

Author: dlebauer

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2017, 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.

sensors/06-list-datasets-by-plot.md

@@ -0,0 +1,72 @@
+# Generating file lists by plot
+
+## Finding plot ID
+```
+SENSOR_NAME = "MAC Field Scanner Season 1 Field Plot 101 W"
+GET https://terraref.ncsa.illinois.edu/clowder/api/geostreams/sensors?sensor_name={SENSOR_NAME}
+```
+
+This returns a JSON object with an 'id' parameter. You can use this ID parameter to specify the right data stream.
+
+## Finding stream ID within a plot
+The names are formatted as "<Sensor Group> Datasets (<Sensor ID>)".
+```
+SENSOR_ID = 3355
+STREAM_NAME = "Thermal IR GeoTIFFs Datasets ({SENSOR_ID})"
+GET https://terraref.ncsa.illinois.edu/clowder/api/geostreams/streams?stream_name={STREAM_NAME}
+```
+
+This returns a JSON object with an 'id' parameter. You can use this ID parameter to get the right datapoints.
+
+## Listing Clowder file IDs for that plot & sensor stream
+```
+STREAM_ID = "11586"
+GET https://terraref.ncsa.illinois.edu/clowder/api/geostreams/datapoints?stream_id={STREAM_ID}
+```
+
+This returns a list of datapoint JSON objects, each with a 'properties' parameter that looks like:
+```
+properties: {
+    dataset_name: "Thermal IR GeoTIFFs - 2016-05-09__12-07-57-990",
+    source_dataset: "https://terraref.ncsa.illinois.edu/clowder/datasets/59fc9e7d4f0c3383c73d2905"
+},
+```
+
+The source_dataset URL can be used to view the dataset in Clowder.
+
+You can also filter the datapoints by date:
+```
+GET https://terraref.ncsa.illinois.edu/clowder/api/geostreams/datapoints?stream_id={STREAM_ID}&since=2017-01-02&until=2017-06-10
+```
+
+## Getting ROGER file path from dataset
+Given a source dataset URL, we can call the API to get the files and their paths.
+```
+SOURCE_DATASET = "https://terraref.ncsa.illinois.edu/clowder/datasets/59fc9e7d4f0c3383c73d2905"
+# Add /api after /clowder, and add /files at the end of the URL
+GET "https://terraref.ncsa.illinois.edu/clowder/api/datasets/59fc9e7d4f0c3383c73d2905/files"
+```
+
+This returns a list of files in the dataset and their paths if available:
+```
+[
+    {
+        size: "346069",
+        date-created: "Fri Nov 03 11:51:13 CDT 2017",
+        id: "59fc9e814f0c3383c73d2962",
+        filepath: "/home/clowder/sites/ua-mac/Level_1/ir_geotiff/2016-05-09/2016-05-09__12-07-57-990/ir_geotiff_L1_ua-mac_2016-05-09__12-07-57-990.png",
+        contentType: "image/png",
+        filename: "ir_geotiff_L1_ua-mac_2016-05-09__12-07-57-990.png"
+    },
+    {
+        size: "1231298",
+        date-created: "Fri Nov 03 11:51:16 CDT 2017",
+        id: "59fc9e844f0c3383c73d2980",
+        filepath: "/home/clowder/sites/ua-mac/Level_1/ir_geotiff/2016-05-09/2016-05-09__12-07-57-990/ir_geotiff_L1_ua-mac_2016-05-09__12-07-57-990.tif",
+        contentType: "image/tiff",
+        filename: "ir_geotiff_L1_ua-mac_2016-05-09__12-07-57-990.tif"
+    }
+]
+```
+
+Depending on permissions you may need to provide authentication to get this list.