🪵Single Reference Sample + Import
Last updated
Last updated
TimberID allows you to add reference Timber Samples to your database. Reference Timber Samples are those collected by researchers or related entities whose measurements are used to train models.
TimberID uses Reference Timber Samples to train a Variational Inference ML model that predicts isotope ratios for several elements (dO18, dC13, dN15).
There are two options for adding sample data.
You may use the option "Single Reference Sample" under "Add Sample".
Single Reference Sample allows you to enter data about one timber sample, including all measurements that may exist at different points on the disc or slice of timber.
You may also use the option "Import Samples" right below "Single Reference Sample" Import Samples allows you to import multiple Samples from a CSV file.
If you enter a Reference Sample with the TimberID UI, it will record the following items on the first screen:
| Field | Required | What to enter |
|---|---|---|
Sample Name | Required | Any text that names the sample. TimberID assigns a unique ID independently from this field. |
Status | Required | "Completed" if all measurements have been taken. May also be "in transit", "in progress" or "not started" to indicate various progress within a lab. Only "Completed" samples are exported to Earth Engine for research. |
Tree Species | The scientific species name of the timber. Please select an entry from the drop-list. | |
Origin | Should always be "Known" for Reference Samples. | |
Collection Site | Required | The name of the collection site which may be identical to Municipality (if only one site exists in a Municipality). Can be any text. |
Latitude/Longitude | Required | The latitude and longitude representing a location within Brazil that identifies where the tree was harvested for the timber sample. If you are in the south, you must use minus signs. For example, -3.946713, -53.101942 - Altamira, Pará. |
State | The state in which the latitude/longitude exists. | |
Municipality | The municipality in which the latitude/longitude exists. | |
Date Collected | For Reference Samples, the date the sample was harvested from a live tree. | |
Collected By | Required | Whether this timber sample was collected by a third party or the organization itself |
City | The city in which the 3rd party collected the sample. |
After hitting Next, the following screen appears with additional optional measurements to be recorded:
| Field | What to enter |
|---|---|
Measuring height | The height in cm off the forest floor where the sample was taken. |
Sample type | One of "Disc", "Triangular", "Chunk" or "Fiber" to indicate the shape or characteristic of the timber. |
Diameter | The diameter in cm of the sample. |
AVP | |
Mean Annual Temperature | |
Mean Annual Precipiation | |
Observations | Free text that indicates any observations or notes about the sample. |
Measurements | Isotope measurements as recorded by a mass spectrometer. |
dO18_cel | delta O18 from cellulose |
dO18_wood | delta O18 from wood |
dN15_wood | delta N15 from wood |
N_wood | N from wood |
d13C_wood | delta C13 from wood |
d13C_cel | delta C13 from cellulose |
%C_wood/%C_cel | the percentage of carbon in wood or cellulose. |
Click on the Next button and the final page allows you to review what you have entered. Click "Create Sample" to add the sample to TimberID as below.
TimberID also allows you to import many reference samples at once through a csv file. The csv file must:
Use commas to separate values
The first row must be column names
The column names must all be lower case
You may include any columns you wish and while TimberId will not display all of them in the UI, they will be exported to Earth Engine as features at the latitude/longitude indicated.
Importing does require the following columns with respective validation rules.
| Field | Validation | Required | Description |
|---|---|---|---|
code | none | Y | The unique id for a sample that has potentially multiple rows (one for each measurement) |
trusted | ['trusted', 'unknown', 'untrusted'] | Y | 'trusted' samples indicate a reference sample. 'untrusted' samples are those intended to run under origin verification. 'unknown' are those that do not have a precise lat/lon |
lat | >=-90, <=90 | Y | |
lon | >=-180, <=180 | Y | |
d18O_cel | >=20, <=32 | N | |
d18O_wood | >=20, <=32 | N | |
d15N_wood | >=-5, <=15 | N | |
n_wood | >=0, <=1 | N | |
d13C_wood | >=-38, <=20 | N | |
c_wood | >=40, <=60 | N | |
d13C_cel | >-35, <=-20 | N | |
c_cel | >=40, <=60 | N |
When you import values, if there are errors in your CSV or validation errors, TimberID will create a mirror copy of your input csv along with a new column called 'error' which is filled out for each row that has a validation error.
You can see the full list of potential import errors along with how to fix them, here.
You may use the linked file as an example to create a valid import file.
