forked from driftingtides/hyvr
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
updates on preliminary documentation - usage
- Loading branch information
1 parent
19d5b66
commit b154af7
Showing
26 changed files
with
1,611 additions
and
24 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,114 @@ | ||
Metadata-Version: 2.1 | ||
Name: HyVR-fork | ||
Version: 0.1.0b0 | ||
Summary: sedimentary structures virtual reality generator | ||
Author: Jeremy Bennet | ||
Maintainer: Vitor Cantarella | ||
Project-URL: homepage, https://github.com/vcantarella/hyvr | ||
Project-URL: repository, https://github.com/vcantarella/hyvr | ||
Project-URL: documentation, in construction | ||
Keywords: hydrogeology,sediment,simulator | ||
Classifier: Development Status :: 1 - Planning | ||
Classifier: Intended Audience :: Science/Research | ||
Classifier: License :: OSI Approved :: MIT License | ||
Classifier: Opeating System:: POSIX :: Linux | ||
Classifier: Programming Language :: Python 3 | ||
Requires-Python: >=3.10 | ||
Description-Content-Type: text/x-rst | ||
License-File: LICENCE | ||
Requires-Dist: numpy | ||
Requires-Dist: scipy | ||
Requires-Dist: numba | ||
Provides-Extra: ci | ||
Requires-Dist: pytest>=4.6; extra == "ci" | ||
Requires-Dist: coverage; extra == "ci" | ||
Requires-Dist: flake8; extra == "ci" | ||
Provides-Extra: docs | ||
Requires-Dist: hyvr[ci]; extra == "docs" | ||
Requires-Dist: sphinx; extra == "docs" | ||
Requires-Dist: sphinx-design; extra == "docs" | ||
Requires-Dist: pydata-sphinx-theme; extra == "docs" | ||
Requires-Dist: numpydoc; extra == "docs" | ||
Requires-Dist: myst_nb; extra == "docs" | ||
|
||
==================================================================== | ||
Introduction | ||
==================================================================== | ||
|
||
**HyVR** | ||
|
||
This is a fork from the original HyVR package with minimal implementation of | ||
the core features the idea to keep the original ideas alive, | ||
but maintainable in the fast python development ecosystem. | ||
Thus, most of the non-essencial functionality, that is nowadays done much better in other packages, | ||
has been dropped. The functionality is now focus on the creation of geobodies to grids. | ||
|
||
Eveything that could be done before is still doable, and more. But the user should understand a bit more about | ||
operating on arrays and using python. | ||
|
||
|
||
The Hydrogeological Virtual Reality simulation package (HyVR) is a Python module | ||
that helps researchers and practitioners generate sedimentary subsurface models with | ||
multiple scales of heterogeneity that are based on geological concepts. The | ||
simulation outputs can then be used to explore groundwater flow and solute | ||
transport behaviour, for example. The user must work with a previously created regular grid, which | ||
can be used directly in MODFLOW or interpolated to the simulation grid that the user will need. | ||
|
||
The original motivation for HyVR was the lack of tools for modelling sedimentary | ||
deposits that include bedding structure model outputs (i.e., dip and azimuth). | ||
Such bedding parameters were required to approximate full hydraulic-conductivity | ||
tensors for groundwater flow modelling. HyVR is able to simulate these bedding | ||
parameters and generate spatially distributed parameter fields, including full | ||
hydraulic-conductivity tensors. A documentation on the simplified HyVR is being built in: *TO BE ADDED* | ||
The original HyVR information is available in the online `technical documentation <https://driftingtides.github.io/hyvr/index.html>`_. | ||
|
||
For citation of the original software and development, please use the following reference: | ||
|
||
*HyVR can be attributed by citing the following journal article: Bennett, J. P., | ||
Haslauer, C. P., Ross, M., & Cirpka, O. A. (2018). An open, object-based | ||
framework for generating anisotropy in sedimentary subsurface | ||
models. Groundwater. | ||
DOI:* `10.1111/gwat.12803 <https://onlinelibrary.wiley.com/doi/abs/10.1111/gwat.12803>`_. | ||
*A preprint version of the article is available* `here <https://github.com/driftingtides/hyvr/blob/master/docs/Bennett_GW_2018.pdf>`_. | ||
|
||
Installing the HyVR package | ||
-------------------------------------- | ||
|
||
Installing HyVR | ||
^^^^^^^^^^^^^^^ | ||
|
||
The package should work whether you are using anaconda or another virtual environment. | ||
Your working environment should have updated installations of the following libraries: | ||
|
||
-numpy | ||
-numba | ||
-scipy | ||
|
||
Once you have activated your virtual environment, you can install HyVR | ||
using ``pip``. First git clone the repository, | ||
navigate to the root directory and type:: | ||
|
||
pip install . | ||
|
||
Alternatively, you can use the package without installing it by typing in your script:: | ||
|
||
sys.path.append("path where HyVR is") | ||
|
||
Usage | ||
----- | ||
|
||
See the documentation and the examples folder for usage. | ||
|
||
Development | ||
----------- | ||
|
||
The orgininal HyVR has been developed by Jeremy Bennett (`website <https://jeremypaulbennett.weebly.com>`_) | ||
as part of his doctoral research at the University of Tübingen and by Samuel | ||
Scherrer as a student assistant. | ||
|
||
The current version is maintained by Vitor Cantarella (`website <https://vcantarella.gitub.io>`_) | ||
|
||
Problems, Bugs, Unclear Documentation | ||
------------------------------------- | ||
|
||
please use the Issues page for bugs. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
LICENCE | ||
README.rst | ||
pyproject.toml | ||
HyVR_fork.egg-info/PKG-INFO | ||
HyVR_fork.egg-info/SOURCES.txt | ||
HyVR_fork.egg-info/dependency_links.txt | ||
HyVR_fork.egg-info/requires.txt | ||
HyVR_fork.egg-info/top_level.txt | ||
hyvr/__init__.py | ||
hyvr/tools.py | ||
hyvr/utils.py | ||
tests/test_volume.py |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
numpy | ||
scipy | ||
numba | ||
|
||
[ci] | ||
pytest>=4.6 | ||
coverage | ||
flake8 | ||
|
||
[docs] | ||
hyvr[ci] | ||
sphinx | ||
sphinx-design | ||
pydata-sphinx-theme | ||
numpydoc | ||
myst_nb |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
hyvr |
Oops, something went wrong.