1
0
mirror of https://github.com/TREX-CoE/trexio.git synced 2024-12-25 13:53:55 +01:00

Deploying to gh-pages from @ TREX-CoE/trexio@98f2bfe067 🚀

This commit is contained in:
q-posev 2021-06-25 11:33:07 +00:00
parent 0699807d0c
commit 0766555a92
7 changed files with 181 additions and 1604 deletions

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>TREXIO source code documentation</title>
@ -342,7 +342,7 @@ and bug reports should be submitted at
</div>
<div id="postamble" class="status">
<p class="author">Author: TREX-CoE</p>
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>&lrm;</title>
@ -232,8 +232,8 @@ for the JavaScript code in this tag.
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#orga7989e2">1. Text back end</a></li>
<li><a href="#org31bbd41">2. HDF5 Back end</a></li>
<li><a href="#org1374a1a">1. Text back end</a></li>
<li><a href="#orge4a0cac">2. HDF5 Back end</a></li>
</ul>
</div>
</div>
@ -241,8 +241,8 @@ for the JavaScript code in this tag.
See templator<sub>front.org</sub>
</p>
<div id="outline-container-orga7989e2" class="outline-2">
<h2 id="orga7989e2"><span class="section-number-2">1</span> Text back end</h2>
<div id="outline-container-org1374a1a" class="outline-2">
<h2 id="org1374a1a"><span class="section-number-2">1</span> Text back end</h2>
<div class="outline-text-2" id="text-1">
<p>
As the size of the dataset should be extensible, the simplest
@ -256,8 +256,8 @@ The offset can be used with <code>fseek(69L*offset, SEEK_SET)</code>
</div>
</div>
<div id="outline-container-org31bbd41" class="outline-2">
<h2 id="org31bbd41"><span class="section-number-2">2</span> HDF5 Back end</h2>
<div id="outline-container-orge4a0cac" class="outline-2">
<h2 id="orge4a0cac"><span class="section-number-2">2</span> HDF5 Back end</h2>
<div class="outline-text-2" id="text-2">
<p>
We need to declare the number of rows of the dataset as
@ -278,7 +278,7 @@ If the offset+num &gt; nmax, we need to extend the dataset.
</div>
</div>
<div id="postamble" class="status">
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>TREXIO source code documentation</title>
@ -342,7 +342,7 @@ and bug reports should be submitted at
</div>
<div id="postamble" class="status">
<p class="author">Author: TREX-CoE</p>
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Front end API</title>
@ -333,61 +333,61 @@ for the JavaScript code in this tag.
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#org4ba59f6">1. Coding conventions</a>
<li><a href="#orgacac099">1. Coding conventions</a>
<ul>
<li><a href="#org3a2483f">1.1. Memory allocation</a></li>
<li><a href="#org5970039">1.1. Memory allocation</a></li>
</ul>
</li>
<li><a href="#orgb36effe">2. Front end</a>
<li><a href="#org9eba1ef">2. Front end</a>
<ul>
<li><a href="#org1092c9f">2.1. Error handling</a></li>
<li><a href="#org2894365">2.2. Back ends</a></li>
<li><a href="#org78b0199">2.3. Read/write behavior</a></li>
<li><a href="#org11bebb5">2.4. TREXIO file type</a></li>
<li><a href="#orgc335ac6">2.5. Polymorphism of the file handle</a></li>
<li><a href="#orgb9d6cc8">2.6. File opening</a></li>
<li><a href="#orgcb9b827">2.7. File closing</a></li>
<li><a href="#orgd85e29d">2.1. Error handling</a></li>
<li><a href="#orgdaca657">2.2. Back ends</a></li>
<li><a href="#org03b7d19">2.3. Read/write behavior</a></li>
<li><a href="#org6048754">2.4. TREXIO file type</a></li>
<li><a href="#orge9bb969">2.5. Polymorphism of the file handle</a></li>
<li><a href="#org5fd2a0b">2.6. File opening</a></li>
<li><a href="#org4a01f00">2.7. File closing</a></li>
</ul>
</li>
<li><a href="#org526f884">3. Templates for front end</a>
<li><a href="#orgb6a6afd">3. Templates for front end</a>
<ul>
<li><a href="#org4542d05">3.1. Description</a></li>
<li><a href="#orgb4276e2">3.2. Templates for front end has/read/write a single dimensioning variable</a>
<li><a href="#org6c90d82">3.1. Description</a></li>
<li><a href="#org3091a1a">3.2. Templates for front end has/read/write a single dimensioning variable</a>
<ul>
<li><a href="#orge59b033">3.2.1. C templates for front end</a></li>
<li><a href="#orgbcabf6b">3.2.2. Fortran templates for front end</a></li>
<li><a href="#org43b4d3f">3.2.1. C templates for front end</a></li>
<li><a href="#org2006186">3.2.2. Fortran templates for front end</a></li>
</ul>
</li>
<li><a href="#orgbbafe52">3.3. Templates for front end has/read/write a dataset of numerical data</a>
<li><a href="#org5d1ee16">3.3. Templates for front end has/read/write a dataset of numerical data</a>
<ul>
<li><a href="#org05016c0">3.3.1. C templates for front end</a></li>
<li><a href="#org2fb6840">3.3.2. Fortran templates for front end</a></li>
<li><a href="#org7ffc03c">3.3.1. C templates for front end</a></li>
<li><a href="#org51abf24">3.3.2. Fortran templates for front end</a></li>
</ul>
</li>
<li><a href="#org8f8d7ff">3.4. Sparse data structures</a></li>
<li><a href="#org7ebf3df">3.5. Templates for front end has/read/write a dataset of strings</a>
<li><a href="#org4965135">3.4. Sparse data structures</a></li>
<li><a href="#org62e0fac">3.5. Templates for front end has/read/write a dataset of strings</a>
<ul>
<li><a href="#org52665b1">3.5.1. Introduction</a></li>
<li><a href="#org1b9fc56">3.5.2. C templates for front end</a></li>
<li><a href="#org3ed7538">3.5.3. Fortran templates for front end</a></li>
<li><a href="#org3ff3ff9">3.5.1. Introduction</a></li>
<li><a href="#org878f017">3.5.2. C templates for front end</a></li>
<li><a href="#orgcd933e5">3.5.3. Fortran templates for front end</a></li>
</ul>
</li>
<li><a href="#org3db11da">3.6. Templates for front end has/read/write a single string attribute</a>
<li><a href="#org713373e">3.6. Templates for front end has/read/write a single string attribute</a>
<ul>
<li><a href="#org67c2f6a">3.6.1. Introduction</a></li>
<li><a href="#org447d1c1">3.6.2. C templates for front end</a></li>
<li><a href="#org890b66d">3.6.3. Fortran templates for front end</a></li>
<li><a href="#org3d2e75a">3.6.1. Introduction</a></li>
<li><a href="#org5e20ff8">3.6.2. C templates for front end</a></li>
<li><a href="#org1a652b8">3.6.3. Fortran templates for front end</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#org0500bfe">4. Fortran helper/wrapper functions</a></li>
<li><a href="#org2606815">4. Fortran helper/wrapper functions</a></li>
</ul>
</div>
</div>
<div id="outline-container-org4ba59f6" class="outline-2">
<h2 id="org4ba59f6"><span class="section-number-2">1</span> Coding conventions</h2>
<div id="outline-container-orgacac099" class="outline-2">
<h2 id="orgacac099"><span class="section-number-2">1</span> Coding conventions</h2>
<div class="outline-text-2" id="text-1">
<ul class="org-ul">
<li>integer types will be defined using types given in <code>stdint.h</code></li>
@ -402,8 +402,8 @@ for the JavaScript code in this tag.
</ul>
</div>
<div id="outline-container-org3a2483f" class="outline-3">
<h3 id="org3a2483f"><span class="section-number-3">1.1</span> Memory allocation</h3>
<div id="outline-container-org5970039" class="outline-3">
<h3 id="org5970039"><span class="section-number-3">1.1</span> Memory allocation</h3>
<div class="outline-text-3" id="text-1-1">
<p>
Memory allocation of structures can be facilitated by using the
@ -438,8 +438,8 @@ The maximum string size for the filenames is 4096 characters.
</div>
</div>
<div id="outline-container-orgb36effe" class="outline-2">
<h2 id="orgb36effe"><span class="section-number-2">2</span> Front end</h2>
<div id="outline-container-org9eba1ef" class="outline-2">
<h2 id="org9eba1ef"><span class="section-number-2">2</span> Front end</h2>
<div class="outline-text-2" id="text-2">
<p>
All calls to TREXIO are thread-safe.
@ -447,10 +447,10 @@ TREXIO front end is modular, which simplifies implementation of new back ends.
</p>
</div>
<div id="outline-container-org1092c9f" class="outline-3">
<h3 id="org1092c9f"><span class="section-number-3">2.1</span> Error handling</h3>
<div id="outline-container-orgd85e29d" class="outline-3">
<h3 id="orgd85e29d"><span class="section-number-3">2.1</span> Error handling</h3>
<div class="outline-text-3" id="text-2-1">
<table id="orgbbf948f" border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<table id="org4f205c1" border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
@ -750,8 +750,8 @@ The text strings are extracted from the previous table.
</div>
</div>
<div id="outline-container-org2894365" class="outline-3">
<h3 id="org2894365"><span class="section-number-3">2.2</span> Back ends</h3>
<div id="outline-container-orgdaca657" class="outline-3">
<h3 id="orgdaca657"><span class="section-number-3">2.2</span> Back ends</h3>
<div class="outline-text-3" id="text-2-2">
<p>
TREXIO has several back ends:
@ -783,8 +783,8 @@ lines that correspond to the <code>TREXIO_JSON</code> back end (not implemented
</div>
</div>
</div>
<div id="outline-container-org78b0199" class="outline-3">
<h3 id="org78b0199"><span class="section-number-3">2.3</span> Read/write behavior</h3>
<div id="outline-container-org03b7d19" class="outline-3">
<h3 id="org03b7d19"><span class="section-number-3">2.3</span> Read/write behavior</h3>
<div class="outline-text-3" id="text-2-3">
<p>
Every time a reading function is called, the data is read from the
@ -812,8 +812,8 @@ concurrent programs, the behavior is not specified.
</p>
</div>
</div>
<div id="outline-container-org11bebb5" class="outline-3">
<h3 id="org11bebb5"><span class="section-number-3">2.4</span> TREXIO file type</h3>
<div id="outline-container-org6048754" class="outline-3">
<h3 id="org6048754"><span class="section-number-3">2.4</span> TREXIO file type</h3>
<div class="outline-text-3" id="text-2-4">
<p>
<code>trexio_s</code> is the the main type for TREXIO files, visible to the users
@ -846,8 +846,8 @@ TREXIO files will have as a first argument the TREXIO file handle.
</div>
</div>
</div>
<div id="outline-container-orgc335ac6" class="outline-3">
<h3 id="orgc335ac6"><span class="section-number-3">2.5</span> Polymorphism of the file handle</h3>
<div id="outline-container-orge9bb969" class="outline-3">
<h3 id="orge9bb969"><span class="section-number-3">2.5</span> Polymorphism of the file handle</h3>
<div class="outline-text-3" id="text-2-5">
<p>
Polymorphism of the <code>trexio_t</code> type is handled by ensuring that the
@ -866,8 +866,8 @@ corresponding types for all back ends can be safely casted to
</div>
</div>
<div id="outline-container-orgb9d6cc8" class="outline-3">
<h3 id="orgb9d6cc8"><span class="section-number-3">2.6</span> File opening</h3>
<div id="outline-container-org5fd2a0b" class="outline-3">
<h3 id="org5fd2a0b"><span class="section-number-3">2.6</span> File opening</h3>
<div class="outline-text-3" id="text-2-6">
<p>
<code>trexio_open</code> creates a new TREXIO file or opens existing one.
@ -1058,8 +1058,8 @@ know if we need to shift by 1 arrays of indices.
</div>
</div>
<div id="outline-container-orgcb9b827" class="outline-3">
<h3 id="orgcb9b827"><span class="section-number-3">2.7</span> File closing</h3>
<div id="outline-container-org4a01f00" class="outline-3">
<h3 id="org4a01f00"><span class="section-number-3">2.7</span> File closing</h3>
<div class="outline-text-3" id="text-2-7">
<p>
<code>trexio_close</code> closes an existing <code>trexio_t</code> file.
@ -1155,12 +1155,12 @@ output:
</div>
</div>
<div id="outline-container-org526f884" class="outline-2">
<h2 id="org526f884"><span class="section-number-2">3</span> Templates for front end</h2>
<div id="outline-container-orgb6a6afd" class="outline-2">
<h2 id="orgb6a6afd"><span class="section-number-2">3</span> Templates for front end</h2>
<div class="outline-text-2" id="text-3">
</div>
<div id="outline-container-org4542d05" class="outline-3">
<h3 id="org4542d05"><span class="section-number-3">3.1</span> Description</h3>
<div id="outline-container-org6c90d82" class="outline-3">
<h3 id="org6c90d82"><span class="section-number-3">3.1</span> Description</h3>
<div class="outline-text-3" id="text-3-1">
<p>
Consider the following block of <code>trex.json</code>:
@ -1350,8 +1350,8 @@ or double precision for integer and floating point numbers.
</div>
</div>
<div id="outline-container-orgb4276e2" class="outline-3">
<h3 id="orgb4276e2"><span class="section-number-3">3.2</span> Templates for front end has/read/write a single dimensioning variable</h3>
<div id="outline-container-org3091a1a" class="outline-3">
<h3 id="org3091a1a"><span class="section-number-3">3.2</span> Templates for front end has/read/write a single dimensioning variable</h3>
<div class="outline-text-3" id="text-3-2">
<p>
This section concerns API calls related to dimensioning variables.
@ -1420,8 +1420,8 @@ This section concerns API calls related to dimensioning variables.
</table>
</div>
<div id="outline-container-orge59b033" class="outline-4">
<h4 id="orge59b033"><span class="section-number-4">3.2.1</span> C templates for front end</h4>
<div id="outline-container-org43b4d3f" class="outline-4">
<h4 id="org43b4d3f"><span class="section-number-4">3.2.1</span> C templates for front end</h4>
<div class="outline-text-4" id="text-3-2-1">
<p>
The <code>C</code> templates that correspond to each of the abovementioned
@ -1610,8 +1610,8 @@ precision (see Table above).
</div>
</div>
<div id="outline-container-orgbcabf6b" class="outline-4">
<h4 id="orgbcabf6b"><span class="section-number-4">3.2.2</span> Fortran templates for front end</h4>
<div id="outline-container-org2006186" class="outline-4">
<h4 id="org2006186"><span class="section-number-4">3.2.2</span> Fortran templates for front end</h4>
<div class="outline-text-4" id="text-3-2-2">
<p>
The <code>Fortran</code> templates that provide an access to the <code>C</code> API calls from Fortran.
@ -1697,8 +1697,8 @@ These templates are based on the use of <code>iso_c_binding</code>. Pointers hav
</div>
</div>
<div id="outline-container-orgbbafe52" class="outline-3">
<h3 id="orgbbafe52"><span class="section-number-3">3.3</span> Templates for front end has/read/write a dataset of numerical data</h3>
<div id="outline-container-org5d1ee16" class="outline-3">
<h3 id="org5d1ee16"><span class="section-number-3">3.3</span> Templates for front end has/read/write a dataset of numerical data</h3>
<div class="outline-text-3" id="text-3-3">
<p>
This section concerns API calls related to datasets.
@ -1767,8 +1767,8 @@ This section concerns API calls related to datasets.
</table>
</div>
<div id="outline-container-org05016c0" class="outline-4">
<h4 id="org05016c0"><span class="section-number-4">3.3.1</span> C templates for front end</h4>
<div id="outline-container-org7ffc03c" class="outline-4">
<h4 id="org7ffc03c"><span class="section-number-4">3.3.1</span> C templates for front end</h4>
<div class="outline-text-4" id="text-3-3-1">
<p>
The C templates that correspond to each of the abovementioned functions can be found below.
@ -2087,8 +2087,8 @@ The basic (non-suffixed) API call on datasets deals with double precision (see T
</div>
</div>
<div id="outline-container-org2fb6840" class="outline-4">
<h4 id="org2fb6840"><span class="section-number-4">3.3.2</span> Fortran templates for front end</h4>
<div id="outline-container-org51abf24" class="outline-4">
<h4 id="org51abf24"><span class="section-number-4">3.3.2</span> Fortran templates for front end</h4>
<div class="outline-text-4" id="text-3-3-2">
<p>
The <code>Fortran</code> templates that provide an access to the <code>C</code> API calls from <code>Fortran</code>.
@ -2174,8 +2174,8 @@ These templates are based on the use of <code>iso_c_binding</code>. Pointers hav
</div>
</div>
<div id="outline-container-org8f8d7ff" class="outline-3">
<h3 id="org8f8d7ff"><span class="section-number-3">3.4</span> Sparse data structures</h3>
<div id="outline-container-org4965135" class="outline-3">
<h3 id="org4965135"><span class="section-number-3">3.4</span> Sparse data structures</h3>
<div class="outline-text-3" id="text-3-4">
<p>
Sparse data structures are used typically for large tensors such as
@ -2316,12 +2316,12 @@ For the values,
</div>
</div>
<div id="outline-container-org7ebf3df" class="outline-3">
<h3 id="org7ebf3df"><span class="section-number-3">3.5</span> Templates for front end has/read/write a dataset of strings</h3>
<div id="outline-container-org62e0fac" class="outline-3">
<h3 id="org62e0fac"><span class="section-number-3">3.5</span> Templates for front end has/read/write a dataset of strings</h3>
<div class="outline-text-3" id="text-3-5">
</div>
<div id="outline-container-org52665b1" class="outline-4">
<h4 id="org52665b1"><span class="section-number-4">3.5.1</span> Introduction</h4>
<div id="outline-container-org3ff3ff9" class="outline-4">
<h4 id="org3ff3ff9"><span class="section-number-4">3.5.1</span> Introduction</h4>
<div class="outline-text-4" id="text-3-5-1">
<p>
This section concerns API calls related to datasets of strings.
@ -2361,8 +2361,8 @@ This section concerns API calls related to datasets of strings.
</div>
</div>
<div id="outline-container-org1b9fc56" class="outline-4">
<h4 id="org1b9fc56"><span class="section-number-4">3.5.2</span> C templates for front end</h4>
<div id="outline-container-org878f017" class="outline-4">
<h4 id="org878f017"><span class="section-number-4">3.5.2</span> C templates for front end</h4>
<div class="outline-text-4" id="text-3-5-2">
<p>
First parameter is the <code>TREXIO</code> file handle. Second parameter is the variable to be written/read
@ -2605,8 +2605,8 @@ to/from the <code>TREXIO</code> file (except for <code>trexio_has_</code> functi
</div>
</div>
<div id="outline-container-org3ed7538" class="outline-4">
<h4 id="org3ed7538"><span class="section-number-4">3.5.3</span> Fortran templates for front end</h4>
<div id="outline-container-orgcd933e5" class="outline-4">
<h4 id="orgcd933e5"><span class="section-number-4">3.5.3</span> Fortran templates for front end</h4>
<div class="outline-text-4" id="text-3-5-3">
<p>
The <code>Fortran</code> templates that provide an access to the <code>C</code> API calls from <code>Fortran</code>.
@ -2703,12 +2703,12 @@ These templates are based on the use of <code>iso_c_binding</code>. Pointers hav
</div>
</div>
<div id="outline-container-org3db11da" class="outline-3">
<h3 id="org3db11da"><span class="section-number-3">3.6</span> Templates for front end has/read/write a single string attribute</h3>
<div id="outline-container-org713373e" class="outline-3">
<h3 id="org713373e"><span class="section-number-3">3.6</span> Templates for front end has/read/write a single string attribute</h3>
<div class="outline-text-3" id="text-3-6">
</div>
<div id="outline-container-org67c2f6a" class="outline-4">
<h4 id="org67c2f6a"><span class="section-number-4">3.6.1</span> Introduction</h4>
<div id="outline-container-org3d2e75a" class="outline-4">
<h4 id="org3d2e75a"><span class="section-number-4">3.6.1</span> Introduction</h4>
<div class="outline-text-4" id="text-3-6-1">
<p>
This section concerns API calls related to string attributes.
@ -2748,8 +2748,8 @@ This section concerns API calls related to string attributes.
</div>
</div>
<div id="outline-container-org447d1c1" class="outline-4">
<h4 id="org447d1c1"><span class="section-number-4">3.6.2</span> C templates for front end</h4>
<div id="outline-container-org5e20ff8" class="outline-4">
<h4 id="org5e20ff8"><span class="section-number-4">3.6.2</span> C templates for front end</h4>
<div class="outline-text-4" id="text-3-6-2">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -2849,8 +2849,8 @@ This section concerns API calls related to string attributes.
</div>
</div>
<div id="outline-container-org890b66d" class="outline-4">
<h4 id="org890b66d"><span class="section-number-4">3.6.3</span> Fortran templates for front end</h4>
<div id="outline-container-org1a652b8" class="outline-4">
<h4 id="org1a652b8"><span class="section-number-4">3.6.3</span> Fortran templates for front end</h4>
<div class="outline-text-4" id="text-3-6-3">
<p>
The <code>Fortran</code> templates that provide an access to the <code>C</code> API calls from Fortran.
@ -2929,8 +2929,8 @@ These templates are based on the use of <code>iso_c_binding</code>. Pointers hav
</div>
</div>
<div id="outline-container-org0500bfe" class="outline-2">
<h2 id="org0500bfe"><span class="section-number-2">4</span> Fortran helper/wrapper functions</h2>
<div id="outline-container-org2606815" class="outline-2">
<h2 id="org2606815"><span class="section-number-2">4</span> Fortran helper/wrapper functions</h2>
<div class="outline-text-2" id="text-4">
<p>
The function below adapts the original C-based <code>trexio_open</code> for Fortran.
@ -3064,7 +3064,7 @@ two code are identical, i.e. if the <code>assert</code> statement pass.
</div>
<div id="postamble" class="status">
<p class="author">Author: TREX-CoE</p>
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>HDF5 back end</title>
@ -311,27 +311,27 @@ for the JavaScript code in this tag.
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#orgfd87900">1. HDF5 back end</a>
<li><a href="#org5445da1">1. HDF5 back end</a>
<ul>
<li><a href="#org24d8fd8">1.1. Template for HDF5 definitions</a></li>
<li><a href="#orgb85053e">1.2. Template for HDF5 structures</a></li>
<li><a href="#org03637f4">1.3. Template for HDF5 init/deinit</a></li>
<li><a href="#org3302909">1.4. Template for HDF5 has/read/write a single dimensioning variable</a></li>
<li><a href="#org20cce53">1.5. Template for HDF5 has/read/write a dataset of numerical data</a></li>
<li><a href="#org994bd9b">1.6. Template for HDF5 has/read/write a dataset of strings</a></li>
<li><a href="#org50eafa0">1.7. Template for HDF5 has/read/write a single string attribute</a></li>
<li><a href="#org6dbb574">1.1. Template for HDF5 definitions</a></li>
<li><a href="#org41ced8d">1.2. Template for HDF5 structures</a></li>
<li><a href="#org83240b5">1.3. Template for HDF5 init/deinit</a></li>
<li><a href="#org24a57c3">1.4. Template for HDF5 has/read/write a single dimensioning variable</a></li>
<li><a href="#org6cefa5c">1.5. Template for HDF5 has/read/write a dataset of numerical data</a></li>
<li><a href="#orgf808287">1.6. Template for HDF5 has/read/write a dataset of strings</a></li>
<li><a href="#orgbe00acb">1.7. Template for HDF5 has/read/write a single string attribute</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div id="outline-container-orgfd87900" class="outline-2">
<h2 id="orgfd87900"><span class="section-number-2">1</span> HDF5 back end</h2>
<div id="outline-container-org5445da1" class="outline-2">
<h2 id="org5445da1"><span class="section-number-2">1</span> HDF5 back end</h2>
<div class="outline-text-2" id="text-1">
</div>
<div id="outline-container-org24d8fd8" class="outline-3">
<h3 id="org24d8fd8"><span class="section-number-3">1.1</span> Template for HDF5 definitions</h3>
<div id="outline-container-org6dbb574" class="outline-3">
<h3 id="org6dbb574"><span class="section-number-3">1.1</span> Template for HDF5 definitions</h3>
<div class="outline-text-3" id="text-1-1">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #483d8b;">#define</span> $GROUP$_GROUP_NAME <span style="color: #8b2252;">"$group$"</span>
@ -343,8 +343,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-orgb85053e" class="outline-3">
<h3 id="orgb85053e"><span class="section-number-3">1.2</span> Template for HDF5 structures</h3>
<div id="outline-container-org41ced8d" class="outline-3">
<h3 id="org41ced8d"><span class="section-number-3">1.2</span> Template for HDF5 structures</h3>
<div class="outline-text-3" id="text-1-2">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #a020f0;">typedef</span> <span style="color: #a020f0;">struct</span> <span style="color: #228b22;">trexio_hdf5_s</span> {
@ -359,8 +359,8 @@ for the JavaScript code in this tag.
</div>
<div id="outline-container-org03637f4" class="outline-3">
<h3 id="org03637f4"><span class="section-number-3">1.3</span> Template for HDF5 init/deinit</h3>
<div id="outline-container-org83240b5" class="outline-3">
<h3 id="org83240b5"><span class="section-number-3">1.3</span> Template for HDF5 init/deinit</h3>
<div class="outline-text-3" id="text-1-3">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -440,8 +440,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-org3302909" class="outline-3">
<h3 id="org3302909"><span class="section-number-3">1.4</span> Template for HDF5 has/read/write a single dimensioning variable</h3>
<div id="outline-container-org24a57c3" class="outline-3">
<h3 id="org24a57c3"><span class="section-number-3">1.4</span> Template for HDF5 has/read/write a single dimensioning variable</h3>
<div class="outline-text-3" id="text-1-4">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -557,8 +557,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-org20cce53" class="outline-3">
<h3 id="org20cce53"><span class="section-number-3">1.5</span> Template for HDF5 has/read/write a dataset of numerical data</h3>
<div id="outline-container-org6cefa5c" class="outline-3">
<h3 id="org6cefa5c"><span class="section-number-3">1.5</span> Template for HDF5 has/read/write a dataset of numerical data</h3>
<div class="outline-text-3" id="text-1-5">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -687,8 +687,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-org994bd9b" class="outline-3">
<h3 id="org994bd9b"><span class="section-number-3">1.6</span> Template for HDF5 has/read/write a dataset of strings</h3>
<div id="outline-container-orgf808287" class="outline-3">
<h3 id="orgf808287"><span class="section-number-3">1.6</span> Template for HDF5 has/read/write a dataset of strings</h3>
<div class="outline-text-3" id="text-1-6">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -892,8 +892,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-org50eafa0" class="outline-3">
<h3 id="org50eafa0"><span class="section-number-3">1.7</span> Template for HDF5 has/read/write a single string attribute</h3>
<div id="outline-container-orgbe00acb" class="outline-3">
<h3 id="orgbe00acb"><span class="section-number-3">1.7</span> Template for HDF5 has/read/write a single string attribute</h3>
<div class="outline-text-3" id="text-1-7">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -1020,7 +1020,7 @@ for the JavaScript code in this tag.
</div>
<div id="postamble" class="status">
<p class="author">Author: TREX-CoE</p>
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-23 Wed 15:06 -->
<!-- 2021-06-25 Fri 11:33 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>TEXT back end</title>
@ -311,26 +311,26 @@ for the JavaScript code in this tag.
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#org0420ddb">1. TEXT back end</a>
<li><a href="#orgdab62b2">1. TEXT back end</a>
<ul>
<li><a href="#org034b94e">1.1. Template for group-related structures in text back end</a></li>
<li><a href="#org9b282a4">1.2. Template for general structure in text back end</a></li>
<li><a href="#org2cdfb4b">1.3. Initialize function (constant part)</a></li>
<li><a href="#org3a5475b">1.4. Deinitialize function (templated part)</a></li>
<li><a href="#org4c2e88d">1.5. Template for text read struct</a></li>
<li><a href="#orgf808296">1.6. Template for text flush struct</a></li>
<li><a href="#org1a39ae7">1.7. Template for text free memory</a></li>
<li><a href="#org23d3583">1.8. Template for has/read/write the num attribute</a></li>
<li><a href="#orga3e5a70">1.9. Template for has/read/write the dataset of numerical data</a></li>
<li><a href="#org4eba068">1.10. Template for has/read/write the dataset of strings</a></li>
<li><a href="#orgf2e02be">1.11. Template for has/read/write the string attribute</a></li>
<li><a href="#org3694ef2">1.12. RDM struct (hard-coded)</a>
<li><a href="#orgfdaa1dc">1.1. Template for group-related structures in text back end</a></li>
<li><a href="#orgf88472a">1.2. Template for general structure in text back end</a></li>
<li><a href="#orgd224c6d">1.3. Initialize function (constant part)</a></li>
<li><a href="#org0066507">1.4. Deinitialize function (templated part)</a></li>
<li><a href="#org00db74f">1.5. Template for text read struct</a></li>
<li><a href="#orgbcc04cd">1.6. Template for text flush struct</a></li>
<li><a href="#orgc907663">1.7. Template for text free memory</a></li>
<li><a href="#org5c9c613">1.8. Template for has/read/write the num attribute</a></li>
<li><a href="#org10d1e8e">1.9. Template for has/read/write the dataset of numerical data</a></li>
<li><a href="#org0ccfbf1">1.10. Template for has/read/write the dataset of strings</a></li>
<li><a href="#orgabef7de">1.11. Template for has/read/write the string attribute</a></li>
<li><a href="#org381622f">1.12. RDM struct (hard-coded)</a>
<ul>
<li><a href="#org9270217">1.12.1. Read the complete struct</a></li>
<li><a href="#org14943f1">1.12.2. Flush the complete struct</a></li>
<li><a href="#org1d765a3">1.12.3. Free memory</a></li>
<li><a href="#orgb98b7bc">1.12.4. Read/Write the one<sub>e</sub> attribute</a></li>
<li><a href="#org84e9ae9">1.12.5. Read/Write the two<sub>e</sub> attribute</a></li>
<li><a href="#orge592c72">1.12.1. Read the complete struct</a></li>
<li><a href="#orgf5b0948">1.12.2. Flush the complete struct</a></li>
<li><a href="#org43f2d01">1.12.3. Free memory</a></li>
<li><a href="#orgaa70280">1.12.4. Read/Write the one<sub>e</sub> attribute</a></li>
<li><a href="#org5c48fec">1.12.5. Read/Write the two<sub>e</sub> attribute</a></li>
</ul>
</li>
</ul>
@ -339,8 +339,8 @@ for the JavaScript code in this tag.
</div>
</div>
<div id="outline-container-org0420ddb" class="outline-2">
<h2 id="org0420ddb"><span class="section-number-2">1</span> TEXT back end</h2>
<div id="outline-container-orgdab62b2" class="outline-2">
<h2 id="orgdab62b2"><span class="section-number-2">1</span> TEXT back end</h2>
<div class="outline-text-2" id="text-1">
<p>
The "file" produced by the text back end is a directory with one
@ -361,8 +361,8 @@ The file is written when closed, or when the flush function is called.
</p>
</div>
<div id="outline-container-org034b94e" class="outline-3">
<h3 id="org034b94e"><span class="section-number-3">1.1</span> Template for group-related structures in text back end</h3>
<div id="outline-container-orgfdaa1dc" class="outline-3">
<h3 id="orgfdaa1dc"><span class="section-number-3">1.1</span> Template for group-related structures in text back end</h3>
<div class="outline-text-3" id="text-1-1">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #a020f0;">typedef</span> <span style="color: #a020f0;">struct</span> $group$_s {
@ -380,8 +380,8 @@ The file is written when closed, or when the flush function is called.
</div>
</div>
<div id="outline-container-org9b282a4" class="outline-3">
<h3 id="org9b282a4"><span class="section-number-3">1.2</span> Template for general structure in text back end</h3>
<div id="outline-container-orgf88472a" class="outline-3">
<h3 id="orgf88472a"><span class="section-number-3">1.2</span> Template for general structure in text back end</h3>
<div class="outline-text-3" id="text-1-2">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #a020f0;">typedef</span> <span style="color: #a020f0;">struct</span> <span style="color: #228b22;">rdm_s</span> {
@ -407,8 +407,8 @@ The file is written when closed, or when the flush function is called.
</div>
</div>
<div id="outline-container-org2cdfb4b" class="outline-3">
<h3 id="org2cdfb4b"><span class="section-number-3">1.3</span> Initialize function (constant part)</h3>
<div id="outline-container-orgd224c6d" class="outline-3">
<h3 id="orgd224c6d"><span class="section-number-3">1.3</span> Initialize function (constant part)</h3>
<div class="outline-text-3" id="text-1-3">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -509,8 +509,8 @@ The file is written when closed, or when the flush function is called.
</div>
</div>
<div id="outline-container-org3a5475b" class="outline-3">
<h3 id="org3a5475b"><span class="section-number-3">1.4</span> Deinitialize function (templated part)</h3>
<div id="outline-container-org0066507" class="outline-3">
<h3 id="org0066507"><span class="section-number-3">1.4</span> Deinitialize function (templated part)</h3>
<div class="outline-text-3" id="text-1-4">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -535,8 +535,8 @@ The file is written when closed, or when the flush function is called.
</div>
</div>
<div id="outline-container-org4c2e88d" class="outline-3">
<h3 id="org4c2e88d"><span class="section-number-3">1.5</span> Template for text read struct</h3>
<div id="outline-container-org00db74f" class="outline-3">
<h3 id="org00db74f"><span class="section-number-3">1.5</span> Template for text read struct</h3>
<div class="outline-text-3" id="text-1-5">
<div class="org-src-container">
<pre class="src src-c">$group$_t*
@ -807,8 +807,8 @@ trexio_text_read_$group$ (<span style="color: #228b22;">trexio_text_t</span>* <s
</div>
</div>
<div id="outline-container-orgf808296" class="outline-3">
<h3 id="orgf808296"><span class="section-number-3">1.6</span> Template for text flush struct</h3>
<div id="outline-container-orgbcc04cd" class="outline-3">
<h3 id="orgbcc04cd"><span class="section-number-3">1.6</span> Template for text flush struct</h3>
<div class="outline-text-3" id="text-1-6">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -872,8 +872,8 @@ trexio_text_read_$group$ (<span style="color: #228b22;">trexio_text_t</span>* <s
</div>
</div>
<div id="outline-container-org1a39ae7" class="outline-3">
<h3 id="org1a39ae7"><span class="section-number-3">1.7</span> Template for text free memory</h3>
<div id="outline-container-orgc907663" class="outline-3">
<h3 id="orgc907663"><span class="section-number-3">1.7</span> Template for text free memory</h3>
<div class="outline-text-3" id="text-1-7">
<p>
Memory is allocated when reading. The following function frees memory.
@ -918,8 +918,8 @@ Memory is allocated when reading. The following function frees memory.
</div>
</div>
<div id="outline-container-org23d3583" class="outline-3">
<h3 id="org23d3583"><span class="section-number-3">1.8</span> Template for has/read/write the num attribute</h3>
<div id="outline-container-org5c9c613" class="outline-3">
<h3 id="org5c9c613"><span class="section-number-3">1.8</span> Template for has/read/write the num attribute</h3>
<div class="outline-text-3" id="text-1-8">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -981,8 +981,8 @@ Memory is allocated when reading. The following function frees memory.
</div>
</div>
<div id="outline-container-orga3e5a70" class="outline-3">
<h3 id="orga3e5a70"><span class="section-number-3">1.9</span> Template for has/read/write the dataset of numerical data</h3>
<div id="outline-container-org10d1e8e" class="outline-3">
<h3 id="org10d1e8e"><span class="section-number-3">1.9</span> Template for has/read/write the dataset of numerical data</h3>
<div class="outline-text-3" id="text-1-9">
<p>
The <code>group_dset</code> array is assumed allocated with the appropriate size.
@ -1078,8 +1078,8 @@ The <code>group_dset</code> array is assumed allocated with the appropriate size
</div>
</div>
</div>
<div id="outline-container-org4eba068" class="outline-3">
<h3 id="org4eba068"><span class="section-number-3">1.10</span> Template for has/read/write the dataset of strings</h3>
<div id="outline-container-org0ccfbf1" class="outline-3">
<h3 id="org0ccfbf1"><span class="section-number-3">1.10</span> Template for has/read/write the dataset of strings</h3>
<div class="outline-text-3" id="text-1-10">
<p>
The <code>group_dset</code> array is assumed allocated with the appropriate size.
@ -1181,8 +1181,8 @@ The <code>group_dset</code> array is assumed allocated with the appropriate size
</div>
</div>
</div>
<div id="outline-container-orgf2e02be" class="outline-3">
<h3 id="orgf2e02be"><span class="section-number-3">1.11</span> Template for has/read/write the string attribute</h3>
<div id="outline-container-orgabef7de" class="outline-3">
<h3 id="orgabef7de"><span class="section-number-3">1.11</span> Template for has/read/write the string attribute</h3>
<div class="outline-text-3" id="text-1-11">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span>
@ -1256,12 +1256,12 @@ The <code>group_dset</code> array is assumed allocated with the appropriate size
</div>
</div>
</div>
<div id="outline-container-org3694ef2" class="outline-3">
<h3 id="org3694ef2"><span class="section-number-3">1.12</span> RDM struct (hard-coded)</h3>
<div id="outline-container-org381622f" class="outline-3">
<h3 id="org381622f"><span class="section-number-3">1.12</span> RDM struct (hard-coded)</h3>
<div class="outline-text-3" id="text-1-12">
</div>
<div id="outline-container-org9270217" class="outline-4">
<h4 id="org9270217"><span class="section-number-4">1.12.1</span> Read the complete struct</h4>
<div id="outline-container-orge592c72" class="outline-4">
<h4 id="orge592c72"><span class="section-number-4">1.12.1</span> Read the complete struct</h4>
<div class="outline-text-4" id="text-1-12-1">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">rdm_t</span>* <span style="color: #0000ff;">trexio_text_read_rdm</span>(<span style="color: #228b22;">trexio_text_t</span>* <span style="color: #a020f0;">const</span> <span style="color: #a0522d;">file</span>);
@ -1356,8 +1356,8 @@ The <code>group_dset</code> array is assumed allocated with the appropriate size
</div>
</div>
<div id="outline-container-org14943f1" class="outline-4">
<h4 id="org14943f1"><span class="section-number-4">1.12.2</span> Flush the complete struct</h4>
<div id="outline-container-orgf5b0948" class="outline-4">
<h4 id="orgf5b0948"><span class="section-number-4">1.12.2</span> Flush the complete struct</h4>
<div class="outline-text-4" id="text-1-12-2">
<div class="org-src-container">
<pre class="src src-c"><span style="color: #228b22;">trexio_exit_code</span> <span style="color: #0000ff;">trexio_text_flush_rdm</span>(<span style="color: #228b22;">trexio_text_t</span>* <span style="color: #a020f0;">const</span> <span style="color: #a0522d;">file</span>);
@ -1399,8 +1399,8 @@ The <code>group_dset</code> array is assumed allocated with the appropriate size
</div>
</div>
<div id="outline-container-org1d765a3" class="outline-4">
<h4 id="org1d765a3"><span class="section-number-4">1.12.3</span> Free memory</h4>
<div id="outline-container-org43f2d01" class="outline-4">
<h4 id="org43f2d01"><span class="section-number-4">1.12.3</span> Free memory</h4>
<div class="outline-text-4" id="text-1-12-3">
<p>
Memory is allocated when reading. The followig function frees memory.
@ -1436,8 +1436,8 @@ Memory is allocated when reading. The followig function frees memory.
</div>
</div>
<div id="outline-container-orgb98b7bc" class="outline-4">
<h4 id="orgb98b7bc"><span class="section-number-4">1.12.4</span> Read/Write the one<sub>e</sub> attribute</h4>
<div id="outline-container-orgaa70280" class="outline-4">
<h4 id="orgaa70280"><span class="section-number-4">1.12.4</span> Read/Write the one<sub>e</sub> attribute</h4>
<div class="outline-text-4" id="text-1-12-4">
<p>
The <code>one_e</code> array is assumed allocated with the appropriate size.
@ -1503,8 +1503,8 @@ The <code>one_e</code> array is assumed allocated with the appropriate size.
</div>
</div>
<div id="outline-container-org84e9ae9" class="outline-4">
<h4 id="org84e9ae9"><span class="section-number-4">1.12.5</span> Read/Write the two<sub>e</sub> attribute</h4>
<div id="outline-container-org5c48fec" class="outline-4">
<h4 id="org5c48fec"><span class="section-number-4">1.12.5</span> Read/Write the two<sub>e</sub> attribute</h4>
<div class="outline-text-4" id="text-1-12-5">
<p>
<code>two_e</code> is a sparse data structure, which can be too large to fit
@ -1612,7 +1612,7 @@ file for each sparse float structure.
</div>
<div id="postamble" class="status">
<p class="author">Author: TREX-CoE</p>
<p class="date">Created: 2021-06-23 Wed 15:06</p>
<p class="date">Created: 2021-06-25 Fri 11:33</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>

1423
trex.html

File diff suppressed because it is too large Load Diff