extern.html

有限元学习研究用源代码(老外的),供科研人员参考

<TITLE>IBG: External Parameter Input</TITLE>

<H1>External Parameter Input</H1>

<p>IBG is designed as a C-function package for usage in other
programs.  The user interface is not part of IBG. Nonetheless, for
some test examples, I have implemented a simple possibility to read
external control parameter from a file. You can use this
implementation (see the files <a href="../src/ibgextref.h"> ibgext.h
</a> <a href="../src/ibgext.c"> ibgextref.c</a>, <a
href="../examples/mainext.c"> mainext.c </a>) also as a pattern for
your own implementation.

<p>In this implementation, the initialization call

<pre>
ibgExtInit("test.ibg");
</pre>

reads the file <a href="../test/test.ibg"> test.ibg </a> containing
the parameters which may be controlled in this way. The file has to be
written in a simple C-style syntax.

 <P>Allowed is a simple assignment syntax for <A HREF="#scalar">scalar
parameters</A>, a call-like syntax for parameters with more than one
component, and <A HREF="#comments">comments</A>.

<h2><A NAME="scalar">Scalar Parameters</A></h2>

<p>There are scalar parameters which have to be defined by strings like

<pre>
name = value;
</pre>

 <P>Values are real or integer numbers.

<p>Scalar parameters are:

 <ul>
 <li><a href="coarse.html#regular"> regular </a>
 <li><a href="coarse.html#regularX"> regularX </a>
 <li><a href="coarse.html#regularY"> regularY </a>
 <li><a href="coarse.html#regularZ"> regularZ </a>
 <li><a href="refine.html#min"> min </a>
 <li><a href="refine.html#minX"> minX </a>
 <li><a href="refine.html#minY"> minY </a>
 <li><a href="refine.html#minZ"> minZ </a>
 <li><a href="refine.html#normalToFace"> normalToFace </a>
 <li><a href="refine.html#normalToLine"> normalToLine </a>
 <li><a href="refine.html#tangentialToFace"> tangentialToFace </a>
 <li><a href="refine.html#tangentialToLine"> tangentialToLine </a>
 </ul>
 
<h2><A NAME="nonscalar">Nonscalar Paramters</A></h2>

<p>Some other parameters have more than one component.  These
parameters have to be defined by strings like

<pre>
name(value1,value2,...,valueN);
<pre>

 <P>Values are real or integer numbers. They may be omitted, in this case
the are set to zero.

 <ul>
 <li><a href="coarse.html#x"> x </a>
 <li><a href="coarse.html#y"> y </a>
 <li><a href="coarse.html#z"> z </a>
 <li><a href="refine.html#refine">  refine </a>
 <li><a href="refine.html#refineX"> refineX </a>
 <li><a href="refine.html#refineY"> refineY </a>
 <li><a href="refine.html#refineZ"> refineZ </a>
 <li><a href="refine.html#refineU"> refineU </a>
 <li><a href="refine.html#refineV"> refineV </a>
 <li><a href="refine.html#refineW"> refineW </a>
 </ul>

<H2><A NAME="comment">Comments</A></H2>

 <P>It is allowed to include comments into the file. Comments start
with one of the follwing comment symbols:

 <P>
 <BR> <B>!</B>
 <BR> <B>?</B>
 <BR> <B>%</B>
 <BR> <B>#</B>
 <BR> <B>//</B>
 <BR> <B>--</B>

 <P>and end with the next line end.