<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns:mml = "http://www.w3.org/1998/Math/MathML" lang = "en"><head><meta charset = "UTF-8"/><meta name = "copyright" content = "(C) Copyright 2020"/><meta name = "DC.rights.owner" content = "(C) Copyright 2020"/><meta name = "DC.type" content = "reference"/><meta name = "abstract" content = "Defines which data of the FE model, the FE calculation, or the optimization should be saved in a specified file."/><meta name = "description" content = "Defines which data of the FE model, the FE calculation, or the optimization should be saved in a specified file."/><meta name = "DC.relation" scheme = "URI" content = "../TsoUserMap/tso-c-usr-post-toolbox-usrOut.htm#tso-c-usr-post-toolbox-usrOut"/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-r-cmd-userFile"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>USER_FILE</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-r-cmd-userFile">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>USER_FILE</h1></td></tr><tr><td class = "DocHeader4" colspan = "2"/></tr><tr><td class = "DocHeader3"><table class = "DocHeaderIntro" id = "table12"><tr><td class = "Intro1Only"><p class = "header"><p class = "abstract">
<span class = "shortdesc">Defines which data of the FE model, the FE calculation, or the optimization should be
      saved in a specified file.</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-r-cmd-userFile__tso-r-cmd-userFile-rmk" id = "toc_rg" title = "">Remarks</a></li><li><a href = "#tso-r-cmd-userFile__tso-r-cmd-userFile-expl" id = "toc_rg" title = "">Examples</a></li></ul>
</p></td></tr></table></td><td class = "DocHeader2"><table class = "DocTopicsSeeAlso" id = "table13"><tr><td class = "TopicsTitle">See Also</td></tr></table><table class = "DocTopicsInOtherGuides" id = "table14"><tr><td height = "8px"/></tr><tr><td class = "TopicsTitleNormal">In Other Guides</td></tr><tr><td><a title = "In addition to the standard output files TOSCA.OUT, TOSCA.LOG, and optimization_report.csv, the files in user-defined output can be generated. For the evaluation or documentation of the optimization results, it is useful to specifically write some information from the large amount of data to individual files. With the USER_FILE command, the user can create customized output files. These files contain specific information from selected groups in a special format." href = "../TsoUserMap/tso-c-usr-post-toolbox-usrOut.htm#tso-c-usr-post-toolbox-usrOut">User-Defined Output Files (USER_FILE)</a></td></tr></table></td></tr></table>




<div class = "body refbody">
<table class = "table" id = "tso-r-cmd-userFile__aa1401710"><caption/><colgroup><col/><col/><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">ID_NAME</span></p></td>
<td class = "entry"><p>&lt;<code class = "ph codeph">id_name_of_user_file</code>&gt;</p></td>
<td class = "entry"><p>Name of the <code class = "ph codeph">USER_FILE</code> definition.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">FILE_NAME</span></p></td>
<td class = "entry"><p>&lt;<code class = "ph codeph">file_name</code>&gt;</p></td>
<td class = "entry"><p>Name of the file.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">FILE_OPTION</span></p></td>
<td class = "entry"/>
<td class = "entry"><p>Specification of file attributes.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= FIX</p></td>
<td class = "entry"><p>File is created only once. With a new written statement, this file is overwritten.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p><span class = "ph uicontrol">= ADD</span></p></td>
<td class = "entry"><p>New written statement is added to the end of the file.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= VAR</p></td>
<td class = "entry"><p>File name is extended with a numerator (iteration number).</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= VAR2</p></td>
<td class = "entry"><p>File name is extended with a numerator (iteration number-1).</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">FORMAT</span></p></td>
<td class = "entry"/>
<td class = "entry"><p>Determine the format that the file should be written in.</p></td>
</tr>


<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= ONF</p></td>
<td class = "entry"><p>Output is in Optimization Neutral File (ONF) format.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= HTML</p></td>
<td class = "entry"><p>Output is in HTML.</p></td>
</tr>

<tr class = "row">
<td class = "entry"><p>EL_GROUP</p></td>
<td class = "entry"><p>= &lt;<code class = "ph codeph">name_of_element_group</code>&gt;</p></td>
<td class = "entry"><p>Name of the element group that is used to define the <code class = "ph codeph">USER_FILES</code>.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p>ND_GROUP</p></td>
<td class = "entry"><p>= &lt;<code class = "ph codeph">name_of_node_group</code>&gt;</p></td>
<td class = "entry"><p>Name of the node group that is used to define the <code class = "ph codeph">USER_FILES</code>.</p></td>
</tr>

<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TYPE</span></p></td>
<td class = "entry"/>
<td class = "entry"><p>Type of data that is to be written. Depends on the <code class = "ph codeph">FORMAT</code>.</p></td>
</tr>
<tr class = "row">
<td class = "entry" colspan = "3"><p>for <code class = "ph codeph">FORMAT = ASCII</code>:</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TYPE</span></p></td>
<td class = "entry"><p><span class = "ph uicontrol">= </span><span class = "ph uicontrol">TABULAR</span></p></td>
<td class = "entry"><p>Output of variables in tables.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= CATIA_RSO</p></td>
<td class = "entry"><p>Output of geometry modifications by shape optimization for transfer to CATIA RSO module. </p></td>
</tr>



































<tr class = "row">
<td class = "entry" colspan = "3"><p>for <code class = "ph codeph">FORMAT = ONF</code>:</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TYPE</span></p></td>
<td class = "entry"><p>= GROUPS</p></td>
<td class = "entry"><p>Definition of node groups and element groups.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= SHAPE_DATA</p></td>
<td class = "entry"><p>Specific data for shape optimization.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= BEAD_DATA</p></td>
<td class = "entry"><p>Specific data for bead optimization.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= TOPO_DATA</p></td>
<td class = "entry"><p>Specific data for topology optimization.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= SIZING_DATA</p></td>
<td class = "entry"><p>Specific data for sizing optimization.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= SHAPE_WITH_SENS</p></td>
<td class = "entry"><p>Specific data for shape optimization with sensitivity fields.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= BEAD_WITH_SENS</p></td>
<td class = "entry"><p>Specific data for bead optimization with sensitivity fields.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= TOPO_WITH_SENS</p></td>
<td class = "entry"><p>Specific data for topology optimization with sensitivity fields.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= SIZING_WITH_SENS</p></td>
<td class = "entry"><p>Specific data for sizing optimization with sensitivity fields.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= TEST_SHAPE_LEVEL</p></td>
<td class = "entry"><p>Output for <code class = "ph codeph">TEST_SHAPE</code> command.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= FINITE_MODEL, &lt;<code class = "ph codeph">coordinate_system_option</code>&gt;</p></td>
<td class = "entry"><p>Output of node and element information of the FE model.</p></td>
</tr>









<tr class = "row">
<td class = "entry" colspan = "3"><p>for <code class = "ph codeph">FORMAT = HTML</code>:</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TYPE</span></p></td>
<td class = "entry"><p>= TABULAR</p></td>
<td class = "entry"><p>Output of variables in tables.</p></td>
</tr>













































































<tr class = "row">
<td class = "entry" colspan = "3"><p>For <code class = "ph codeph">TYPE=FINITE_MODEL</code> only:</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p>&lt;<code class = "ph codeph">coordinate _system_ option</code>&gt;</p></td>
<td class = "entry"><p>= LOCAL</p></td>
<td class = "entry"><p>Node coordinates are distributed in the local coordinate system.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= GLOBAL</p></td>
<td class = "entry"><p>Node coordinates are in the global Cartesian coordinate system.</p></td>
</tr>
<tr class = "row">
<td class = "entry" colspan = "3"><p>For <code class = "ph codeph">TYPE=TABULAR</code> only:</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p>DATA_TAB</p></td>
<td class = "entry"><p>= &lt;<code class = "ph codeph">var_name</code>&gt;</p></td>
<td class = "entry"><p>Determines which variables &lt;<code class = "ph codeph">var_name</code>&gt; are written.</p>
                      </td>
</tr>
<tr class = "row">
<td class = "entry"><p>TITLE_1</p></td>
<td class = "entry"><p>= &lt;<code class = "ph codeph">Title_1</code>&gt;</p></td>
<td class = "entry"><p>Title 1 for ASCII file.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p>TITLE_2</p></td>
<td class = "entry"><p>= &lt;<code class = "ph codeph">Title_2</code>&gt;</p></td>
<td class = "entry"><p>Title 2 for ASCII file.</p></td>
</tr>
<tr class = "row">
<td class = "entry" colspan = "3">
  <p>For <code class = "ph codeph">FORMAT = ASCII, TYPE = TABULAR</code>
   only:</p>
</td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">SEPARATOR</span></p></td>
<td class = "entry"/>
<td class = "entry"><p>Separation character between columns.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= SPACE</p></td>
<td class = "entry"><p>Blank.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= BLANK</p></td>
<td class = "entry"><p>Blank.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= TAB</p></td>
<td class = "entry"><p>Tabulator.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p><span class = "ph uicontrol">= </span><span class = "ph uicontrol">COMMA</span></p></td>
<td class = "entry"><p>Comma.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= EXCLAM</p></td>
<td class = "entry"><p>Exclamation mark.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= &lt;<code class = "ph codeph">xx</code>&gt;</p></td>
<td class = "entry"><p>Any kind of character separator, maximum two characters.</p></td>
</tr>














</tbody></table>

<div class = "section" id = "tso-r-cmd-userFile__tso-r-cmd-userFile-rmk"><h2 class = "title sectiontitle">Remarks</h2>

<ol class = "ol">
<li class = "li">
The data can be generated in different formats. The following entries are necessary to obtain a
complete definition of the file to be generated using the command
<code class = "ph codeph">USER_FILE</code>: Presettings already exist in the system for many of these
settings. By entering a relevant value, these are overwritten. The settings are done using
the command END_ and the active default values are checked for consistency of entries, to
check if the written command can be executed. If the file cannot be generated due to
entries canceling each other (for example, an attempt to generate data referring to elements for
a node group), the system shows a warning and the write command is not activated. Only
when all entries are consistent can the file be activated for writing.
<ul class = "ul">
<li class = "li">Name of the file in which the results are to be shown</li>
<li class = "li">Type of file</li>
<li class = "li">Output format</li>
<li class = "li">Type of results</li>
<li class = "li">When the file should be created</li>
<li class = "li">Nodes and elements for which the data should be generated</li>
</ul>
</li>
<li class = "li">A maximum of 20 columns can be defined in a table.</li>
<li class = "li">A total of maximum 200 columns can be defined.</li>
<li class = "li">One variable can be in several columns at the same time and different variables cannot exist in one column.</li>
<li class = "li">Columns not fully occupied and lying between the first column and the highest occupied column, are filled with zeros.</li>
<li class = "li">
When entering the file name, it is necessary to know that files can be deleted or saved in
subdirectories at the end of the optimization. This can be controlled using "wildcards."
Which files are to be moved or deleted can be set in the initialization file (see Bd.1,
Chapter 8.1.3). Using the system settings, all files that end in ".txt" are moved to the
directory <code class = "ph codeph">TOSCA_POST</code> after optimization has been completed.
</li>
</ol>
</div>


<div class = "section" id = "tso-r-cmd-userFile__tso-r-cmd-userFile-expl"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Examples</h2>

<p>uf_shape_onf</p>
<pre class = "codeblock">
<code class = "ph codeph">
USER_FILE
  ID_NAME     = uf_shape_onf
  FILE_NAME   = SHAPE
  FORMAT      = ONF
  EL_GROUP    = all_elements
  DATA_TYPE   = SHAPE_DATA
  WRITE       = EVER
END_
</code>
</pre>


<p>Example for a table output</p>
<pre class = "codeblock">
<code class = "ph codeph">
USER_FILE
  ID_NAME     = tab1
  FILE_NAME   = freq_tab.dat
  FILE_OPTION = ADD
  FORMAT      = ASCII
  WRITE       = EVER
  TYPE        = TABULAR
  SEPARATOR   = EXCLAM
  DATA_TAB    = ITERATION
  DATA_TAB    = freq_1
  DATA_TAB    = freq_2
  DATA_TAB    = freq_3
END_
</code>
</pre>
<p>uf_model_onf.mac</p>
<pre class = "codeblock">
<code class = "ph codeph">
USER_FILE
  ID_NAME     = UF_MODEL_ONF
  FILE_NAME   = MODEL_fem
  FILE_OPTION = FIX
  FORMAT      = ONF
  EL_GROUP    = all_elements
  TYPE        = FINITE_MODEL
  WRITE       = NOW
END_
</code>
</pre>
<p>Result transfer to CATIA RSO module (uf_shape_catia_rso.mac)</p>
<p>The results of the shape optimization can be transferred to the CAD model in
such a way that the results are used to deform/modify the geometry of the
CAD-based component. All modifications added by the optimization system
will be applied.</p>
<pre class = "codeblock">
<code class = "ph codeph">
USER_FILE
  ID_NAME     = UF_RSO
  FILE_NAME   = RSO_OUTPUT.TXT
  FILE_OPTION = VAR
  FORMAT      = ASCII
  ND_GROUP    = all_nodes
  TYPE        = CATIA_RSO
  WRITE       = EVER
  SEPARATOR   = TAB
  TITLE_1     = x(mm) # y(mm) # z(mm) # C1(mm) # C2(mm) # C3(mm)
END_
</code>
</pre>
</div>

</div>

<div class = "related-links"/>
</td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
