{"id":3572,"date":"2019-02-18T12:17:16","date_gmt":"2019-02-18T20:17:16","guid":{"rendered":"https:\/\/blogs.plm.automation.siemens.com\/t5\/Simcenter-Blog\/STAR-CCM-v11-06-Building-a-better-sim-file-part-1-of-2\/ba-p\/569329"},"modified":"2026-03-26T06:08:57","modified_gmt":"2026-03-26T10:08:57","slug":"star-ccm-v11-06-building-a-better-sim-file-part-1-of-2","status":"publish","type":"post","link":"https:\/\/blogs.sw.siemens.com\/simcenter\/star-ccm-v11-06-building-a-better-sim-file-part-1-of-2\/","title":{"rendered":"STAR-CCM+ v11.06: Building a better sim file &#8211; part 1 of 2"},"content":{"rendered":"\n<p><em><strong>Please note: Original publication date 10-18-2016<\/strong><\/em><\/p>\n\n\n\n<p>A well organized workshop, purposely conceived to build and revise things of interest, is truly appealing with its array of tools, carefully ordered, in a familiar and comfortable environment. Now you\u2019ve probably heard the expression \u201cUse the right tool for the right job.\u201d That works when you know what tools you have in your workshop, what they are supposed to do and exactly where you can find them. With the STAR-CCM+<sup>\u00ae<\/sup>&nbsp;v11.06 release, we\u2019re adding and upgrading tools that will improve your ability to productively build and revise your simulations. You\u2019ll be able to set up your simulations more comprehensively and consistently with a reduced likelihood of errors. And you\u2019ll be able to more efficiently conduct critical reviews in the deeper details of your simulations with your colleagues and your customers. In part one of this blog, I\u2019ll be talking about&nbsp;Simulation Parameters&nbsp;and&nbsp;Global Tagging.<\/p>\n\n\n\n<p>Before STAR-CCM+ v11.06, when you wanted to specify a constant for use in multiple locations, or as a part a more complex expression, you created a field function &#8211; a simple scalar, vector or tensor. But there\u2019s an overhead \u2013 a field function is evaluated and stored at every cell. That can become expensive when all you need to store is a single constant. This is perhaps the key difference between simulation parameters and field functions &#8211; the former objects, being \u201cspatially invariant,\u201d only need to be stored once. Here are a few other things you need to know about simulation parameters: they can be defined as either scalars or vectors; referenced by other simulation parameters; be used in field functions. You can use them in our 3D-CAD tool to modify geometry, or anywhere that you can use either a field function or type-in expression now.&nbsp;Let\u2019s consider a biomedical application, where we have a notional drug delivery catheter in place near a stenosis in an artery (shown below).<\/p>\n\n\n\n<p><span class=\"lia-inline-image-display-wrapper lia-image-align-inline\" style=\"width: 999px\"><img decoding=\"async\" title=\"artery_catheter_sim_params.png\" src=\"http:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/6\/2019\/09\/artery_catheter_sim_params-1.png\" alt=\"artery_catheter_sim_params.png\"><span class=\"lia-inline-image-caption\">A tracer released at the catheter inlet and exiting from the holes in the catheter is shown using volume rendering. The artery inlet flow speed (left axis) versus time is shown in the plot (lower right). Expression reports which calculate the bulk tracer concentration are set up for six planes (A thru F) along the axis of the artery and are also plotted versus time (right axis). Per-part reporting (also introduced with STAR-CCM+ v11.06) simplifies the creation of the expression reports used in this quantitative assessment of drug delivery.<\/span><\/span><\/p>\n\n\n\n<p>At the upstream inlet, the annular space between the artery wall and the catheter outer wall, we can use an analytical equation <strong>[<\/strong><strong>1]<\/strong>&nbsp;to apply a fully developed flow profile. We define simulation parameters (<em><strong>X<\/strong>s<\/em>) for the artery wall radius, the outer catheter wall radius and the mean flow rate and use them in a field function (<em><strong>fx<\/strong>s<\/em>) for the steady velocity profile. Now, the arterial flow rate also changes in response to the cardiac rhythm. Again, there is an analytical equation available <strong>[<\/strong><strong>2]<\/strong>&nbsp;that takes this into account. We define simulation parameters for the pulse rate, BPM (beats per minute), and the value of PI&nbsp;. A second time varying field function (<em><strong>fx<\/strong>s<\/em>) for the unsteady velocity profile incorporates the steady velocity profile and these additional simulation parameters (<em><strong>X<\/strong>s<\/em>).&nbsp;Taking this one more step, we\u2019re going to consistently set the time step for our Implicit Unsteady solver by encapsulating our BPM simulation parameter within another simulation parameter &#8211; when we change the flow rate, as defined by BPM, the time step can be automatically changed.&nbsp;<\/p>\n\n\n\n<p><span class=\"lia-inline-image-display-wrapper lia-image-align-inline\" style=\"width: 999px\"><img decoding=\"async\" title=\"use_simulation_parameter.png\" src=\"http:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/6\/2019\/09\/use_simulation_parameter-1.png\" alt=\"use_simulation_parameter.png\"><span class=\"lia-inline-image-caption\">Use a simulation parameter BPM to set the time-step size used by the solver.<\/span><\/span><\/p>\n\n\n\n<p>We\u2019ve now built a simulation ready to study a range of flow rates in the most physiologically realistic way that also lets us explore a broad combination of patient physiologies and catheter sizes.&nbsp;It\u2019s handy to be able to get an overview as you work on a simulation effort. That starts with good organization, and this is where tagging comes into our discussion. Tags aren\u2019t new; they\u2019ve been around for a while. But they\u2019ve gotten a major upgrade in this release \u2013 they are now available for nearly every object on the simulation tree. Tags give you a way to connect objects that might not otherwise be easily or logically associated. Let\u2019s go back to our biomedical application. First, we\u2019ve created tags called \u201c<strong>problem_setup<\/strong>\u201d and \u201c<strong>instrumentation<\/strong>\u201d with the intent of identifying objects on the tree that are associated with either the setup of the problem, or are needed for quantitative and qualitative assessments of the results. Some objects are associated with both, and multiple tags are allowed. This exercise is something that can be ideally done while you are building your sim file.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"http:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/6\/2019\/09\/multiple_tag_usage_in_custom_trees-1.png\" alt=\"multiple_tag_usage_in_custom_trees.png\" title=\"multiple_tag_usage_in_custom_trees.png\" \/><\/figure>\n\n\n\n<p><span class=\"lia-inline-image-display-wrapper lia-image-align-inline\" style=\"width: 400px\"><\/span><\/p>\n\n\n\n<p>Next, we create a Custom Tree (one of our top features in STAR-CCM+ v11.04) directly for each tag. This makes it easier to see the connection between our simulation parameters, field functions, and where they are actually used. We can easily check that our simulation is properly instrumented before we start our transient run. These tag-based custom trees let us efficiently review our simulation with other colleagues to potentially catch any errors or omissions. In the end. We expect that being able to efficiently scrutinize a problem setup before submitting it will increase the confidence in our analysis setup and any conclusions that we\u2019re able to draw from the results. &nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/videos.mentor-cdn.com\/mgc\/videos\/5400\/d5f2aab7-df57-414f-95a4-503ef76f7497-en-US-video.mp4\"><\/video><\/figure>\n\n\n\n<p>In the animation above, a tracer species, released at the catheter inlet and exiting from the holes in the catheter is shown using volume rendering. The artery inlet flow speed (left axis) versus time is shown in the plot (lower right). Expression reports which calculate the bulk tracer concentration are set up for six planes (A thru F) along the axis of the artery and are also plotted versus time (right axis). Per-part reporting (also introduced with STAR-CCM+ v11.06) simplifies the creation of the expression reports used in this quantitative assessment of drug delivery.<\/p>\n\n\n\n<p>We started our discussion by recognizing that you need the right tool for the right job. That\u2019s certainly true, and it\u2019s also fair to say that you\u2019re only as good as your tools. We hope that simulation parameters and tagging will truly help you to build better sim files that are easier to understand, run more robustly, and in the end, repeatedly deliver highly accurate results that you can be confident in. &nbsp;&nbsp;<\/p>\n\n\n\n<p><strong>References<\/strong><\/p>\n\n\n\n<p><strong>[1]<\/strong> Bird RB, Stewart WE &amp; Lightfoot EN,&nbsp;Transport Phenomena, 3rd printing, John Wiley &amp; Sons; 1960.<\/p>\n\n\n\n<p><span style=\"font-family: inherit\"><strong>[2]<\/strong> Womersley JR., Method for the calculation of velocity, rate of flow and viscous drag in arteries when the pressure gradient is known.&nbsp;<\/span><span style=\"font-family: inherit\">J. Physiol<\/span><span style=\"font-family: inherit\">. 1955; 127:553-563.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Please note: Original publication date 10-18-2016<br \/>\n &nbsp;<br \/>\n  A well organized workshop, purposely conceived to build and revise things of interest, is truly appealing with its array of tools, caref&#8230;<\/p>\n","protected":false},"author":23421,"featured_media":3581,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spanish_translation":"","french_translation":"","german_translation":"","italian_translation":"","polish_translation":"","japanese_translation":"","chinese_translation":"","footnotes":""},"categories":[1],"tags":[5,242],"industry":[],"product":[513],"coauthors":[],"class_list":["post-3572","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","tag-cae-simulation","tag-computational-fluid-dynamics-cfd","product-simcenter-star-ccm"],"featured_image_url":"https:\/\/blogs.sw.siemens.com\/wp-content\/uploads\/sites\/6\/2019\/09\/use_simulation_parameter-1.png","_links":{"self":[{"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/posts\/3572","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/users\/23421"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/comments?post=3572"}],"version-history":[{"count":4,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/posts\/3572\/revisions"}],"predecessor-version":[{"id":16779,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/posts\/3572\/revisions\/16779"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/media\/3581"}],"wp:attachment":[{"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/media?parent=3572"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/categories?post=3572"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/tags?post=3572"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/industry?post=3572"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/product?post=3572"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/simcenter\/wp-json\/wp\/v2\/coauthors?post=3572"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}