{"id":4179,"date":"2023-03-18T11:39:56","date_gmt":"2023-03-18T10:39:56","guid":{"rendered":"http:\/\/mosaic-modeling.de\/?page_id=4179"},"modified":"2023-08-22T09:54:37","modified_gmt":"2023-08-22T08:54:37","slug":"simulation-specifications","status":"publish","type":"page","link":"https:\/\/mosaic-modeling.de\/?page_id=4179","title":{"rendered":"Simulation: Specifications"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_83 counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">On this page<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mosaic-modeling.de\/?page_id=4179\/#Purpose\" >Purpose<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mosaic-modeling.de\/?page_id=4179\/#Explanation-of-the-editor\" >Explanation of the editor<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mosaic-modeling.de\/?page_id=4179\/#Variable-specification\" >Variable specification<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mosaic-modeling.de\/?page_id=4179\/#Parameter-specification\" >Parameter specification<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n\n<p class=\"has-vivid-red-color has-text-color\"><strong>Mandatory element<\/strong><\/p>\n\n\n<p>After the equation system was loaded and the indices were specified, the model can be specified.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Purpose\"><\/span>Purpose<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>The specifications allow the user to\u00a0<\/p>\n<ul>\n<li>assign variables to a specific group<\/li>\n<li>assign values to variables and parameters<\/li>\n<li>look at the used namespaces within the equation system<\/li>\n<li>save the variable and parameter specification for later use<\/li>\n<\/ul>\n<h3><span class=\"ez-toc-section\" id=\"Explanation-of-the-editor\"><\/span>Explanation of the editor<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>As there are many aspects to discuss in the variable and parameter specification, both tabs are explained individually.<\/p>\n<h4><span class=\"ez-toc-section\" id=\"Variable-specification\"><\/span>Variable specification<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>Once your equation system is instantiated, all variables that are not added to a parameter list appear in the window in Figure 1 (usually as unspecified). Is is then up to you to assign them their respective type. You can do that by selecting the type in the respective column. The variable specification differs between many different types of variables, i.e.,<\/p>\n<ul>\n<li>design values: fixed variables<\/li>\n<li>iteration values: (algebraic) variables that are (iteratively) solved in the simulation<\/li>\n<li>parameter: parameters that are not (for some reason) part of the parameter list<\/li>\n<li>Calculated values: these variables are those calculated by defined functions<\/li>\n<li>differential variables: the independent variable in differential equations, usually time or space<\/li>\n<li>state variables: these variables appear in differentials\u00a0<\/li>\n<li>unspecified: all variables are initialized with this type<\/li>\n<li>optimization var: degrees of freedom in an optimization problem<\/li>\n<li>objective var: variable that is minimized or maximized in an optimization<\/li>\n<li>control: variable that can be manipulated for control purposes<\/li>\n<li>measurement: variable that is measured<\/li>\n<li>timepoint: a variable characterizing a time poit during the solution, e.g., a switch function<\/li>\n<\/ul>\n<p>Note that some of these types are only necessary for optimization. The differentiation of these variables is of particular advantage when you want to design your own user-defined language specificator. If you only want to solve your model in a simulation, the design, iteration, and state variables usually suffice.<\/p>\n<p>In each window, you see the namespace of the variable, its name, and its index (an internal value). Furthermore, you can manipulate the type (as explained above), the value, and the lower and upper bound. Additional capabilities include marking a variable as integer (for optimization), changing the scaling, selecting the engineering unit, marking a variable as independent initial condition, and entering the OPC UA name (for online applications). If you want to change the current value for more than one variable, you can always select them and right-click. Table 2 describes all element in the variable specification.<\/p>\n<figure id=\"attachment_4958\" aria-describedby=\"caption-attachment-4958\" style=\"width: 1920px\" class=\"wp-caption alignnone\"><a href=\"http:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-4958\" src=\"http:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications.png\" alt=\"\" width=\"1920\" height=\"1080\" srcset=\"https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications.png 1920w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-300x169.png 300w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-1024x576.png 1024w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-768x432.png 768w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-1536x864.png 1536w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-1110x624.png 1110w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_VariableSpecifications-528x297.png 528w\" sizes=\"auto, (max-width: 1920px) 100vw, 1920px\" \/><\/a><figcaption id=\"caption-attachment-4958\" class=\"wp-caption-text\">Figure 1: Editor of the variable specification.<\/figcaption><\/figure>\n\n\n<figure class=\"wp-block-table is-style-stripes has-small-font-size\"><table><thead><tr><th class=\"has-text-align-center\" data-align=\"center\">Element<\/th><th class=\"has-text-align-left\" data-align=\"left\">Explanation<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\">Var Specs<\/td><td class=\"has-text-align-left\" data-align=\"left\">Filename of your variable specification once you have saved or loaded it. You can save several variable specifications for the same simulation, but the simulation always saves which specification was loaded last<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Type of Equation System<\/td><td class=\"has-text-align-left\" data-align=\"left\">Tells you which type of equation system you have loaded, e.g., nonlinear equation system (NLE) or differential-algebraic equation system (DAE)<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Degrees of Freedom<\/td><td class=\"has-text-align-left\" data-align=\"left\">Determines the degree of freedom by subtracting the number of equations from the number of non-fixed variables<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Get Analysis Results<\/td><td class=\"has-text-align-left\" data-align=\"left\">Currently disabled<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Import Values<\/td><td class=\"has-text-align-left\" data-align=\"left\">Allows you to import a list of variables as long as these naming of these variables follows the syntax of the selected programming language within MOSAICmodeling. You can simultaneously import the values and lower and upper bounds<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Test Iteration<\/td><td class=\"has-text-align-left\" data-align=\"left\">Performs a calculation of the residuals of all equations based on the currently set values for all variables. This feature is not automatically available for all users. If you cannot see this, please contact us<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Calculate Functions<\/td><td class=\"has-text-align-left\" data-align=\"left\">Triggers a call to all functions within the model using the currently assigned values of the variables<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Differential Variable<\/td><td class=\"has-text-align-left\" data-align=\"left\">Lets you specify initial and end point of the differential variable. You can also enter how many reported points are created<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Table 1: Elements of the variable specification.<\/figcaption><\/figure>\n\n\n<h4><span class=\"ez-toc-section\" id=\"Parameter-specification\"><\/span>Parameter specification<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>The parameter specification is similar to the variable specification in its structure as shown in Figure 2. You can also save parameter specifications. The available parameter types include<\/p>\n<ul>\n<li>unspecified: every parameter is initialized with this type<\/li>\n<li>fixed: parameter cannot be changed, e.g., universal constants<\/li>\n<li>adjustable: parameters that can be changed, e.g., the number of tubes in a fixed-bed reactor. This is specifically relevant when you want to export your system as a unit operation in ACM or other tools<\/li>\n<li>as decision: parameters that shall be decision variables in an optimization problem<\/li>\n<li>as control: parameters that shall be controls in an optimization problem<\/li>\n<\/ul>\n<p>The parameters have basically the same columns as the variables. Note that some of these types are only necessary for optimization. The differentiation of these parameter types is of particular advantage when you want to design your own user-defined language specificator. If parameters shall be used in a parameter estimation, the assigment of lower and upper bounds can be of use. All elements of the parameter specification are explained in Table 2. <\/p>\n<figure id=\"attachment_4957\" aria-describedby=\"caption-attachment-4957\" style=\"width: 1920px\" class=\"wp-caption alignnone\"><a href=\"http:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-4957\" src=\"http:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications.png\" alt=\"\" width=\"1920\" height=\"1080\" srcset=\"https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications.png 1920w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-300x169.png 300w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-1024x576.png 1024w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-768x432.png 768w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-1536x864.png 1536w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-1110x624.png 1110w, https:\/\/mosaic-modeling.de\/wp-content\/uploads\/2023\/08\/Editor_ParameterSpecifications-528x297.png 528w\" sizes=\"auto, (max-width: 1920px) 100vw, 1920px\" \/><\/a><figcaption id=\"caption-attachment-4957\" class=\"wp-caption-text\">Figure 2: Editor of the parameter specification.<\/figcaption><\/figure>\n\n\n<figure class=\"wp-block-table is-style-stripes has-small-font-size\"><table><thead><tr><th class=\"has-text-align-center\" data-align=\"center\">Element<\/th><th class=\"has-text-align-left\" data-align=\"left\">Explanation<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-center\" data-align=\"center\">Par Specs<\/td><td class=\"has-text-align-left\" data-align=\"left\">Filename of your parameter specification once you have saved or loaded it. You can save several parameter specifications for the same simulation, but the simulation always saves which specification was loaded last<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Import Values<\/td><td class=\"has-text-align-left\" data-align=\"left\">Allows you to import parameter values in the same way as in the variable specification<\/td><\/tr><tr><td class=\"has-text-align-center\" data-align=\"center\">Properties<\/td><td class=\"has-text-align-left\" data-align=\"left\">Currently no use<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Table 2: Elements of the parameter specification.<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Mandatory element After the equation system was loaded and the indices were specified, the model can be specified. Purpose The specifications allow the user to\u00a0 assign variables to a specific group assign values to variables and parameters look at the used namespaces within the equation system save the variable and parameter specification for later use [&hellip;]<\/p>\n","protected":false},"author":252,"featured_media":0,"parent":4174,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4179","page","type-page","status-publish","czr-hentry"],"_links":{"self":[{"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/pages\/4179","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/users\/252"}],"replies":[{"embeddable":true,"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=4179"}],"version-history":[{"count":9,"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/pages\/4179\/revisions"}],"predecessor-version":[{"id":5688,"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/pages\/4179\/revisions\/5688"}],"up":[{"embeddable":true,"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=\/wp\/v2\/pages\/4174"}],"wp:attachment":[{"href":"https:\/\/mosaic-modeling.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4179"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}