Skip to content

Commit 6f89f39

Browse files
committed
add docs html
1 parent 91fe68e commit 6f89f39

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

63 files changed

+30959
-0
lines changed

docs/.buildinfo

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Sphinx build info version 1
2+
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3+
config: 4956aeab6309c507fe434630bfafbc9b
4+
tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_images/smart-model-structure.svg

+1,262
Loading

docs/_panels_static/panels-main.c949a650a448cc0ae9fd3441c0e17fb0.css

+1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
:root {
2+
--tabs-color-label-active: hsla(231, 99%, 66%, 1);
3+
--tabs-color-label-inactive: rgba(178, 206, 245, 0.62);
4+
--tabs-color-overline: rgb(207, 236, 238);
5+
--tabs-color-underline: rgb(207, 236, 238);
6+
--tabs-size-label: 1rem;
7+
}

docs/_sources/changelog.rst.txt

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Change Log
2+
==========
3+
4+
.. include:: ../../changelog.rst

docs/_sources/citation.rst.txt

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
.. currentmodule:: smartpy
2+
.. default-role:: obj
3+
4+
Citation
5+
========
6+
7+
Software
8+
--------
9+
10+
If you are using `smartpy`, please consider citing the software as follows
11+
(click on the link to get the DOI of a specific version and year):
12+
13+
.. pull-quote::
14+
15+
Hallouin, T., Mockler, E., Bruen, M. (XXXX).
16+
SMARTpy: An implementation if the rainfall-runoff model in Python (Version X.X.X).
17+
*Zenodo*.
18+
`<https://doi.org/10.5281/zenodo.2564041>`_
19+
20+
21+
Model
22+
-----
23+
24+
If you are using `smartpy`, please consider citing the original model
25+
description article:
26+
27+
.. pull-quote::
28+
29+
Mockler, E., O’Loughlin, F., and Bruen, M. (2016).
30+
Understanding hydrological flow paths in conceptual catchment models
31+
using uncertainty and sensitivity analysis.
32+
*Computers & Geosciences*, 90, 66–77.
33+
`<https://doi.org/10.1016/j.cageo.2015.08.015>`_

docs/_sources/index.rst.txt

+62
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
.. currentmodule:: smartpy
2+
.. default-role:: obj
3+
4+
.. include:: ../../README.rst
5+
6+
Documentation
7+
-------------
8+
9+
.. panels::
10+
:card: + intro-card text-center
11+
:column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
12+
13+
Learn how to get `smartpy`.
14+
15+
+++
16+
17+
.. link-button:: installation
18+
:type: ref
19+
:text: Installation
20+
:classes: btn-outline-primary btn-block stretched-link
21+
22+
---
23+
24+
Learn how to use `smartpy`.
25+
26+
+++
27+
28+
.. link-button:: tutorial
29+
:type: ref
30+
:text: Tutorial
31+
:classes: btn-outline-primary btn-block stretched-link
32+
33+
---
34+
35+
Learn more about SMART.
36+
37+
+++
38+
39+
.. link-button:: model_description
40+
:type: ref
41+
:text: Model Description
42+
:classes: btn-outline-primary btn-block stretched-link
43+
44+
45+
46+
Acknowledgment
47+
--------------
48+
49+
This model implementation was initially developed with the financial support of
50+
Ireland's Environmental Protection Agency (Grant Number 2014-W-LS-5).
51+
52+
.. toctree::
53+
:hidden:
54+
:maxdepth: 1
55+
56+
installation
57+
tutorial
58+
model_description
59+
citation
60+
support
61+
changelog
62+
licence

docs/_sources/installation.rst.txt

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
.. currentmodule:: smartpy
2+
.. default-role:: obj
3+
4+
Installation
5+
============
6+
7+
If you wish to install the most recent stable version of `smartpy`,
8+
it is available on the Python Package Index (PyPI), simply run:
9+
10+
.. code-block:: bash
11+
12+
pip install smartpy
13+
14+
If you need the latest, potentially unstable, features listed in the
15+
:doc:`change log <changelog>`, please use the *dev* branch on the
16+
GitHub repository:
17+
18+
.. code-block:: bash
19+
20+
pip install git+https://github.com/ThibHlln/smartpy.git@dev
21+
22+
23+
.. rubric:: Requirements
24+
25+
The following packages are required to use `smartpy`:
26+
27+
.. literalinclude:: ../../requirements.txt
28+
:language: none
29+
30+
.. rubric:: Optional dependency for input/output
31+
32+
`smartpy` is designed to read/write CSV (Comma-Separated Values) files
33+
and NetCDF (Network Common Data Form) input/output files. However, only
34+
CSV files can natively be read/written in Python.
35+
36+
To read/write NetCDF files, the `netCDF4` python package is required (specific
37+
pre-requisites prior the installation of `netCDF4` exist and can be found
38+
at `<http://unidata.github.io/netcdf4-python/>`_).
39+
40+
.. rubric:: Optional dependencies for Monte Carlo experiments
41+
42+
The module `smartpy.montecarlo` requires the `spotpy` Python package
43+
to perform the sampling required for Monte Carlo experiments
44+
(`<https://spotpy.readthedocs.io/>`_).
45+
46+
In addition, if this sampling is to be done in parallel, the `mpi4py`
47+
Python package is also required (`<https://mpi4py.readthedocs.io/>`_)
48+
49+
.. rubric:: Optional dependency for performance improvement
50+
51+
`smartpy` features a separate accelerator extension written in C++,
52+
`smartcpp` (`<https://github.com/ThibHlln/smartcpp>`_) that will be
53+
automatically used if it is installed alongside `smartpy`. Using
54+
`smartcpp` can significantly improve the execution time.

docs/_sources/licence.rst.txt

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Licence
2+
=======
3+
4+
.. include:: ../../LICENCE.rst

0 commit comments

Comments
 (0)