Difference between revisions of "Variable"

From Testiwiki
Jump to: navigation, search
m (Definition)
(Answer: 'data not used' added to rationale)
 
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
<noinclude>
 
[[Category:Universal object]]
 
[[Category:Universal object]]
{{variable}}
+
[[Category:Open policy practice]]
 +
[[Category:Decision analysis and risk management]]
 +
{{variable|moderator=Jouni}}
 
{{Guidebook}}
 
{{Guidebook}}
 
[[category:Glossary term]]
 
[[category:Glossary term]]
 
<section begin=glossary />
 
<section begin=glossary />
:'''[[Variable]]''' is a description of a particular piece of reality. It can be a description of physical phenomena, or a description of value judgements. Also decisions included in an assessment are described as variables. Variables are continuously existing descriptions of reality, which develop in time as knowledge about them increases. Variables are therefore not tied into any single assessment, but instead can be included in other assessments. A variable is the basic building block of describing reality.<section end=glossary />
+
:'''Variable''' is a description of a particular piece of reality. It can be a description of a physical phenomenon, or a description of value judgements. Also decisions included in an assessment are described as variables. Variables are continuously existing descriptions of reality, which develop in time as knowledge about the topic increases. Variables are therefore not tied into any single assessment, but instead can be included in other assessments. A variable is the basic building block of describing reality.<section end=glossary />
  
==Scope==
+
== Question ==
  
;The research question about the structure of a variable: What is a structure of a variable such that it
+
What should be the structure of a variable such that it
:* is able to systematically handle all kinds of information about the particular piece of reality that the variable is describing,
+
* is able to systematically handle all kinds of information about the particular piece of reality that the variable is describing, especially
:* is able to systematically describe causal relationships between variables,
+
** it is generic enough to be a standard building block in decision support work (including interpretation of scientific information and political discussions),
:* enables both quantitative and qualitative descriptions,
+
* is able to systematically describe causal relationships between phenomena and variables that describe them,
:* is suitable for any kinds of variables, especially physical phenomena, decisions, and value judgements,
+
* enables both quantitative and qualitative descriptions,
:* inherits its main structure from [[universal object]]s,
+
* is suitable for any kinds of variables, especially physical phenomena, decisions, and value judgements,
:* complies with the [[PSSP]] ontology,
+
* inherits its main structure from [[universal object]]s,
:* can be operationalised in a computational model system,
+
* complies with the [[PSSP]] ontology,
:* results in variables that are independent of the assessment(s) it belongs to;
+
* can be operationalised in a computational model system,
:* results in variables that pass the [[Plausibility test|clairvoyant test]].
+
* results in variables that are independent of the assessment(s) they belong to;
 +
* results in variables that pass the [[Plausibility test|clairvoyant test]].
 +
* can be implemented on a website, and
 +
* is easy enough to be usable and understood by interested non-experts?
  
==Definition==
+
== Answer ==
  
===Data===
+
Variable is implemented as a web page in Opasnet wiki web-workspace. A variable page has the following structure.
 
 
* [[Clairvoyant test]]
 
 
 
===Causality===
 
 
 
* [[PSSP]]
 
* [[Universal object]]
 
 
 
==Result==
 
  
 
{|{{prettytable}}
 
{|{{prettytable}}
|+Table 3. The attributes of a variable.
+
|+The attributes of a variable.
 
! [[Attribute]]
 
! [[Attribute]]
 
! Sub-attribute
 
! Sub-attribute
! Comments specfic to the variable attributes
+
! Comments specific to the variable attributes
 
|-----
 
|-----
 
| '''Name'''
 
| '''Name'''
 
|  
 
|  
 +
| An identifier for the variable. Each Opasnet page have two kinds of identifiers: the name of the page (e.g. Variable) and the page identifier (e.g. Op_en2022). The former is used e.g. in links, the latter in [[R]] code.
 +
|-----
 +
| '''Question'''
 
|  
 
|  
 +
| Gives the question that is to be answered. It defines the scope of the variable. The question should be defined in a way that it has relevance in many different situations, i.e. makes the variable re-usable. (Compare to an [[assessment]] question, which is more specific to time, place and user need.)
 
|-----
 
|-----
| '''Scope'''
+
| '''Answer'''
 
|  
 
|  
| This includes a verbal definition of the spatial, temporal, and other limits (system boundaries) of the variable. The scope is defined according to the use purpose of the assessment(s) that the variable belongs to.
+
| An answer presents an understandable and useful answer to the question. Its essence is often a machine-readable and human-readable probability distribution (which can in a special case be a single number), but an answer can also be non-numerical such as "very valuable" or a descriptive table like on this page. The units of interconnected variables need to be coherent with each other given the functions describing causal relations. The units of variables can be used to check the coherence of the causal network description. This is a so called [[Plausibility test|unit test]]. Typically the answer contains an [[R]] code that fetches the ovariable created under Rationale/Calculations and evaluates it.
 
|-----
 
|-----
| rowspan="4" | '''Definition'''
+
| rowspan="5" | '''Rationale'''
| Causality
+
|  
| Causality {{disclink|Dependencies instead of causality}} tells what we know about how upstream variables (i.e. causal parents) affect the variable. Causality lists the parents and expresses their functional relationships (the variable as a function of its parents) or probabilistic relationships (conditional probability of the variable given its parents). The expression of causality is '''independent''' of the data about the magnitude of the result of the variable.
+
| Rationale contains anything that is necessary to convince a critical reader that the answer is credible and usable. It presents the reader the information required to derive the answer and explains how it is formed. Typically it has the following sub-attributes, but also other are possible. Rationale may also contain lengthy discussions about relevant topics.
 
|----
 
|----
 
| Data
 
| Data
| Data tells what we know about the magnitude of the result of the variable. Data describes any non-causal information about the particular part of reality that is being described, such as direct measurements, measured data about an analogous situation (this requires some kind of error model), or expert judgment.
+
| Data tells about direct observations (or expert judgements) about the variable itself.
 +
|----
 +
| Dependencies
 +
| Dependencies {{reslink|Dependencies instead of causality}} tells what we know about how upstream variables (i.e. causal parents) affect the variable. In other words, we attempt to estimate the answer indirectly based on information of causal parents. Sometimes also reverse inference is possible based on causal children. Dependencies list the causal parents and expresses their functional relationships (the variable as a function of its parents) or probabilistic relationships (conditional probability of the variable given its parents).
 
|----
 
|----
| Unit
+
| Calculations
| Unit describes, in what measurement units the result is presented. The units of interconnected variables need to be coherent with each other given the functions describing causal relations. The units of variables can be used to check the coherence of the causal network description. This is a so called [[Plausibility test|unit test]].  
+
| Calculations {{reslink|Discussion on formula attribute}} is an operationalisation of how to calculate or derive the answer. Formula uses algebra, computer code, or other explicit methods if possible. Typically it is [[R]] code that produces and stores the necessary [[ovariable]]s to compute the current best answer to the question.
 
|----
 
|----
| Formula
+
| Data not used
| Formula {{disclink|Discussion on formula attribute}} is an operationalisation of how to calculate or derive the result based on ''Causality'', ''Data'', and ''Unit'', making a synthesis of the three. Formula uses algebra, computer code, or other explicit methods if possible.
+
| Data not used are relevant for the research question, but for some reason they were not used in producing the current answer. I may be that the data was found after the synthesis, and an update has not yet been done; or it has been unclear how to merge these to the existing data. In any case, it is important to be differentiate and be explicit about whether data is irrelevant (and therefore removed from the page) or relevant but not used (and therefore waiting for further work).
|-----
 
| '''Result'''
 
|
 
| A result is an estimate about the particular part of reality that is being described. It is preferably a probability distribution (which can in a special case be a single number), but a result can also be non-numerical such as "very valuable".  
 
 
|}
 
|}
  
 
In addition, it is practical to have additional subtitles on a variable page. These are not attributes, though.
 
In addition, it is practical to have additional subtitles on a variable page. These are not attributes, though.
 
* See also
 
* See also
 +
* Keywords (not always used)
 
* References
 
* References
 +
* Related files
  
[[image:Variable definition.PNG]]
+
== Rationale ==
 
 
'''Specific issues related to variable attributes
 
 
 
In a general form, the formula can be described as
 
 
 
result = formula(causal parameters, data parameters, unit),
 
 
 
:where formula is a function (expressed as algebra or computer code for a specified software) for calculating the result using the causal parameters (information from causally upstream variables) and the data parameters (information from observed data) as input. The formula can be placed within <nowiki><anacode></anacode> or <rcode><rcode></nowiki>, if it is expressed as Analytica or R code, respectively.
 
 
 
It should be noted that the result is the distribution itself, although it can be expressed as some kind of description of the distribution, such as mean and standard deviation. The result should be described in such a detailed way that the full distribution can be reproduced from the information presented under this attribute. A technically straightforward way to do this is to provide a large random sample from the distribution.
 
 
 
The result may be a different number for different ''locations'', such as geographical positions, population subgroups, or other determinants (e.g. years 2000, 2001). Then, the result is described as
 
  
  R given x<sub>1</sub>,x<sub>2</sub>,...  
+
[[File:Information_flow_within_open_policy_practice.png|thumb|450px]]
 +
The structure is based on extensive discussions between Mikko Pohjola and Jouni Tuomisto in 2006-2008 and intensive application in Opasnet ever since.
  
where R is the result and x<sub>1</sub> and x<sub>2</sub> are defining the locations along an [[index]] (e.g. [[Year3]]). Index is a technical tool for dealing with the '''dimensionality''' of the variable. A [[dimension]] means a property along which locations are located (e.g. [[:Category:Time|Time]]). In this case, x<sub>1</sub> and x<sub>2</sub> are indices along some dimensions, and particular values of x<sub>1</sub> and x<sub>2</sub> are locations. A variable can have zero, one, or more dimensions. Even if a dimension is continuous, it is usually operationalised in practice as a list of discrete locations. {{reslink|MC is not an uncertainty dimension of a variable}}
+
For more detailed description about variables as information objects, see [[knowledge crystal]].
  
==See also==
+
== See also ==
  
 +
* [[Ovariable]]
 +
* [[:Category:Variables | List of all variables]] in Opasnet
 
* [[Universal object]]
 
* [[Universal object]]
 
* [[Open assessment]]
 
* [[Open assessment]]
 
* [http://en.opasnet.org/w/index.php?title=Variable&oldid=5596 A previous version of this page] contains much of the discussion from the Intarese deliverables D17 and D18, which has been edited with a hard hand.
 
* [http://en.opasnet.org/w/index.php?title=Variable&oldid=5596 A previous version of this page] contains much of the discussion from the Intarese deliverables D17 and D18, which has been edited with a hard hand.
  
==References==
+
== References ==
  
 
<references/>
 
<references/>
 +
 +
== Related files ==
 +
</noinclude>

Latest revision as of 13:33, 16 December 2015


<section begin=glossary />

Variable is a description of a particular piece of reality. It can be a description of a physical phenomenon, or a description of value judgements. Also decisions included in an assessment are described as variables. Variables are continuously existing descriptions of reality, which develop in time as knowledge about the topic increases. Variables are therefore not tied into any single assessment, but instead can be included in other assessments. A variable is the basic building block of describing reality.<section end=glossary />

Question

What should be the structure of a variable such that it

  • is able to systematically handle all kinds of information about the particular piece of reality that the variable is describing, especially
    • it is generic enough to be a standard building block in decision support work (including interpretation of scientific information and political discussions),
  • is able to systematically describe causal relationships between phenomena and variables that describe them,
  • enables both quantitative and qualitative descriptions,
  • is suitable for any kinds of variables, especially physical phenomena, decisions, and value judgements,
  • inherits its main structure from universal objects,
  • complies with the PSSP ontology,
  • can be operationalised in a computational model system,
  • results in variables that are independent of the assessment(s) they belong to;
  • results in variables that pass the clairvoyant test.
  • can be implemented on a website, and
  • is easy enough to be usable and understood by interested non-experts?

Answer

Variable is implemented as a web page in Opasnet wiki web-workspace. A variable page has the following structure.

The attributes of a variable.
Attribute Sub-attribute Comments specific to the variable attributes
Name An identifier for the variable. Each Opasnet page have two kinds of identifiers: the name of the page (e.g. Variable) and the page identifier (e.g. Op_en2022). The former is used e.g. in links, the latter in R code.
Question Gives the question that is to be answered. It defines the scope of the variable. The question should be defined in a way that it has relevance in many different situations, i.e. makes the variable re-usable. (Compare to an assessment question, which is more specific to time, place and user need.)
Answer An answer presents an understandable and useful answer to the question. Its essence is often a machine-readable and human-readable probability distribution (which can in a special case be a single number), but an answer can also be non-numerical such as "very valuable" or a descriptive table like on this page. The units of interconnected variables need to be coherent with each other given the functions describing causal relations. The units of variables can be used to check the coherence of the causal network description. This is a so called unit test. Typically the answer contains an R code that fetches the ovariable created under Rationale/Calculations and evaluates it.
Rationale Rationale contains anything that is necessary to convince a critical reader that the answer is credible and usable. It presents the reader the information required to derive the answer and explains how it is formed. Typically it has the following sub-attributes, but also other are possible. Rationale may also contain lengthy discussions about relevant topics.
Data Data tells about direct observations (or expert judgements) about the variable itself.
Dependencies Dependencies R↻ tells what we know about how upstream variables (i.e. causal parents) affect the variable. In other words, we attempt to estimate the answer indirectly based on information of causal parents. Sometimes also reverse inference is possible based on causal children. Dependencies list the causal parents and expresses their functional relationships (the variable as a function of its parents) or probabilistic relationships (conditional probability of the variable given its parents).
Calculations Calculations R↻ is an operationalisation of how to calculate or derive the answer. Formula uses algebra, computer code, or other explicit methods if possible. Typically it is R code that produces and stores the necessary ovariables to compute the current best answer to the question.
Data not used Data not used are relevant for the research question, but for some reason they were not used in producing the current answer. I may be that the data was found after the synthesis, and an update has not yet been done; or it has been unclear how to merge these to the existing data. In any case, it is important to be differentiate and be explicit about whether data is irrelevant (and therefore removed from the page) or relevant but not used (and therefore waiting for further work).

In addition, it is practical to have additional subtitles on a variable page. These are not attributes, though.

  • See also
  • Keywords (not always used)
  • References
  • Related files

Rationale

Error creating thumbnail: Unable to save thumbnail to destination

The structure is based on extensive discussions between Mikko Pohjola and Jouni Tuomisto in 2006-2008 and intensive application in Opasnet ever since.

For more detailed description about variables as information objects, see knowledge crystal.

See also

References


Related files