-
Notifications
You must be signed in to change notification settings - Fork 471
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
Improved documentation of Mesh::MakePeriodic() #4302
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Guess it's better than nothing.
I would also add some notes to the documentation on the web page
https://mfem.org/howto/periodic-boundaries/
That would be nice as well 😉 , but we need a separate PR for that in the corresponding repo... |
Ok, the note in the HowTo is done in mfem/web#264 😉. |
This PR is now under review (see the table in the PR description). To help with the review process, please do not force push to the branch. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good, thanks @najlkin!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Your addition looks good. However, I would take this opportunity to change the word "connected" to "separated". I think this would be more accurate. Technically the two sides of the mesh don't need to be connected at all.
I think what is meant is that the periodic mesh has such connectivity (or "edges") that the end node is connected to the first node (along the direction of periodicity), so there cannot be two edges between the same nodes. Therefore, there must be at least three nodes and two edges going forward and one looping backward. The doc string does not really help much to understand this, but I do not know how to formulate it in a concise and clear way and replacing "connected" by "separated" makes it maybe even more unclear in my head 🤔 Maybe how about saying that "periodic boundaries must be separated by at least two interior nodes"? |
Is it ok like this, @mlstowell ? 🙂 (I just used "vertices" instead of "nodes" to make it less ambiguous) |
Yes, @najlkin, that sounds better. Thank you for making that change. |
Merged in |
This PR reacts on #4299 and adds a note about usage of a nodal function to
Mesh::MakePeriodic()
.PR Checklist
make style
.CHANGELOG
:CHANGELOG
to group with other related features?INSTALL
:make
orcmake
have a new target?.github
.appveyor.yml
.gitignore
:make distclean; git status
shows any files that were generated from the source by the project (not an IDE) but we don't want to track in the repository.examples/makefile
:SEQ_EXAMPLES
andPAR_EXAMPLES
variables.clean
target..gitignore
file.examples/CMakeLists.txt
:ALL_EXE_SRCS
variable.THIS_TEST_OPTIONS
is set correctly for the new example.doc/CodeDocumentation.dox
.examples/pumi
), list it indoc/CodeDocumentation.conf.in
src/examples.md
.src/examples.md
andsrc/img
.examples.md
, list the example under the appropriate categories, add new categories if necessary.features.md
.makefile
andmakefile
in corresponding miniapp directory..gitignore
file.CMakeLists.txt
file in theminiapps
directory, if the new miniapp is in a new directory.CMakeLists.txt
file in the new miniapp directory.doc/CodeDocumentation.dox
miniapps/nurbs
), add it toMINIAPP_SUBDIRS
in themakefile
.miniapps/nurbs
), list it indoc/CodeDocumentation.conf.in
src/meshing.md
andsrc/electromagnetics.md
files.src/examples.md
andsrc/img
.features.md
.mfem/web
repo.README
(rare).doc/CodeDocumentation.dox
(rare).make unittest
to make sure all unit tests pass.tests/scripts
.