Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Examples / RTFD update #69

Merged
merged 33 commits into from
Jan 27, 2020
Merged

Examples / RTFD update #69

merged 33 commits into from
Jan 27, 2020

Conversation

MuellerSeb
Copy link
Member

@MuellerSeb MuellerSeb commented Jan 25, 2020

With this PR the following stuff is proposed:

  • reworked all examples to be up to date
  • sphinx autosummary now creates single pages for every covariance model
  • better documentation for "correlation" and "normalized" correlation function
  • a cor method is now automatically added to every cov-model
  • added some missing vtk routines to the __init__.py, solving Routines missing in documentation #47
  • some corrected relative imports in the covmodel submodule to make use of autosummary

Question

Should we use the autosummary elsewhere in the documentation?

  • Yeah we should!
  • No!

@MuellerSeb MuellerSeb added enhancement New feature or request Refactoring Code-Refactoring needed here Documentation labels Jan 25, 2020
@MuellerSeb MuellerSeb added this to the 1.2 milestone Jan 25, 2020
@MuellerSeb MuellerSeb requested a review from LSchueler January 25, 2020 04:22
@MuellerSeb
Copy link
Member Author

You can have a look at the resulting documentation here:
https://geostat-framework.readthedocs.io/projects/gstools/en/examples_update

Copy link
Member Author

@MuellerSeb MuellerSeb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am fine with it.

docs/source/_templates/autosummary/class.rst Show resolved Hide resolved
@MuellerSeb MuellerSeb changed the title Examples update Examples / RTFD update Jan 26, 2020
Copy link
Member Author

@MuellerSeb MuellerSeb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are still some unused matplotlib imports.

README.md Outdated Show resolved Hide resolved
docs/source/index.rst Outdated Show resolved Hide resolved
Copy link
Member

@LSchueler LSchueler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great stuff!

Just a few minor things:
In the plot from the CovModel additional parameters example, the orange curve looks a bit jaggy, maybe the standard resolution of the CovModel curves could be increased a bit.

What about the namespace of the MasterRNG? - But this might be the topic of another PR.

@@ -46,6 +46,7 @@


from gstools.random import MasterRNG
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

import gstools as gs?

@@ -7,30 +7,25 @@
then create a random field at those coordinates.
"""
import numpy as np
import matplotlib.pyplot as pt
from gstools import SRF, Exponential
from gstools.random import MasterRNG
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should MasterRNG actually be in the gstools namespace? - Not so much going on in gstools.random and MasterRNG is self-explanatory enough to not confuse people.

pt.axes().set_aspect('equal')
pt.show()
ax.tricontourf(x2, y2, field2.T)
ax.set_aspect("equal")

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

show() this stuff

Copy link
Member Author

@MuellerSeb MuellerSeb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good

@LSchueler LSchueler merged commit fabd89e into develop Jan 27, 2020
@MuellerSeb MuellerSeb deleted the examples_update branch February 8, 2020 15:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation enhancement New feature or request Refactoring Code-Refactoring needed here
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants