docs/03_managing_breeding_data/03_16.md

   1 ---
   2 title: "3.16 Managing Observation Variables with Traits, Methods, and Scales"
   3 layout: doc_page
   4 ---
   5
   6 <!-- TOC-START -->
   7 * TOC
   8 {:toc}
   9 <!-- TOC-END -->
  10
  11 ### 3.16.1 Managing Observation Variables
  12
  13 Observation variables are the identifiers used when collecting phenotypic data. An observation variable is composed of a trait, a method, and a scale. The trait describes the attribute being measured e.g. 'Plant Height'. The method defines the protocol in which the trait was observed e.g. 'Using a one meter long measuring stick'. The scale defines the units or dimensions for which the measurement was taken e.g. 'Meters'.
  14
  15 Generally, observation variables are defined in ontologies that are predefined. We often use ontologies from cropontology.org. In this case, you will not be able to define your own observation variables directly; instead, you will need to contact us and we will add the observation variable for you.
  16
  17 For databases where the user has greater control, we have an interface to allow addition of observation variables, along with traits, methods, and scales. To begin, go to the Search->Traits page.
  18
  19 If the database you are on allows you to directly add observation variables, you will see the following button at the bottom of the page.
  20
  21 ![]({{"assets/images/manage_observation_variables_start_button.png" | relative_url }})
  22
  23 When you click the button, the following workflow will appear. You should be logged in or else it will not allow addition of the observation variable.
  24 The workflow begins with an introduction.
  25
  26 ![]({{"assets/images/manage_observation_variables_workflow_intro.png" | relative_url }})
  27
  28 On the next workflow step, you select the ontology that you want to insert the new observation variable into. You must also give a name and a definition for the new observation variable.
  29
  30 ![]({{"assets/images/manage_observation_variables_workflow_observation_variable.png" | relative_url }})
  31
  32 On the next workflow step, you select the trait ontology to use. Once you select a trait ontology, a select containing all the terms in the selected ontology will appear. You can either select a trait or if it does not exist in the select, you can create a new one by giving a name and a definition for the new trait.
  33
  34 ![]({{"assets/images/manage_observation_variables_workflow_trait.png" | relative_url }})
  35
  36 On the next workflow step, you select the method ontology to use. Once you select a method ontology, a select containing all the terms in the selected ontology will appear. You can either select a method or if it does not exist in the select, you can create a new one by giving a name and a definition for the new method.
  37
  38 ![]({{"assets/images/manage_observation_variables_workflow_method.png" | relative_url }})
  39
  40 On the next workflow step, you select the scale ontology to use. Once you select a scale ontology, a select containing all the terms in the selected ontology will appear. You can either select a scale or if it does not exist in the select, you can create a new one by giving a name and a definition for the new scale. You can also define a format, minimum, maximum, categories, and default value for the new scale.
  41
  42 ![]({{"assets/images/manage_observation_variables_workflow_scale.png" | relative_url }})
  43
  44 On the last page of the workflow, you confirm the submission.
  45
  46 ![]({{"assets/images/manage_observation_variables_workflow_submit.png" | relative_url }})
  47
  48 Afterwards, you can use the newly created observation variable ontology term in your phenotyping.