Commits (2)
...@@ -1237,7 +1237,7 @@ Instead of artificial example classes like <em>Foo</em> and <em>Bar</em> it show ...@@ -1237,7 +1237,7 @@ Instead of artificial example classes like <em>Foo</em> and <em>Bar</em> it show
</div> </div>
<div class="imageblock thumb"> <div class="imageblock thumb">
<div class="content"> <div class="content">
<img src="http://localhost:63793/afx/cache/28c119036261e39473751e5cb111acc9.png" alt="28c119036261e39473751e5cb111acc9"> <img src="http://localhost:52486/afx/cache/28c119036261e39473751e5cb111acc9.png" alt="28c119036261e39473751e5cb111acc9">
</div> </div>
<div class="title">Figure 4. Principle Structure of a Parameter Catalog</div> <div class="title">Figure 4. Principle Structure of a Parameter Catalog</div>
</div> </div>
...@@ -1889,7 +1889,10 @@ To our convenience, view model specifications incompatible with data model are i ...@@ -1889,7 +1889,10 @@ To our convenience, view model specifications incompatible with data model are i
<h3 id="trueadd-units-to-the-mix"><a class="anchor" href="#trueadd-units-to-the-mix"></a>Add Units to the Mix</h3> <h3 id="trueadd-units-to-the-mix"><a class="anchor" href="#trueadd-units-to-the-mix"></a>Add Units to the Mix</h3>
<div class="paragraph"> <div class="paragraph">
<p>As mentioned earlier, parameter catalogs should be able to represent quantities, not just bare numbers. <p>As mentioned earlier, parameter catalogs should be able to represent quantities, not just bare numbers.
Java provides an extensive framework to deal with quantities and their units defined in <a href="https://docs.google.com/document/d/12KhosAFriGCczBs6gwtJJDfg_QlANT92_lhxUWO2gCY/edit#heading=h.6698n7erex5o">Java Specification Request (JSR) 385</a>. See <a href="https://onlinelibrary.wiley.com/doi/full/10.1002/spe.2926">Unit of measurement libraries, their popularity and suitability</a> for a systematic account of open source solutions in the this area.</p>
</div>
<div class="paragraph">
<p>Java provides an extensive framework to deal with quantities and their units defined in <a href="https://docs.google.com/document/d/12KhosAFriGCczBs6gwtJJDfg_QlANT92_lhxUWO2gCY/edit#heading=h.6698n7erex5o">Java Specification Request (JSR) 385</a>.
The reference implementation for this framework is <a href="https://unitsofmeasurement.github.io/indriya/">Indriya</a>. Demos of its usage can be found at <a href="https://unitsofmeasurement.github.io/uom-demos/" class="bare">https://unitsofmeasurement.github.io/uom-demos/</a>.</p> The reference implementation for this framework is <a href="https://unitsofmeasurement.github.io/indriya/">Indriya</a>. Demos of its usage can be found at <a href="https://unitsofmeasurement.github.io/uom-demos/" class="bare">https://unitsofmeasurement.github.io/uom-demos/</a>.</p>
</div> </div>
<div class="paragraph"> <div class="paragraph">
...@@ -1944,7 +1947,7 @@ Finally, restart Eclipse to complete plug-in installation.</p> ...@@ -1944,7 +1947,7 @@ Finally, restart Eclipse to complete plug-in installation.</p>
<p>The symbols for defining units follow SI and other standards, including decimal prefixes like <code>m</code> for Milli or <code>G</code> for Giga as well as derived units, that is: <code>mV</code>, <code>GV</code> or <code>kW·h/m³</code> are all valid unit definitions. This is all documented well in the resources mentioned at the top of this section, but for convenience, a table with valid units, including some specific units for urban simulation, is compiled in <a href="UnitsExamples.md" class="bare">UnitsExamples.md</a>.</p> <p>The symbols for defining units follow SI and other standards, including decimal prefixes like <code>m</code> for Milli or <code>G</code> for Giga as well as derived units, that is: <code>mV</code>, <code>GV</code> or <code>kW·h/m³</code> are all valid unit definitions. This is all documented well in the resources mentioned at the top of this section, but for convenience, a table with valid units, including some specific units for urban simulation, is compiled in <a href="UnitsExamples.md" class="bare">UnitsExamples.md</a>.</p>
</div> </div>
<div class="paragraph"> <div class="paragraph">
<p>If a unit symbol cannot be interpreted, this error is not already detected while generating and compiling code from model, but not before runt time when the application tries to create the default value. In that case, you will see an error message like this:</p> <p>If a unit symbol cannot be interpreted, this error is not already detected while generating and compiling code from model, but not before run time when the application tries to create the default value. In that case, you will see an error message like this:</p>
</div> </div>
<div class="imageblock thumb"> <div class="imageblock thumb">
<div class="content"> <div class="content">
...@@ -1989,7 +1992,7 @@ Finally, restart Eclipse to complete plug-in installation.</p> ...@@ -1989,7 +1992,7 @@ Finally, restart Eclipse to complete plug-in installation.</p>
<div class="content"> <div class="content">
<img src="ParameterCatalogs2Images/ReferenceGeneratorModel.png" alt="Install Plug-in" width="500"> <img src="ParameterCatalogs2Images/ReferenceGeneratorModel.png" alt="Install Plug-in" width="500">
</div> </div>
<div class="title">Figure 23. Add Reference to imported Generator Model</div> <div class="title">Figure 23. Add Reference to Imported Generator Model</div>
</div> </div>
<div class="paragraph"> <div class="paragraph">
<p>If no generator model is available for selection, press button <code>Add&#8230;&#8203;</code> to add it first (this only works if <code>QuantityLong</code> or <code>QuantityDouble</code> were used at least once in the Ecore model).</p> <p>If no generator model is available for selection, press button <code>Add&#8230;&#8203;</code> to add it first (this only works if <code>QuantityLong</code> or <code>QuantityDouble</code> were used at least once in the Ecore model).</p>
...@@ -2218,7 +2221,7 @@ Verify that Maven version 3.6.3 or above is now installed in <code>Window &#8594 ...@@ -2218,7 +2221,7 @@ Verify that Maven version 3.6.3 or above is now installed in <code>Window &#8594
</div> </div>
<div id="footer"> <div id="footer">
<div id="footer-text"> <div id="footer-text">
Last updated 2021-04-13 18:45:28 +0200 Last updated 2021-04-18 10:06:04 +0200
</div> </div>
</div> </div>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.6/styles/github.min.css"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.6/styles/github.min.css">
......
...@@ -709,6 +709,8 @@ Changes in data model also can make existing XML data incompatible. There are to ...@@ -709,6 +709,8 @@ Changes in data model also can make existing XML data incompatible. There are to
=== Add Units to the Mix === Add Units to the Mix
As mentioned earlier, parameter catalogs should be able to represent quantities, not just bare numbers. As mentioned earlier, parameter catalogs should be able to represent quantities, not just bare numbers.
See https://onlinelibrary.wiley.com/doi/full/10.1002/spe.2926[Unit of measurement libraries, their popularity and suitability] for a systematic account of open source solutions in the this area.
Java provides an extensive framework to deal with quantities and their units defined in https://docs.google.com/document/d/12KhosAFriGCczBs6gwtJJDfg_QlANT92_lhxUWO2gCY/edit#heading=h.6698n7erex5o[Java Specification Request (JSR) 385]. Java provides an extensive framework to deal with quantities and their units defined in https://docs.google.com/document/d/12KhosAFriGCczBs6gwtJJDfg_QlANT92_lhxUWO2gCY/edit#heading=h.6698n7erex5o[Java Specification Request (JSR) 385].
The reference implementation for this framework is https://unitsofmeasurement.github.io/indriya/[Indriya]. Demos of its usage can be found at https://unitsofmeasurement.github.io/uom-demos/[]. The reference implementation for this framework is https://unitsofmeasurement.github.io/indriya/[Indriya]. Demos of its usage can be found at https://unitsofmeasurement.github.io/uom-demos/[].
...@@ -740,7 +742,7 @@ Note here, that I also changed the default value from `0.0` to `0.0 V` to indica ...@@ -740,7 +742,7 @@ Note here, that I also changed the default value from `0.0` to `0.0 V` to indica
The symbols for defining units follow SI and other standards, including decimal prefixes like `m` for Milli or `G` for Giga as well as derived units, that is: `mV`, `GV` or `kW·h/m³` are all valid unit definitions. This is all documented well in the resources mentioned at the top of this section, but for convenience, a table with valid units, including some specific units for urban simulation, is compiled in link:UnitsExamples.md[]. The symbols for defining units follow SI and other standards, including decimal prefixes like `m` for Milli or `G` for Giga as well as derived units, that is: `mV`, `GV` or `kW·h/m³` are all valid unit definitions. This is all documented well in the resources mentioned at the top of this section, but for convenience, a table with valid units, including some specific units for urban simulation, is compiled in link:UnitsExamples.md[].
If a unit symbol cannot be interpreted, this error is not already detected while generating and compiling code from model, but not before runt time when the application tries to create the default value. In that case, you will see an error message like this: If a unit symbol cannot be interpreted, this error is not already detected while generating and compiling code from model, but not before run time when the application tries to create the default value. In that case, you will see an error message like this:
.Error Message for Wrong Unit Definition .Error Message for Wrong Unit Definition
image::ErrorInUnitDefinition.png[Install Plug-in , 400, role="thumb"] image::ErrorInUnitDefinition.png[Install Plug-in , 400, role="thumb"]
...@@ -758,7 +760,7 @@ One last technicality. *Before* code from an Ecore model with attributes of type ...@@ -758,7 +760,7 @@ One last technicality. *Before* code from an Ecore model with attributes of type
. Choose `Ecore model`, press `Next >` and `Load` the model (again) . Choose `Ecore model`, press `Next >` and `Load` the model (again)
. `Next >` will open the page below. In section _Referenced Generator Models_ select the Quantities generator model as depicted and click on `Finish`. . `Next >` will open the page below. In section _Referenced Generator Models_ select the Quantities generator model as depicted and click on `Finish`.
.Add Reference to imported Generator Model .Add Reference to Imported Generator Model
image::ReferenceGeneratorModel.png[Install Plug-in , 500, role="thumb"] image::ReferenceGeneratorModel.png[Install Plug-in , 500, role="thumb"]
If no generator model is available for selection, press button `Add...` to add it first (this only works if `QuantityLong` or `QuantityDouble` were used at least once in the Ecore model). If no generator model is available for selection, press button `Add...` to add it first (this only works if `QuantityLong` or `QuantityDouble` were used at least once in the Ecore model).
......