Skip to content

Add a Mimetic Operator Vs Finite Difference tutorial with a step-by-step explanations and comparisons #143

Open

Description

@valeriabarra

Is your feature request related to a problem? Please describe.
We need a simple step-by-step tutorial that showcases the mimetic properties as opposed to other familiar discretization methods that people with an entry-level knowledge (e.g., students) can grasp, such as Finite Differences (FD). Something that shows when the mimetic discretization is better than the other.

Describe the solution you'd like

Can we find a discerning test case that showcases that this method is really superior? For instance could we provide an example in which being just high-order FD, but not mimetic, makes the difference? And then compare the same example using the MOLE operators?

After this, we could add an efficiency-focused benchmark to report on the MOLE operators efficiency. It would be useful to have benchmarks in this regard for new users/application developers that approach the library.

Describe alternatives you've considered
An alternative could be comparing a MOLE example with a high-order FEM/SEM example from another package, e.g., libCEED.

Additional context
Some of the suggestions came up from the ICorps interviewees.

cc: @jbrzensk , I think you gave a sort of similar tutorial at the beginning of the academic year for the master students working in the project. Can we re-use part of that and make it a tutorial in our documentation?

Activity

  1. added
    DocumentationImprovements or additions to documentation
    ExamplesAddition or improvement of examples that showcase the main functionality of the library
    on May 30, 2025
  2. added
    staleNo recent activity; scheduled for automatic closure.
    on May 23, 2026
  3. github-actions commented on May 23, 2026

    @github-actions

    Thanks for the discussion and work here. This issue has had no activity for 28 days, so it is now marked stale. If there is no further activity, it will be closed in 42 days.

  4. github-actions commented on Jul 4, 2026

    @github-actions

    Closing because this issue stayed stale for 42 days with no activity. If this is still needed, please reopen it or open a new issue with updated context.

  5. valeriabarra commented on Jul 4, 2026

    @valeriabarra
    CollaboratorAuthor

    Issue only partially complete (missing BC)

  6. removed
    staleNo recent activity; scheduled for automatic closure.
    on Jul 5, 2026
  7. github-actions commented on Jul 19, 2026

    @github-actions

    This issue has had no activity for 14 days. It will be marked stale in 14 days if there is no further activity.

  8. added
    staleNo recent activity; scheduled for automatic closure.
    on Aug 2, 2026
  9. github-actions commented on Aug 2, 2026

    @github-actions

    Thanks for the discussion and work here. This issue has had no activity for 28 days, so it is now marked stale. If there is no further activity, it will be closed in 42 days.

  10. github-actions commented on Sep 13, 2026

    @github-actions

    Closing because this issue stayed stale for 42 days with no activity. If this is still needed, please reopen it or open a new issue with updated context.

  11. removed
    staleNo recent activity; scheduled for automatic closure.
    on Sep 14, 2026
  12. github-actions commented on Sep 28, 2026

    @github-actions

    This issue has had no activity for 15 days. It will be marked stale in 13 days if there is no further activity.

  13. valeriabarra commented on Sep 28, 2026

    @valeriabarra
    CollaboratorAuthor

    keep-open

  14. github-actions commented on Oct 12, 2026

    @github-actions

    This issue has had no activity for 14 days. It will be marked stale in 14 days if there is no further activity.

  15. valeriabarra commented on Oct 12, 2026

    @valeriabarra
    CollaboratorAuthor

    keep-open

  16. github-actions commented on Oct 27, 2026

    @github-actions

    This issue has had no activity for 14 days. It will be marked stale in 14 days if there is no further activity.

  17. valeriabarra commented on Oct 27, 2026

    @valeriabarra
    CollaboratorAuthor

    PR #502 will finally close this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocumentationImprovements or additions to documentationExamplesAddition or improvement of examples that showcase the main functionality of the library

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions