zhangyiss/LaGriT
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a09a73537fe441c6f6807af05692b8e090c084d4
LaGriT/docs/_site/pages/mstkla/index.html

392 lines
18 KiB
HTML
Raw Normal View History

initial upload
2025-12-17 11:00:57 +08:00
<html lang="en-gb" dir="ltr">
<head>
<title>MSTKLA Online Manual</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="LaGriT : LaGriT is a library providing mesh generation and optimization for a variety of polyhedra and dimensions.">
<link href="https://fonts.googleapis.com/css?family=Do+Hyeon|Fira+Sans" rel="stylesheet">
<link rel="preload" href="https://getuikit.com/fonts/ProximaNova-Reg-webfont.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="preload" href="https://getuikit.com/fonts/ProximaNova-Light-webfont.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="stylesheet" href="/assets/css/uikit_theme.css">
<link rel="icon" type="image/x-icon" href="https://www.lanl.gov/favicon.ico">
<link rel="stylesheet" type="text/css" href="/assets/css/footer.css">
<!-- load stylesheets -->
<script type="text/javascript" async="" src="https://www.google-analytics.com/analytics.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.4/clipboard.min.js" defer=""></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/he/1.2.0/he.min.js" defer=""></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/marked/0.6.2/marked.min.js" defer=""></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue/2.6.10/vue.min.js" defer=""></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue-router/3.0.2/vue-router.min.js" defer=""></script>
<script src="https://getuikit.com/assets/uikit/dist/js/uikit.min.js?1180" defer=""></script>
<script src="https://getuikit.com/assets/uikit/dist/js/uikit-icons.min.js?1180" defer=""></script>
<script src="https://getuikit.com/assets/highlightjs/highlight.min.js" defer=""></script>
<script src="https://getuikit.com/app/main.min.js?1180" defer=""></script>
<script src="https://www.googletagmanager.com/gtag/js?id=UA-42150424-1" async=""></script>
<!-- tipuesearch files -->
<link rel="stylesheet" href="/assets/tipuesearch/css/normalize.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.1.1/jquery.min.js"></script>
<script src="/assets/tipuesearch/tipuesearch_content.js"></script>
<link rel="stylesheet" href="/assets/tipuesearch/css/tipuesearch.css">
<script src="/assets/tipuesearch/tipuesearch_set.js"></script>
<script src="/assets/tipuesearch/tipuesearch.min.js"></script>
<!-- Finally, load global style to overwrite template, tipuesearch, etc. -->
<!--<link rel="stylesheet" href="/assets/globalstyle.css">-->
</head>
<body>
<div>
<!-- Header -->
<div uk-sticky="media: 960" class="uk-navbar-container tm-navbar-container uk-sticky uk-sticky-fixed" style="position: fixed; top: 0px; width: 100%; color: #212328;">
<div class="uk-container uk-container-expand">
<nav class="uk-navbar">
<div class="uk-navbar-left">
<a href="/" class="uk-navbar-item uk-logo" style="font-family: 'Do Hyeon', sans-serif; color: white;">
<img uk-img src="/assets/img/logo.png" width="50" class="uk-margin-small-right" alt="LANL logo">
LaGriT
</a>
</div>
<div class="uk-navbar-right">
<ul class="uk-navbar-nav uk-visible@m">
<li><a href="/pages/commands">Commands</a></li>
<li><a href="/pages/tutorial/index">Tutorials</a></li>
<li><a href="/pages/release">Release Notes</a></li>
<li><a href="/pages/publications">Publications</a></li>
<li><a href="http://github.com/lanl/LaGriT"><span uk-icon="github"></span></a></li>
<!-- Begin search bar -->
<div class="nav-overlay uk-navbar-right">
<a class="uk-navbar-toggle" uk-search-icon uk-toggle="target: .nav-overlay; animation: uk-animation-fade" href="#"></a>
</div>
<div class="nav-overlay uk-navbar-left uk-flex-1" hidden>
<div class="uk-navbar-item uk-width-expand">
<form class="uk-search uk-search-navbar uk-width-1-1" action="https://lanl.github.io/LaGriT/search/">
<input class="uk-search-input" name="q" type="search" id="tipue_search_input" placeholder="Search..." autofocus>
</form>
</div>
<a class="uk-navbar-toggle" uk-close uk-toggle="target: .nav-overlay; animation: uk-animation-fade" href="#"></a>
</div>
<script>
$(document).ready(function() {
$('#tipue_search_input').tipuesearch({
'show': 10,
'newWindow' : true,
'showURL' : true,
'showTitleCount' : true,
'descriptiveWords' : 20,
'highlightTerms' : true,
'mode': 'static',
});
});
</script>
<!-- End search bar -->
</ul>
<a uk-navbar-toggle-icon="" href="#offcanvas" uk-toggle="" class="uk-navbar-toggle uk-hidden@m uk-icon uk-navbar-toggle-icon">
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg" data-svg="navbar-toggle-icon">
<rect y="9" width="20" height="2"></rect>
<rect y="3" width="20" height="2"></rect>
<rect y="15" width="20" height="2"></rect>
</svg>
</a>
</div>
</nav>
</div>
</div>
<div class="uk-sticky-placeholder" style="height: 80px; margin: 0px;"></div>
<!-- End Header -->
<!-- Main Body text -->
<div class="tm-main uk-section uk-section-default">
<div class="uk-container uk-container-small uk-position-relative">
<p><img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/construction24.gif" />“249”
“87”<img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/construc6.gif" />“248” “166”</p>
<hr />
<p><strong>MSTKLA - Mesh ToolKit interface to <a href="http://lagrit.lanl.gov">LAgrit</a></strong></p>
<p>(LA-UR-99-6711)</p>
<hr />
<p><strong>DIRECT LINKS</strong>
<img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/model.gif" />“142”
“24”](Geom.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/mesh.gif" />“143”
“26”](Mesh.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/utilities.gif" />“143”
“25”](utilities.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/attributes.gif" />“1”
“26”](MeshAttributes.md)
<img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/modelenty.gif" />“144”
“24”](GeomEntity.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/modelregn.gif" />“141”
“25”](GeomRegion.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/modelface.gif" />“143”
“26”](GeomFace.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/modeledge.gif" />“143”
“25”](GeomEdge.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/modelvert.gif" />“142”
“24”](GeomVertex.md)
<img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/genregn.gif" />“1”
“25”](GenRegion.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/meshregn.gif" />“143”
“25”](MeshRegion.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/meshface.gif" />“143”
“26”](MeshFace.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/meshedge.gif" />“143”
“25”](MeshEdge.md) <img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/meshvert.gif" />“143”
“25”](MeshVertex.md)
<img height="300" width="300" src="https://lanl.github.io/LaGriT/assets/images/trivia.gif" />“144” “25”](trivia.md)</p>
<hr />
<hr />
<p>Questions, Comments, Suggestions? Contact:</p>
<p>                Rao V Garimella,
PostDoc                                                                      
Tel: (505) 665-4636</p>
<p>                EES-5, MS D0                                       
‘</p>
<p>      ‘</p>
<p>                                   FAX: (505) 665-69</p>
<p>                Los Alamos National Lab                              ( 
)-(  )                                Email: &lt;rao@lanl.gov</p>
<p>                Los Alamos, NM 8</p>
<hr />
<p> </p>
<p><strong>MSTKLA</strong> is a C interface to the <strong>LaGriT</strong> code which is designed to
make it easier to use the LaGriT functionality. It tries to hide some of
the internals of LaGriT and provides an API that works in a somewhat
object oriented way. It does not attempt to provide or enhance
interactive commands that exist in LaGriT. Rather, it is designed more
with writing automated mesh generation procedures and complex meshing
algorithms within LaGriT in mind.</p>
<p>MSTKLA has one or more <em>mesh objects</em>, which have mesh <strong><em>regions</em></strong>,
mesh <strong><em>faces,</em></strong> mesh <strong><em>edges</em></strong> and mesh <strong><em>vertices</em></strong> (nodes).
<em>Mesh faces and mesh edges are objects defined on the fly in terms of
their vertices.</em> One can ask these objects various questions or modify
their info through operators. In addition there is a <strong><em>geometric
model</em></strong> and <strong><em>geometric model objects</em></strong> (In the spirit of consistent
naming, I am labeling this set of functions <strong>GMTKLA</strong>). Since LaGriT
does not really store curves or points in the database, these are also
faked on the fly.</p>
<p>The mesh and model entities are related through the concept of
<strong><em>CLASSIFICATION</em></strong>.</p>
<p><strong><em>“A mesh entity is classified on a model entity if it forms all or
part of that model entity’s discretization (grid) but not its
boundary’s”.</em></strong></p>
<p>So mesh regions can be classified only on a model region.  Mesh faces
can be classified on a model face or a model region. Mesh vertices can
be classified on a model vertex, model edge, model face or model region.</p>
<p>Classification information can be queried from MSTKLA if it is
available. In particular, in LaGriT, only <strong><em>external faces</em></strong> (what
LaGriT calls <strong><em>“reflective” boundaries</em></strong>) and <strong><em>internal faces or
interfaces</em></strong> created with the option <strong><em>“intrcons”</em></strong> in the
<strong><em><a href="http://www.t12.lanl.gov/~lagrit/SURFACE.md">surface</a></em></strong>
command have the information required to retrieve full classification
information. Full classification information includes the <strong><em>type</em></strong> of
geometric model entity the mesh entity is classified on, the <strong><em>ID of
that geometric model entity</em></strong> and <strong><em>a pointer to the geometric model
object</em></strong> (which can be further queried). Interface surfaces created
with the surface command option “<strong><em>intrface</em></strong>” <strong>do not</strong> have the
necessary information to relate the mesh and the model fully. (In the
future, I may put in code to take the “intrface” type surfaces and add
the info needed to find out the classification information).</p>
<p>Note that the current interface works for querying an existing mesh but
not <strong>yet</strong> for modifying it. The operators for this are on the way.
Operators for calling the actual meshing operators (connect, refine,
smooth, etc) will also be added in the near future.</p>
<p>Finally, the basic interface (low level query and modification
operators) are expected to retain the same format regardless of what the
underlying database is (LaGriT or something else). So, for example, I am
hoping that an operator to retrieve the nodes of an element will retain
the same form shown below regardless of how it functions internally:</p>
<p><em>void</em> <strong>MR_Vertices</strong>(<em>PMeshObj</em> mesh, <em>PMeshRegn</em> reg, *int
**nv,
*PMeshVert
**rverts);</p>
<p>I will try hard to maintain this API constant but cannot absolutely
guarantee it.</p>
<p> 
[]{#parent-childAlso see <strong><a href="http://www.ees.lanl.gov/staff/rao/mstkla/parent-child.md">Parent-Child Node (Vertex)
Issues</a></strong></p>
<hr />
<hr />
<p>[]{#typedefs<a href="http://www.ees.lanl.gov/staff/rao/mstkla/prelim.md">TYPEDEFS</a> </p>
<hr />
<hr />
<p>[]{#MSTKLA_Init<strong>MSTKLA Interface Operators</strong></p>
<hr />
<hr />
<p><strong>MESH INITIALIZATION:</strong></p>
<p> </p>
<p><em>void</em> <strong>MSTKLA_Init</strong>(<em>void</em>);</p>
<p>Initialize the mesh toolkit.</p>
<hr />
<p><strong>MESH OPERATORS:</strong></p>
<p> </p>
<p> []{#MESH OBJECT:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/Mesh.md">MESH
OBJECT:</a></p>
<p> []{#MESH REGION:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/MeshRegion.md">MESH
REGION:</a></p>
<p> []{#MESH FACE:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/MeshFace.md">MESH
FACE:</a></p>
<p> []{#MESH EDGE:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/MeshEdge.md">MESH
EDGE:</a></p>
<p> []{#MESH VERTEX:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/MeshVertex.md">MESH
VERTEX:</a></p>
<p> </p>
<p> []{#GENERIC MESH REGION QUERIES:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GenRegion.md">GENERIC MESH REGION
QUERIES:</a></p>
<hr />
<hr />
<p>[]{#GMTKLA_Init<strong>GEOMETRIC MODEL INITIALIZATION:</strong></p>
<p><em>void</em> <strong>GMTKLA_Init</strong>(<em>void</em>);</p>
<p>Initialize the geometric model interface.</p>
<hr />
<p><strong>MODEL OPERATORS:</strong></p>
<p> []{#GEOMETRIC MODEL:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/Geom.md">GEOMETRIC
MODEL:</a></p>
<p> []{#MODEL ENTITY:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GeomEntity.md">MODEL
ENTITY:</a></p>
<p> []{#MODEL REGION:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GeomRegion.md">MODEL
REGION:</a></p>
<p> []{#MODEL FACE:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GeomFace.md">MODEL
FACE:</a></p>
<p> []{#MODEL EDGE:<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GeomEdge.md">MODEL
EDGE:</a></p>
<p> []{#MODEL VERTEX<a href="http://www.ees.lanl.gov/staff/rao/mstkla/GeomVertex.md">MODEL
VERTEX</a>
—&gt; Not implemented fully</p>
<p> </p>
<hr />
<hr />
<p>[]{#UTILITIES:<strong><a href="http://www.ees.lanl.gov/staff/rao/mstkla/utilities.md">UTILITIES:</a></strong></p>
<hr />
<hr />
<p>[]{#EXAMPLE<strong><a href="http://www.ees.lanl.gov/staff/rao/mstkla/example.md">EXAMPLE OF PROGRAMMING WITH
MSTKLA</a></strong></p>
<p> </p>
<hr />
<hr />
<p>[]{#EXECUTABLE<strong><a href="http://www.ees.lanl.gov/staff/rao/mstkla/linking.md">LIBRARIES, INCLUDE FILES AND CREATING AN
EXECUTABLE</a></strong></p>
</div>
</div>
<!-- Begin footer -->
<footer class="footer-distributed">
<div class="footer-right">
<div><img src="/assets/img/lanl_logo_white.png" height="80"></div>
</div>
<div class="footer-left lg-background-color">
<p class="footer-links" style="font-family: 'Fira Sans', sans-serif; color: white;">
<a href="/">Home</a>
·
<a href="/pylagrit/original/index.html">PyLaGriT</a>
·
<a href="https://int.lanl.gov/org/ddste/aldcels/ees/index.shtml">EES-16</a>
·
<a href="/pages/licensing.html">License</a>
·
<a href="https://lagrit.lanl.gov/">Contact</a>
</p>
<p>&copy; 2019 Los Alamos National Laboratory</p>
<p>EES-16 | Computational Earth Science</p>
<p>LA-CC-15-069</p>
</div>
</footer>
<!-- Begin Navigation Bar -->
<div id="offcanvas" uk-offcanvas="mode: push; overlay: true" class="uk-offcanvas">
<div class="uk-offcanvas-bar">
<div class="uk-panel">
<ul class="uk-nav uk-nav-default tm-nav">
<form class="uk-search uk-search-default" action="https://lanl.github.io/LaGriT/search/">
<a href="" uk-search-icon></a>
<input class="uk-search-input" type="search" placeholder="" name="q" id="tipue_search_input_mobile">
</form>
<li class="uk-nav-header">General</li>
<li><a href="/">Home</a></li>
<li><a href="/pages/commands">Commands</a></li>
<li><a href="/pages/release">Release Notes</a></li>
<li><a href="/pages/publications">Publications</a></li>
<li><a href="http://github.com/lanl/LaGriT">GitHub</a></li>
</ul>
</div>
</div>
</div>
<!-- End Navigation Bar -->
</div>
</body>
</html>
Reference in New Issue Copy Permalink