Proposed CSV upload format
...
Sensor | Name | External_ID | Latitude | Longitude | Reading_types | Depth | Brand | Model | Part_number | hardware_version |
---|---|---|---|---|---|---|---|---|---|---|
Description | How the sensor will be labelled in LiteFarm. | The sensor’s unique external id. This is the identity that will be used to register the sensor with external services and receive readings associated with this sensor. | The latitude for the sensor. | The longitude for the sensor. | Comma delimited list of sensor reading types. Valid values are:
| Assumed to be in cm, only 1 depth per sensor. | The brand of sensor. | The model of sensor. | Not part of upload! | Not part of upload! |
Data type | String | String | Decimal | Decimal | Specific strings | Decimal | String | String | String | String |
Required? | Required | Optional | Required | Required | Required | Optional | Optional | Optional | Optional | Optional |
Example | “Sensor 1” | “WERKTX” | -31.3624425 | -64.2104754448 | soil_water_content, soil_water_potential, temperature | 10 | “Ensemble Scientific” | “Model ABC” | “ESA-12345” | “B” |
Validation | 1 <= name.length <= 100 | 1 <= id.length <= 20 | -90 <= lat <= 90 | -180 <= long <= 180 | At least 1 of the following: soil_moisture_content, water_potential, temperature | 0 <= depth <= 1000 | String: < 100 length | String: < 100 length | String: < 100 length | String: < 100 length |
Error | “Invalid sensor name, must be between 1 and 100 characters” | “Sensor with external id: <id> already exists.” “Invalid external id, must be between 1 and 20 characters” | “Invalid latitude value, must be between -90 and 90. and fewer than 10 decimals” | “Invalid longitude value, must be between -180 and 180. and fewer than 10 decimals” | “Invalid reading type detected, valid values include:
| “Invalid depth, must be a decimal value between 0 and 1000.” | “Invalid brand, must be fewer than 100 characters.” | “Invalid model, must be fewer than 100 characters.” | “Invalid part_number, must be fewer than 100 characters.” | “Invalid hardware_version, must be fewer than 100 characters.” |
Notes | May need to group sensors with same / similar lat / long on the map. This should be default behaviour since sensors are points. For this project depths can be 10, 20, 30, 50. | If this is “Ensemble Scientific”, it should activate the need to register this sensor during the bulk creation endpoint. |
...