Document domain characteristics - Revision history

Scott: /* What To Do */

2015-06-18T05:02:27Z

‎What To Do

Scott: /* What To Do */

2015-06-18T05:01:21Z

‎What To Do

Scott: /* What To Do */

2015-06-18T04:59:26Z

‎What To Do

Scott: /* What To Do */

2015-06-18T04:56:32Z

‎What To Do

Scott: /* What To Do */

2015-06-18T04:55:51Z

‎What To Do

Scott: /* What To Do */

2015-06-18T04:38:30Z

‎What To Do

Scott: /* What To Do */

2015-06-18T04:37:32Z

‎What To Do

Scott: /* What To Do */

2015-06-18T01:26:08Z

‎What To Do

Scott: /* What To Do */

2015-06-18T01:25:40Z

‎What To Do

Scott: /* What To Do */

2015-06-18T01:22:29Z

‎What To Do

@@ Line 27: / Line 27: @@
 In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  Configuration variables are those that your model reads from its configuration file (often a text file with key-value pairs) prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.
-The CSDMS Standard Names also includes a standardized list of model '''assumptions''' that can be used to attach additional descriptive information to objects, quantities, the model grid or the model itself.  The [http://csdms.colorado.edu/wiki/CSN_Assumption_Names '''CSDMS Standard Assumption Names'''] are a work in progress that is divided into 26 different categories (or facets) of assumptions.  Software and an associated ontology is under development to make it easier to provide this new type of model metadata.
+The CSDMS Standard Names also includes a standardized list of model '''assumptions''' that can be used to attach additional descriptive information to model objects, quantities, grids or the model itself.  The [http://csdms.colorado.edu/wiki/CSN_Assumption_Names '''CSDMS Standard Assumption Names'''] are a work in progress that is divided into 26 different categories (or facets) of assumptions.  Software and an associated ontology is under development to make it easier to provide this new type of model metadata.
 <!-- Add any wiki Text above this Line -->

@@ Line 25: / Line 25: @@
 and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols, which are often included scientific publications.  It is also required to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
-In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  The latter includes any variables that your model reads from its configuration file prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.
+In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  Configuration variables are those that your model reads from its configuration file (often a text file with key-value pairs) prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.
 The CSDMS Standard Names also includes a standardized list of model '''assumptions''' that can be used to attach additional descriptive information to objects, quantities, the model grid or the model itself.  The [http://csdms.colorado.edu/wiki/CSN_Assumption_Names '''CSDMS Standard Assumption Names'''] are a work in progress that is divided into 26 different categories (or facets) of assumptions.  Software and an associated ontology is under development to make it easier to provide this new type of model metadata.

@@ Line 23: / Line 23: @@
 then use your browser's search feature, along with the alphabetization, to search for a CSDMS Standard Variable Name that exactly matches that internal variable name.  If found, enter it in the appropriate column in the spreadsheet. ('''Note:'''  While this mapping is needed, there is no need to change your model's internal names.)  Otherwise, you can try to construct a standard name that conforms to the rules at:
 [http://csdms.colorado.edu/wiki/CSN_Basic_Rules '''Basic Rules of the CSDMS Standard Names''']
-and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols you might include in a scientific publication.  It is also required to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
+and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols, which are often included scientific publications.  It is also required to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
 In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  The latter includes any variables that your model reads from its configuration file prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.

@@ Line 23: / Line 23: @@
 then use your browser's search feature, along with the alphabetization, to search for a CSDMS Standard Variable Name that exactly matches that internal variable name.  If found, enter it in the appropriate column in the spreadsheet. ('''Note:'''  While this mapping is needed, there is no need to change your model's internal names.)  Otherwise, you can try to construct a standard name that conforms to the rules at:
 [http://csdms.colorado.edu/wiki/CSN_Basic_Rules '''Basic Rules of the CSDMS Standard Names''']
-and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols you might include in a scientific publication.  This mapping is also something that is needed to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
+and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols you might include in a scientific publication.  It is also required to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
 In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  The latter includes any variables that your model reads from its configuration file prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.

@@ Line 21: / Line 21: @@
 This [[:File:Variable_Info_Example.zip|'''zipped Excel spreadsheet''']] has a few examples of how to provide information on your model's internal variable names --- that is, the actual names, symbols or abbreviations you use in your model's source code.  You can delete the example entries (but not the column headings) and then enter similar information for your model.  For each variable name that your model uses internally, please go to: [http://csdms.colorado.edu/wiki/CSN_Searchable_List '''Searchable List of CSDMS Standard Names'''],
-then use your browser's search feature, along with the alphabetization, to search for a CSDMS Standard Variable Name that exactly matches that internal variable name.  If found, enter it in the appropriate column in the spreadsheet.  Otherwise, you can try to construct a standard name that conforms to the rules at:
+then use your browser's search feature, along with the alphabetization, to search for a CSDMS Standard Variable Name that exactly matches that internal variable name.  If found, enter it in the appropriate column in the spreadsheet. ('''Note:'''  While this mapping is needed, there is no need to change your model's internal names.)  Otherwise, you can try to construct a standard name that conforms to the rules at:
 [http://csdms.colorado.edu/wiki/CSN_Basic_Rules '''Basic Rules of the CSDMS Standard Names''']
-and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols you might include in a scientific publication.
+and then enter SUGGESTED in the Notes column of the spreadsheet.  If you don't want to try to construct a name, you can enter NOT FOUND in the Notes column.  Please note that internal variables such as counters, intermediates and others that you don't foresee sharing with another model do not need to be listed in this spreadsheet.  You can think of the variables in the spreadsheet as your model's "exchange items".  This mapping from your model's internal variable names to standardized, descriptive and unambiguous variable names is very similar to a List of Symbols you might include in a scientific publication.  This mapping is also something that is needed to implement a [http://csdms.colorado.edu/wiki/BMI_Description '''Basic Model Interface (BMI)'''] for your model.
 In the Units column, use standard units abbreviations followed by a positive or negative number to indicate a power, and spaces between as in "m s-1" for velocity units or "m3" for volume units.  In the Variable Kind column, indicate whether the variable is an input variable, output variable, or a model configuration variable.  The latter includes any variables that your model reads from its configuration file prior to each run.  Note that a variable can be both a configuration variable and an output variable, or and input variable and an output variable.  This simply means that your model, after acquiring the variable, can also share it as output.  Use the slash character as in "config/output" in such cases.

@@ Line 20: / Line 20: @@
 Variables are symbols associated with values (numerical or string type) and are arguably the fundamental currency of science.  These are the things we observe and measure, save in databases and predict with our computational models (and use to drive them).  They are also the key players in the equations that govern our physics. They are the "exchange items" that are passed between connected resources (e.g. models and datasets). However, to automate the sharing of variables between resources, semantic mediation is necessary, since every resource has its own internal vocabulary.
-This zipped Excel spreadsheet [[File:'''Variable_Info_Example.zip''']] has a few examples of how to provide information on your model's internal variable names --- that is, the actual names, symbols or abbreviations you use in your model's source code.  You can delete the example entries (but not the column headings) and then enter similar information for your model.  For each variable name that your model uses internally, please go to: [http://csdms.colorado.edu/wiki/CSN_Searchable_List '''Searchable List of CSDMS Standard Names'''],
+This zipped Excel spreadsheet [[:File:Variable_Info_Example.zip|'''zipped Excel spreadsheet''']] has a few examples of how to provide information on your model's internal variable names --- that is, the actual names, symbols or abbreviations you use in your model's source code.  You can delete the example entries (but not the column headings) and then enter similar information for your model.  For each variable name that your model uses internally, please go to: [http://csdms.colorado.edu/wiki/CSN_Searchable_List '''Searchable List of CSDMS Standard Names'''],
 then use your browser's search feature, along with the alphabetization, to search for a CSDMS Standard Variable Name that exactly matches that internal variable name.  If found, enter it in the appropriate column in the spreadsheet.  Otherwise, you can try to construct a standard name that conforms to the rules at:
 [http://csdms.colorado.edu/wiki/CSN_Basic_Rules '''Basic Rules of the CSDMS Standard Names''']