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

Add dataset attributes to the docs #2109

Merged
merged 3 commits into from
Jan 30, 2022
Merged

Conversation

akaszynski
Copy link
Member

As pointed out in #2097 (reply in thread) by @MatthewFlamm, we're missing documentation for pyvista.DataSetAttributes.

This PR add the documentation and fixes the class and method docstrings due to the various numpydoc validation warnings.

@github-actions github-actions bot added documentation Anything related to the documentation/website maintenance Low-impact maintenance activity labels Jan 30, 2022
@akaszynski akaszynski merged commit c9855ca into main Jan 30, 2022
@akaszynski akaszynski deleted the docs/add_datasetattr_docs branch January 30, 2022 02:10
Copy link
Member

@adeak adeak left a comment

Choose a reason for hiding this comment

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

Some remarks and things that would've been better fixed while we were touching these lines (admittedly with mistakes that were introduced earlier).

CODESPELL_SKIP ?= "*.pyc,*.txt,*.gif,*.png,*.jpg,*.ply,*.vtk,*.vti,*.vtu,*.js,*.html,*.doctree,*.ttf,*.woff,*.woff2,*.eot,*.mp4,*.inv,*.pickle,*.ipynb,flycheck*,./.git/*,./.hypothesis/*,*.yml,./doc/_build/_static/*,./doc/images/*,./dist/*,*~,.hypothesis*,./doc/examples/*,*.mypy_cache/*,*cover,./tests/tinypages/_build/*,*/_autosummary/*"
CODESPELL_SKIP ?= "*.pyc,*.txt,*.gif,*.png,*.jpg,*.ply,*.vtk,*.vti,*.vtu,*.js,*.html,*.doctree,*.ttf,*.woff,*.woff2,*.eot,*.mp4,*.inv,*.pickle,*.ipynb,flycheck*,./.git/*,./.hypothesis/*,*.yml,doc/_build/*,./doc/images/*,./dist/*,*~,.hypothesis*,./doc/examples/*,*.mypy_cache/*,*cover,./tests/tinypages/_build/*,*/_autosummary/*"
Copy link
Member

Choose a reason for hiding this comment

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

See ongoing discussion in #2108 (comment)... It would be better to have clear justification for these changes. And now we have a mixture of ./doc/.. and doc/... in there, which would again be nicer to unify.

Comment on lines +13 to +16
* Topology defines the structure of the dataset, or how the points are connected
to each other to form a cells making a surface or volume.
* Attributes are any data values that are associated to either the points or
cells of the dataset
Copy link
Member

Choose a reason for hiding this comment

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

There's "to form a cells making" typo, and a missing trailing period.

@@ -69,6 +69,15 @@ class DataSetAttributes(_vtk.VTKObjectWrapper):
association : FieldAssociation
The array association type of the vtkobject.

Notes
-----
When printing out the point arrays, you can see which arrays are
Copy link
Member

Choose a reason for hiding this comment

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

Point or cell arrays, right?

rotated along with the geometry when the DataSet is passed
through a transformation filter.

When adding non-directional data (such temperature values or
Copy link
Member

Choose a reason for hiding this comment

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

"such as temperature values"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Anything related to the documentation/website maintenance Low-impact maintenance activity
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants