<!DOCTYPE html><html lang="en"><head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="shortcut icon" href="/img/favicon.ico">
<meta name="keywords" content="Finite Element Library,Finite Element Code,Finite Element Method Library,Finite Element Method Code,Finite Element C++,Finite Element Method C++,Finite Element Library C++,Finite Element Code C++,FEM Code,FEM Library,FEM C++">
<meta name="google-site-verification" content="45K56TawSdzbgy-uDtfJdYwp7zaVdL3fIAGYt869wwU">
<!-- <title></title> -->
<title>MFEM - Finite Element Discretization Library</title>
<link href="../../doc/web/bootstrap-mfem.min.css" rel="stylesheet">
<link href="../../doc/web/font-awesome-4.0.3.css" rel="stylesheet">
<link href="../../doc/web/highlight.css" rel="stylesheet">
<link href="../../doc/web/base.css" rel="stylesheet">
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
<![endif]-->
<style type="text/css">.MathJax_Hover_Frame {border-radius: .25em; -webkit-border-radius: .25em; -moz-border-radius: .25em; -khtml-border-radius: .25em; box-shadow: 0px 0px 15px #83A; -webkit-box-shadow: 0px 0px 15px #83A; -moz-box-shadow: 0px 0px 15px #83A; -khtml-box-shadow: 0px 0px 15px #83A; border: 1px solid #A6D ! important; display: inline-block; position: absolute}
.MathJax_Menu_Button .MathJax_Hover_Arrow {position: absolute; cursor: pointer; display: inline-block; border: 2px solid #AAA; border-radius: 4px; -webkit-border-radius: 4px; -moz-border-radius: 4px; -khtml-border-radius: 4px; font-family: 'Courier New',Courier; font-size: 9px; color: #F0F0F0}
.MathJax_Menu_Button .MathJax_Hover_Arrow span {display: block; background-color: #AAA; border: 1px solid; border-radius: 3px; line-height: 0; padding: 4px}
.MathJax_Hover_Arrow:hover {color: white!important; border: 2px solid #CCC!important}
.MathJax_Hover_Arrow:hover span {background-color: #CCC!important}
</style><style type="text/css">#MathJax_About {position: fixed; left: 50%; width: auto; text-align: center; border: 3px outset; padding: 1em 2em; background-color: #DDDDDD; color: black; cursor: default; font-family: message-box; font-size: 120%; font-style: normal; text-indent: 0; text-transform: none; line-height: normal; letter-spacing: normal; word-spacing: normal; word-wrap: normal; white-space: nowrap; float: none; z-index: 201; border-radius: 15px; -webkit-border-radius: 15px; -moz-border-radius: 15px; -khtml-border-radius: 15px; box-shadow: 0px 10px 20px #808080; -webkit-box-shadow: 0px 10px 20px #808080; -moz-box-shadow: 0px 10px 20px #808080; -khtml-box-shadow: 0px 10px 20px #808080; filter: progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}
#MathJax_About.MathJax_MousePost {outline: none}
.MathJax_Menu {position: absolute; background-color: white; color: black; width: auto; padding: 5px 0px; border: 1px solid #CCCCCC; margin: 0; cursor: default; font: menu; text-align: left; text-indent: 0; text-transform: none; line-height: normal; letter-spacing: normal; word-spacing: normal; word-wrap: normal; white-space: nowrap; float: none; z-index: 201; border-radius: 5px; -webkit-border-radius: 5px; -moz-border-radius: 5px; -khtml-border-radius: 5px; box-shadow: 0px 10px 20px #808080; -webkit-box-shadow: 0px 10px 20px #808080; -moz-box-shadow: 0px 10px 20px #808080; -khtml-box-shadow: 0px 10px 20px #808080; filter: progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}
.MathJax_MenuItem {padding: 1px 2em; background: transparent}
.MathJax_MenuArrow {position: absolute; right: .5em; padding-top: .25em; color: #666666; font-size: .75em}
.MathJax_MenuActive .MathJax_MenuArrow {color: white}
.MathJax_MenuArrow.RTL {left: .5em; right: auto}
.MathJax_MenuCheck {position: absolute; left: .7em}
.MathJax_MenuCheck.RTL {right: .7em; left: auto}
.MathJax_MenuRadioCheck {position: absolute; left: .7em}
.MathJax_MenuRadioCheck.RTL {right: .7em; left: auto}
.MathJax_MenuLabel {padding: 1px 2em 3px 1.33em; font-style: italic}
.MathJax_MenuRule {border-top: 1px solid #DDDDDD; margin: 4px 3px}
.MathJax_MenuDisabled {color: GrayText}
.MathJax_MenuActive {background-color: #606872; color: white}
.MathJax_MenuDisabled:focus, .MathJax_MenuLabel:focus {background-color: #E8E8E8}
.MathJax_ContextMenu:focus {outline: none}
.MathJax_ContextMenu .MathJax_MenuItem:focus {outline: none}
#MathJax_AboutClose {top: .2em; right: .2em}
.MathJax_Menu .MathJax_MenuClose {top: -10px; left: -10px}
.MathJax_MenuClose {position: absolute; cursor: pointer; display: inline-block; border: 2px solid #AAA; border-radius: 18px; -webkit-border-radius: 18px; -moz-border-radius: 18px; -khtml-border-radius: 18px; font-family: 'Courier New',Courier; font-size: 24px; color: #F0F0F0}
.MathJax_MenuClose span {display: block; background-color: #AAA; border: 1.5px solid; border-radius: 18px; -webkit-border-radius: 18px; -moz-border-radius: 18px; -khtml-border-radius: 18px; line-height: 0; padding: 8px 0 6px}
.MathJax_MenuClose:hover {color: white!important; border: 2px solid #CCC!important}
.MathJax_MenuClose:hover span {background-color: #CCC!important}
.MathJax_MenuClose:hover:focus {outline: none}
</style><style type="text/css">.MathJax_Preview .MJXf-math {color: inherit!important}
</style><style type="text/css">.MJX_Assistive_MathML {position: absolute!important; top: 0; left: 0; clip: rect(1px, 1px, 1px, 1px); padding: 1px 0 0 0!important; border: 0!important; height: 1px!important; width: 1px!important; overflow: hidden!important; display: block!important; -webkit-touch-callout: none; -webkit-user-select: none; -khtml-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none}
.MJX_Assistive_MathML.MJX_Assistive_MathML_Block {width: 100%!important}
</style><style type="text/css">#MathJax_Zoom {position: absolute; background-color: #F0F0F0; overflow: auto; display: block; z-index: 301; padding: .5em; border: 1px solid black; margin: 0; font-weight: normal; font-style: normal; text-align: left; text-indent: 0; text-transform: none; line-height: normal; letter-spacing: normal; word-spacing: normal; word-wrap: normal; white-space: nowrap; float: none; -webkit-box-sizing: content-box; -moz-box-sizing: content-box; box-sizing: content-box; box-shadow: 5px 5px 15px #AAAAAA; -webkit-box-shadow: 5px 5px 15px #AAAAAA; -moz-box-shadow: 5px 5px 15px #AAAAAA; -khtml-box-shadow: 5px 5px 15px #AAAAAA; filter: progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}
#MathJax_ZoomOverlay {position: absolute; left: 0; top: 0; z-index: 300; display: inline-block; width: 100%; height: 100%; border: 0; padding: 0; margin: 0; background-color: white; opacity: 0; filter: alpha(opacity=0)}
#MathJax_ZoomFrame {position: relative; display: inline-block; height: 0; width: 0}
#MathJax_ZoomEventTrap {position: absolute; left: 0; top: 0; z-index: 302; display: inline-block; border: 0; padding: 0; margin: 0; background-color: white; opacity: 0; filter: alpha(opacity=0)}
</style><style type="text/css">.MathJax_Preview {color: #888}
#MathJax_Message {position: fixed; left: 1px; bottom: 2px; background-color: #E6E6E6; border: 1px solid #959595; margin: 0px; padding: 2px 8px; z-index: 102; color: black; font-size: 80%; width: auto; white-space: nowrap}
#MathJax_MSIE_Frame {position: absolute; top: 0; left: 0; width: 0px; z-index: 101; border: 0px; margin: 0px; padding: 0px}
.MathJax_Error {color: #CC0000; font-style: italic}
</style><style type="text/css">.MJXp-script {font-size: .8em}
.MJXp-right {-webkit-transform-origin: right; -moz-transform-origin: right; -ms-transform-origin: right; -o-transform-origin: right; transform-origin: right}
.MJXp-bold {font-weight: bold}
.MJXp-italic {font-style: italic}
.MJXp-scr {font-family: MathJax_Script,'Times New Roman',Times,STIXGeneral,serif}
.MJXp-frak {font-family: MathJax_Fraktur,'Times New Roman',Times,STIXGeneral,serif}
.MJXp-sf {font-family: MathJax_SansSerif,'Times New Roman',Times,STIXGeneral,serif}
.MJXp-cal {font-family: MathJax_Caligraphic,'Times New Roman',Times,STIXGeneral,serif}
.MJXp-mono {font-family: MathJax_Typewriter,'Times New Roman',Times,STIXGeneral,serif}
.MJXp-largeop {font-size: 150%}
.MJXp-largeop.MJXp-int {vertical-align: -.2em}
.MJXp-math {display: inline-block; line-height: 1.2; text-indent: 0; font-family: 'Times New Roman',Times,STIXGeneral,serif; white-space: nowrap; border-collapse: collapse}
.MJXp-display {display: block; text-align: center; margin: 1em 0}
.MJXp-math span {display: inline-block}
.MJXp-box {display: block!important; text-align: center}
.MJXp-box:after {content: " "}
.MJXp-rule {display: block!important; margin-top: .1em}
.MJXp-char {display: block!important}
.MJXp-mo {margin: 0 .15em}
.MJXp-mfrac {margin: 0 .125em; vertical-align: .25em}
.MJXp-denom {display: inline-table!important; width: 100%}
.MJXp-denom > * {display: table-row!important}
.MJXp-surd {vertical-align: top}
.MJXp-surd > * {display: block!important}
.MJXp-script-box > * {display: table!important; height: 50%}
.MJXp-script-box > * > * {display: table-cell!important; vertical-align: top}
.MJXp-script-box > *:last-child > * {vertical-align: bottom}
.MJXp-script-box > * > * > * {display: block!important}
.MJXp-mphantom {visibility: hidden}
.MJXp-munderover {display: inline-table!important}
.MJXp-over {display: inline-block!important; text-align: center}
.MJXp-over > * {display: block!important}
.MJXp-munderover > * {display: table-row!important}
.MJXp-mtable {vertical-align: .25em; margin: 0 .125em}
.MJXp-mtable > * {display: inline-table!important; vertical-align: middle}
.MJXp-mtr {display: table-row!important}
.MJXp-mtd {display: table-cell!important; text-align: center; padding: .5em 0 0 .5em}
.MJXp-mtr > .MJXp-mtd:first-child {padding-left: 0}
.MJXp-mtr:first-child > .MJXp-mtd {padding-top: 0}
.MJXp-mlabeledtr {display: table-row!important}
.MJXp-mlabeledtr > .MJXp-mtd:first-child {padding-left: 0}
.MJXp-mlabeledtr:first-child > .MJXp-mtd {padding-top: 0}
.MJXp-merror {background-color: #FFFF88; color: #CC0000; border: 1px solid #CC0000; padding: 1px 3px; font-style: normal; font-size: 90%}
.MJXp-scale0 {-webkit-transform: scaleX(.0); -moz-transform: scaleX(.0); -ms-transform: scaleX(.0); -o-transform: scaleX(.0); transform: scaleX(.0)}
.MJXp-scale1 {-webkit-transform: scaleX(.1); -moz-transform: scaleX(.1); -ms-transform: scaleX(.1); -o-transform: scaleX(.1); transform: scaleX(.1)}
.MJXp-scale2 {-webkit-transform: scaleX(.2); -moz-transform: scaleX(.2); -ms-transform: scaleX(.2); -o-transform: scaleX(.2); transform: scaleX(.2)}
.MJXp-scale3 {-webkit-transform: scaleX(.3); -moz-transform: scaleX(.3); -ms-transform: scaleX(.3); -o-transform: scaleX(.3); transform: scaleX(.3)}
.MJXp-scale4 {-webkit-transform: scaleX(.4); -moz-transform: scaleX(.4); -ms-transform: scaleX(.4); -o-transform: scaleX(.4); transform: scaleX(.4)}
.MJXp-scale5 {-webkit-transform: scaleX(.5); -moz-transform: scaleX(.5); -ms-transform: scaleX(.5); -o-transform: scaleX(.5); transform: scaleX(.5)}
.MJXp-scale6 {-webkit-transform: scaleX(.6); -moz-transform: scaleX(.6); -ms-transform: scaleX(.6); -o-transform: scaleX(.6); transform: scaleX(.6)}
.MJXp-scale7 {-webkit-transform: scaleX(.7); -moz-transform: scaleX(.7); -ms-transform: scaleX(.7); -o-transform: scaleX(.7); transform: scaleX(.7)}
.MJXp-scale8 {-webkit-transform: scaleX(.8); -moz-transform: scaleX(.8); -ms-transform: scaleX(.8); -o-transform: scaleX(.8); transform: scaleX(.8)}
.MJXp-scale9 {-webkit-transform: scaleX(.9); -moz-transform: scaleX(.9); -ms-transform: scaleX(.9); -o-transform: scaleX(.9); transform: scaleX(.9)}
.MathJax_PHTML .noError {vertical-align: ; font-size: 90%; text-align: left; color: black; padding: 1px 3px; border: 1px solid}
</style><style type="text/css">.MathJax_SVG_Display {text-align: center; margin: 1em 0em; position: relative; display: block!important; text-indent: 0; max-width: none; max-height: none; min-width: 0; min-height: 0; width: 100%}
.MathJax_SVG .MJX-monospace {font-family: monospace}
.MathJax_SVG .MJX-sans-serif {font-family: sans-serif}
#MathJax_SVG_Tooltip {background-color: InfoBackground; color: InfoText; border: 1px solid black; box-shadow: 2px 2px 5px #AAAAAA; -webkit-box-shadow: 2px 2px 5px #AAAAAA; -moz-box-shadow: 2px 2px 5px #AAAAAA; -khtml-box-shadow: 2px 2px 5px #AAAAAA; padding: 3px 4px; z-index: 401; position: absolute; left: 0; top: 0; width: auto; height: auto; display: none}
.MathJax_SVG {display: inline; font-style: normal; font-weight: normal; line-height: normal; font-size: 100%; font-size-adjust: none; text-indent: 0; text-align: left; text-transform: none; letter-spacing: normal; word-spacing: normal; word-wrap: normal; white-space: nowrap; float: none; direction: ltr; max-width: none; max-height: none; min-width: 0; min-height: 0; border: 0; padding: 0; margin: 0}
.MathJax_SVG * {transition: none; -webkit-transition: none; -moz-transition: none; -ms-transition: none; -o-transition: none}
.mjx-svg-href {fill: blue; stroke: blue}
.MathJax_SVG_Processing {visibility: hidden; position: absolute; top: 0; left: 0; width: 0; height: 0; overflow: hidden; display: block!important}
.MathJax_SVG_Processed {display: none!important}
.MathJax_SVG_ExBox {display: block!important; overflow: hidden; width: 1px; height: 60ex; min-height: 0; max-height: none; padding: 0; border: 0; margin: 0}
.MathJax_SVG_LineBox {display: table!important}
.MathJax_SVG_LineBox span {display: table-cell!important; width: 10000em!important; min-width: 0; max-width: none; padding: 0; border: 0; margin: 0}
.MathJax_SVG .noError {vertical-align: ; font-size: 90%; text-align: left; color: black; padding: 1px 3px; border: 1px solid}
</style></head>
<body style=""><div style="visibility: hidden; overflow: hidden; position: absolute; top: 0px; height: 1px; width: auto; padding: 0px; border: 0px; margin: 0px; text-align: left; text-indent: 0px; text-transform: none; line-height: normal; letter-spacing: normal; word-spacing: normal;"><div id="MathJax_SVG_Hidden"></div><svg><defs id="MathJax_SVG_glyphs"><path stroke-width="1" id="MJMATHI-4C" d="M228 637Q194 637 192 641Q191 643 191 649Q191 673 202 682Q204 683 217 683Q271 680 344 680Q485 680 506 683H518Q524 677 524 674T522 656Q517 641 513 637H475Q406 636 394 628Q387 624 380 600T313 336Q297 271 279 198T252 88L243 52Q243 48 252 48T311 46H328Q360 46 379 47T428 54T478 72T522 106T564 161Q580 191 594 228T611 270Q616 273 628 273H641Q647 264 647 262T627 203T583 83T557 9Q555 4 553 3T537 0T494 -1Q483 -1 418 -1T294 0H116Q32 0 32 10Q32 17 34 24Q39 43 44 45Q48 46 59 46H65Q92 46 125 49Q139 52 144 61Q147 65 216 339T285 628Q285 635 228 637Z"></path><path stroke-width="1" id="MJMAIN-32" d="M109 429Q82 429 66 447T50 491Q50 562 103 614T235 666Q326 666 387 610T449 465Q449 422 429 383T381 315T301 241Q265 210 201 149L142 93L218 92Q375 92 385 97Q392 99 409 186V189H449V186Q448 183 436 95T421 3V0H50V19V31Q50 38 56 46T86 81Q115 113 136 137Q145 147 170 174T204 211T233 244T261 278T284 308T305 340T320 369T333 401T340 431T343 464Q343 527 309 573T212 619Q179 619 154 602T119 569T109 550Q109 549 114 549Q132 549 151 535T170 489Q170 464 154 447T109 429Z"></path></defs></svg></div><div id="MathJax_Message" style="display: none;"></div>
<div class="navbar navbar-default navbar-fixed-top" role="navigation">
<div class="container">
<!-- Collapsed navigation -->
<div class="navbar-header">
<!-- Expander button -->
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<!-- Main title -->
<a class="navbar-brand" href="http://mfem.org">MFEM</a>
</div>
<!-- Expanded navigation -->
<div class="navbar-collapse collapse">
<!-- Main navigation -->
<ul class="nav navbar-nav">
<li>
<!-- Replace "nav_item.url|url" with "nav_item.url" for older mkdocs (before 1.0) -->
<a href="http://mfem.org/features/">Features</a>
</li>
<li>
<!-- Replace "nav_item.url|url" with "nav_item.url" for older mkdocs (before 1.0) -->
<a href="http://mfem.org/examples/">Examples</a>
</li>
<li class="dropdown active">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a>
<ul class="dropdown-menu">
<li>
<a href="http://mfem.org/building/">Building MFEM</a>
</li>
<li>
<a href="http://mfem.org/serial-tutorial/">Serial Tutorial</a>
</li>
<li>
<a href="http://mfem.org/parallel-tutorial/">Parallel Tutorial</a>
</li>
<li>
<a href="http://mfem.org/fem/">Finite Elements</a>
</li>
<li>
<a href="http://mfem.org/electromagnetics/">Electromagnetics</a>
</li>
<li>
<a href="http://mfem.org/meshing/">Meshing</a>
</li>
<li>
<a href="http://mfem.org/performance/">Performance</a>
</li>
<li class="active">
<a href="./">Tools</a>
</li>
<li>
<a href="http://mfem.org/toys/">Toys</a>
</li>
<li>
<a href="http://mfem.org/publications/">Publications</a>
</li>
<li>
<a href="http://mfem.org/about/">About</a>
</li>
</ul>
</li>
<li>
<!-- Replace "nav_item.url|url" with "nav_item.url" for older mkdocs (before 1.0) -->
<a href="http://mfem.org/gallery/">Gallery</a>
</li>
<li>
<!-- Replace "nav_item.url|url" with "nav_item.url" for older mkdocs (before 1.0) -->
<a href="http://mfem.org/download/">Download</a>
</li>
</ul>
<!-- Search, Navigation and Repo links -->
<ul class="nav navbar-nav navbar-right">
<li>
<a href="https://github.com/mfem/mfem/">
<i class="fa fa-github-square"></i>
GitHub
</a>
</li>
</ul>
</div>
</div>
</div>
<div class="container">
<div class="col-md-3 visible-xs visible-sm"><div class="bs-sidebar hidden-print affix well" role="complementary">
<ul class="nav bs-sidenav">
<li class="main active"><a href="#tools">Tools</a></li>
<li><a href="#general-tools">General Tools</a></li>
<li><a href="#datacollection-tools">DataCollection Tools</a></li>
</ul>
</div></div> <!-- toc on top on mobile -->
<div class="col-md-9" role="main">
<h1 id="tools">Tools</h1>
<h2 id="general-tools">General Tools</h2>
<h3 id="display-basis">Display Basis</h3>
<p>The <code>display-basis</code> miniapp, found under <code>miniapps/tools</code>, visualizes various
types of finite element basis functions on a single mesh element in 1D, 2D,
and 3D.</p>
<p><img alt="" src="../../doc/web/examples/display-basis.png"></p>
<p>The element type, basis type and order can be changed interactively. The mesh
element is either the reference element, or a simple transformation of it.</p>
<h3 id="low-order-refined-transfer">Low-Order Refined Transfer</h3>
<p>The <code>lor-transfer</code> miniapp, found under <code>miniapps/tools</code> demonstrates the
capability to generate a <em>low-order refined</em> mesh from a high-order mesh, and to
transfer solutions between these meshes.</p>
<p><img alt="" src="../../doc/web/examples/lor-transfer.png"></p>
<p>Grid functions can be transferred between the coarse, high-order mesh and the
low-order refined mesh using either <span class="MathJax_Preview" style="color: inherit; display: none;"></span><span class="MathJax_SVG" id="MathJax-Element-1-Frame" tabindex="0" data-mathml="<math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>L</mi><mn>2</mn></msup></math>" role="presentation" style="font-size: 100%; display: inline-block; position: relative;"><svg xmlns:xlink="http://www.w3.org/1999/xlink" width="2.637ex" height="2.378ex" viewBox="0 -908.4 1135.4 1023.7" role="img" focusable="false" aria-hidden="true" style="vertical-align: -0.268ex;"><g stroke="currentColor" fill="currentColor" stroke-width="0" transform="matrix(1 0 0 -1 0 0)"><use xlink:href="#MJMATHI-4C" x="0" y="0"></use><use transform="scale(0.707)" xlink:href="#MJMAIN-32" x="963" y="513"></use></g></svg><span class="MJX_Assistive_MathML" role="presentation"><math xmlns="http://www.w3.org/1998/Math/MathML"><msup><mi>L</mi><mn>2</mn></msup></math></span></span><script type="math/tex" id="MathJax-Element-1">L^2</script> projection or pointwise evaluation.
These transfer operators can be designed to discretely conserve mass and to
recover the original high-order solution when transferring a low-order grid
function that was obtained by restricting a high-order grid function to the
low-order refined space.</p>
<h2 id="datacollection-tools">DataCollection Tools</h2>
<h3 id="convert-dc">Convert DC</h3>
<p>This tool, named <code>convert-dc</code> in the <code>miniapps/tools</code> subdirectory,
demonstrates how to convert between MFEM's different concrete
DataCollection options.</p>
<p>Currently supported data collection type options:</p>
<table class="table table-striped table-hover">
<thead>
<tr>
<th>Nickname</th>
<th align="left">Full Class Name</th>
</tr>
</thead>
<tbody>
<tr>
<td>visit</td>
<td align="left">VisItDataCollection (default)</td>
</tr>
<tr>
<td>sidre or sidre_hdf5</td>
<td align="left">SidreDataCollection</td>
</tr>
<tr>
<td>json</td>
<td align="left">ConduitDataCollection w/ protocol json</td>
</tr>
<tr>
<td>conduit_json</td>
<td align="left">ConduitDataCollection w/ protocol conduit_json</td>
</tr>
<tr>
<td>conduit_bin</td>
<td align="left">ConduitDataCollection w/ protocol conduit_bin</td>
</tr>
<tr>
<td>hdf5</td>
<td align="left">ConduitDataCollection w/ protocol hdf5</td>
</tr>
</tbody>
</table>
<h3 id="load-dc">Load DC</h3>
<p>The <code>load-dc</code> miniapp, found in the <code>miniapps/tools</code> subdirectory, loads and
visualizes (in GLVis) previously saved data using DataCollection sub-classes,
see e.g. Example 5/5p.
<img alt="" src="../../doc/web/examples/load-dc.png">
Currently, only the VisItDataCollection class is supported.</p>
<h3 id="get-values">Get Values</h3>
<p>The <code>get-values</code> miniapp, found in <code>miniapps/tools</code>, loads previously saved
data using DataCollection sub-classes and outputs field values at a set of
points. Currently, only the VisItDataCollection class is supported.</p>
<pre><code class="hljs objectivec"><span class="hljs-preprocessor"># Number of fields</span>
<span class="hljs-number">3</span>
<span class="hljs-preprocessor"># Legend</span>
<span class="hljs-preprocessor"># <span class="hljs-title">"Index"</span> <span class="hljs-title">"Location"</span>:2 <span class="hljs-title">"pressure"</span>:1 <span class="hljs-title">"velocity"</span>:2</span>
<span class="hljs-number">2</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>
<span class="hljs-preprocessor"># Number of points</span>
<span class="hljs-number">6</span>
<span class="hljs-number">0</span> <span class="hljs-number">0.0</span> <span class="hljs-number">0.8</span> <span class="hljs-number">0.717336</span> -<span class="hljs-number">0.716172</span> -<span class="hljs-number">0.696674</span>
<span class="hljs-number">1</span> <span class="hljs-number">0.2</span> <span class="hljs-number">0.8</span> <span class="hljs-number">0.876045</span> -<span class="hljs-number">0.875874</span> -<span class="hljs-number">0.852278</span>
<span class="hljs-number">2</span> <span class="hljs-number">0.4</span> <span class="hljs-number">0.8</span> <span class="hljs-number">1.06999</span> -<span class="hljs-number">1.07106</span> -<span class="hljs-number">1.03923</span>
<span class="hljs-number">3</span> <span class="hljs-number">0.6</span> <span class="hljs-number">0.8</span> <span class="hljs-number">1.30719</span> -<span class="hljs-number">1.30931</span> -<span class="hljs-number">1.26903</span>
<span class="hljs-number">4</span> <span class="hljs-number">0.8</span> <span class="hljs-number">0.8</span> <span class="hljs-number">1.59678</span> -<span class="hljs-number">1.59601</span> -<span class="hljs-number">1.54949</span>
<span class="hljs-number">5</span> <span class="hljs-number">1.0</span> <span class="hljs-number">0.8</span> <span class="hljs-number">1.94995</span> -<span class="hljs-number">1.94853</span> -<span class="hljs-number">1.89371</span>
</code></pre>
<p>Point locations can be specified on the command line using <code>-p</code> or within a
data file whose name can be given with option <code>-pf</code>. The data file format is:</p>
<pre><code class="hljs erlang">number_of_points space_dimension
x_0 y_0 ...
x_1 y_1 ...
etc.
</code></pre>
<p>By default all available fields are evaluated. The list of fields can be
reduced by specifying the desired field names with <code>-fn</code>. The <code>-fn</code> option
takes a space separated list of field names surrounded by quotes. Field
names containing spaces, such as "Field 1" and "Field 2", can be entered as:</p>
<p><code>get-values -fn "Field\ 1 Field\ 2"</code></p>
<p>By default the data is written to standard out. This can be overwritten
with the <code>-o [filename]</code> option.</p>
<p>The output format contains comments as well as sizing information to aid in
subsequent processing. The bulk of the data consists of one line per point
with a 0-based integer index followed by the point coordinates and then the
field data. A legend, appearing before the bulk data, shows the order of
the fields along with the number of values per field (for vector data).</p>
<script type="text/x-mathjax-config;executed=true">MathJax.Hub.Config({TeX: {equationNumbers: {autoNumber: "all"}}, tex2jax: {inlineMath: [['$','$']]}});</script>
<script type="text/javascript" src=""></script></div>
<div class="col-md-3 hidden-xs hidden-sm"><div class="bs-sidebar hidden-print affix well" role="complementary">
<ul class="nav bs-sidenav">
<li class="main active"><a href="#tools">Tools</a></li>
<li><a href="#general-tools">General Tools</a></li>
<li><a href="#datacollection-tools">DataCollection Tools</a></li>
</ul>
</div></div>
</div>
<footer class="footer">
<div class="container">
<p class="text-muted alignright">LLNL-WEB-676715</p>
<p class="text-muted alignleft">
Developed by the <a href="/about/">MFEM team</a> at
<a href="http://computation.llnl.gov/casc/">CASC</a>,
<a href="https://www.llnl.gov/">LLNL</a></p>
</div>
</footer>
<script src="../../doc/web/jquery-1.10.2.min.js"></script>
<script src="../../doc/web/bootstrap-3.0.3.min.js"></script>
<script src="../../doc/web/highlight.pack.js"></script>
<script src="../../doc/web/base.js"></script>
<script src="../../doc/web/retina.min.js"></script>
<script src="../search/main.js"></script>
</body></html>
