Skip to content

Commit

Permalink
latest docs
Browse files Browse the repository at this point in the history
todo - automate this #26
  • Loading branch information
hkershaw-brown committed Dec 19, 2024
1 parent ad03e45 commit bd0041c
Show file tree
Hide file tree
Showing 6 changed files with 1 addition and 80 deletions.
Binary file modified docs/build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/build/doctrees/obs_sequence.doctree
Binary file not shown.
8 changes: 0 additions & 8 deletions docs/build/html/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -239,8 +239,6 @@ <h2 id="P">P</h2>
<li><a href="plots.html#module-0">module</a>
</li>
</ul></li>
<li><a href="obs_sequence.html#obs_sequence.possible_vs_used">possible_vs_used() (in module obs_sequence)</a>
</li>
</ul></td>
</tr></table>

Expand All @@ -263,12 +261,6 @@ <h2 id="R">R</h2>
<h2 id="S">S</h2>
<table style="width: 100%" class="indextable genindextable"><tr>
<td style="width: 33%; vertical-align: top;"><ul>
<li><a href="obs_sequence.html#obs_sequence.select_by_dart_qc">select_by_dart_qc() (in module obs_sequence)</a>
</li>
</ul></td>
<td style="width: 33%; vertical-align: top;"><ul>
<li><a href="obs_sequence.html#obs_sequence.select_failed_qcs">select_failed_qcs() (in module obs_sequence)</a>
</li>
<li><a href="obs_sequence.html#obs_sequence.obs_sequence.split_metadata">split_metadata() (obs_sequence.obs_sequence static method)</a>
</li>
</ul></td>
Expand Down
Binary file modified docs/build/html/objects.inv
Binary file not shown.
71 changes: 0 additions & 71 deletions docs/build/html/obs_sequence.html
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,6 @@ <h3>Navigation</h3>
</li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.load_yaml_to_dict"><code class="docutils literal notranslate"><span class="pre">load_yaml_to_dict()</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.convert_dart_time"><code class="docutils literal notranslate"><span class="pre">convert_dart_time()</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.select_by_dart_qc"><code class="docutils literal notranslate"><span class="pre">select_by_dart_qc()</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.select_failed_qcs"><code class="docutils literal notranslate"><span class="pre">select_failed_qcs()</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.possible_vs_used"><code class="docutils literal notranslate"><span class="pre">possible_vs_used()</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="#obs_sequence.construct_composit"><code class="docutils literal notranslate"><span class="pre">construct_composit()</span></code></a></li>
</ul>
</li>
Expand Down Expand Up @@ -431,74 +428,6 @@ <h3 id="searchlabel">Quick search</h3>
</div>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="obs_sequence.select_by_dart_qc">
<span class="sig-prename descclassname"><span class="pre">obs_sequence.</span></span><span class="sig-name descname"><span class="pre">select_by_dart_qc</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">df</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dart_qc</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#obs_sequence.select_by_dart_qc" title="Link to this definition"></a></dt>
<dd><p>Selects rows from a DataFrame based on the DART quality control flag.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><ul class="simple">
<li><p><strong>df</strong> (<em>DataFrame</em>) – A pandas DataFrame.</p></li>
<li><p><strong>dart_qc</strong> (<em>int</em>) – The DART quality control flag to select.</p></li>
</ul>
</dd>
<dt class="field-even">Returns<span class="colon">:</span></dt>
<dd class="field-even"><p>A DataFrame containing only the rows with the specified DART quality control flag.</p>
</dd>
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>DataFrame</p>
</dd>
<dt class="field-even">Raises<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>ValueError</strong> – If the DART quality control flag is not present in the DataFrame.</p>
</dd>
</dl>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="obs_sequence.select_failed_qcs">
<span class="sig-prename descclassname"><span class="pre">obs_sequence.</span></span><span class="sig-name descname"><span class="pre">select_failed_qcs</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">df</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#obs_sequence.select_failed_qcs" title="Link to this definition"></a></dt>
<dd><p>Selects rows from a DataFrame where the DART quality control flag is greater than 0.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><p><strong>df</strong> (<em>DataFrame</em>) – A pandas DataFrame.</p>
</dd>
<dt class="field-even">Returns<span class="colon">:</span></dt>
<dd class="field-even"><p>A DataFrame containing only the rows with a DART quality control flag greater than 0.</p>
</dd>
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>DataFrame</p>
</dd>
</dl>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="obs_sequence.possible_vs_used">
<span class="sig-prename descclassname"><span class="pre">obs_sequence.</span></span><span class="sig-name descname"><span class="pre">possible_vs_used</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">df</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#obs_sequence.possible_vs_used" title="Link to this definition"></a></dt>
<dd><p>Calculates the count of possible vs. used observations by type.</p>
<p>This function takes a DataFrame containing observation data, including a ‘type’ column for the observation
type and an ‘observation’ column. The number of used observations (‘used’), is the total number
minus the observations that failed quality control checks (as determined by the <cite>select_failed_qcs</cite> function).
The result is a DataFrame with each observation type, the count of possible observations, and the count of
used observations.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><ul class="simple">
<li><p><strong>df</strong> (<em>pd.DataFrame</em>) – A DataFrame with at least two columns: ‘type’ for the observation type and ‘observation’</p></li>
<li><p><strong>function</strong> (<em>for the observation data. It may also contain other columns required by the select_failed_qcs</em>)</p></li>
<li><p><strong>checks.</strong> (<em>to determine failed quality control</em>)</p></li>
</ul>
</dd>
<dt class="field-even">Returns<span class="colon">:</span></dt>
<dd class="field-even"><p>A DataFrame with three columns: ‘type’, ‘possible’, and ‘used’. ‘type’ is the observation type,
‘possible’ is the count of all observations of that type, and ‘used’ is the count of observations of that type
that passed quality control checks.</p>
</dd>
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>pd.DataFrame</p>
</dd>
</dl>
</dd></dl>

<dl class="py function">
<dt class="sig sig-object py" id="obs_sequence.construct_composit">
<span class="sig-prename descclassname"><span class="pre">obs_sequence.</span></span><span class="sig-name descname"><span class="pre">construct_composit</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">df_comp</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">composite</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">components</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#obs_sequence.construct_composit" title="Link to this definition"></a></dt>
Expand Down
Loading

0 comments on commit bd0041c

Please sign in to comment.