pmp-library

The Polygon Mesh Processing Library

https://github.com/pmp-library/pmp-library

Science Score: 77.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    3 of 20 committers (15.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.4%) to scientific vocabulary

Keywords

c-plus-plus curvature geodesic-distances geometry-processing hole-filling-algorithm mesh-processing mesh-simplification parameterization polygon-mesh remeshing smoothing subdivision surface-mesh triangle-mesh triangulation
Last synced: 4 months ago · JSON representation ·

Repository

The Polygon Mesh Processing Library

Basic Info
Statistics
  • Stars: 1,403
  • Watchers: 35
  • Forks: 188
  • Open Issues: 17
  • Releases: 7
Topics
c-plus-plus curvature geodesic-distances geometry-processing hole-filling-algorithm mesh-processing mesh-simplification parameterization polygon-mesh remeshing smoothing subdivision surface-mesh triangle-mesh triangulation
Created over 8 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation

README.md

Introduction

build Coverage Status Latest Release DOI

The Polygon Mesh Processing Library is a modern C++ open-source library for processing and visualizing polygon surface meshes. Its main features are:

  • An efficient and easy-to-use mesh data structure
  • Standard algorithms such as decimation, remeshing, subdivision, or smoothing
  • Ready-to-use visualization tools
  • Seamless cross-compilation to JavaScript (demo)

Get Started

Clone the repository:

sh git clone https://github.com/pmp-library/pmp-library.git

Configure and build:

sh cd pmp-library && mkdir build && cd build && cmake .. && make

Run the mesh processing app:

sh ./mpview ../data/off/bunny.off

Build your own tool:

```cpp

include

include

int main() { pmp::SurfaceMesh mesh; pmp::read(mesh,"input.obj"); // .. do awesome things with your mesh pmp::write(mesh,"output.obj"); } ```

Read the Docs

The user guide contains all you need to get started using PMP, including a tutorial covering mesh processing basics.

Contribute

Contributions to PMP are welcome! There are many ways you can help: Report any issues you find, help to improve the documentation, join our discussions forum, or contribute new code.

Acknowledge

If you are using PMP for research projects, please acknowledge its use by referencing

tex @software{pmp23, author = {Sieger, Daniel and Botsch, Mario}, title = {{The Polygon Mesh Processing Library}}, year = {2023}, month = aug, version = {3.0.0}, doi = {10.5281/zenodo.10866532}, url = {https://github.com/pmp-library/pmp-library} }

We acknowledge that PMP evolved from our previous work on Surface_mesh and OpenMesh.

License

PMP is provided under a simple and flexible MIT-style license allowing for both open-source and commercial usage.

Owner

  • Name: pmp-library
  • Login: pmp-library
  • Kind: organization

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: "Sieger"
    given-names: "Daniel"
    orcid: "https://orcid.org/0000-0001-9504-7909"
  - family-names: "Botsch"
    given-names: "Mario"
    orcid: "https://orcid.org/0000-0001-9954-120X"
title: "The Polygon Mesh Processing Library"
version: 3.0.0
doi: 10.5281/zenodo.10866532
date-released: 2023-08-24
url: "https://github.com/pmp-library/pmp-library"

GitHub Events

Total
  • Issues event: 15
  • Watch event: 104
  • Issue comment event: 25
  • Push event: 94
  • Pull request review event: 1
  • Pull request review comment event: 1
  • Pull request event: 15
  • Fork event: 20
Last Year
  • Issues event: 15
  • Watch event: 104
  • Issue comment event: 25
  • Push event: 94
  • Pull request review event: 1
  • Pull request review comment event: 1
  • Pull request event: 15
  • Fork event: 20

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 1,800
  • Total Committers: 20
  • Avg Commits per committer: 90.0
  • Development Distribution Score (DDS): 0.197
Past Year
  • Commits: 74
  • Committers: 6
  • Avg Commits per committer: 12.333
  • Development Distribution Score (DDS): 0.419
Top Committers
Name Email Commits
Daniel Sieger d****r@p****e 1,445
Mario Botsch b****h@t****e 227
Mario Botsch m****h@t****e 98
Timo Menzel t****l@t****e 5
grassofsky g****y@1****m 5
Paul Du d****6@g****m 3
Andreas Fabri a****i@g****m 2
Fabien Péan f****n@p****o 2
Stephan Wenninger 7****r 2
Andrew Magill A****l 1
Chris c****5@g****m 1
DominicBeerAlloyed 1****d 1
François Revol r****l@f****r 1
Jonatan Wallmander j****n@v****m 1
João Baptista de Paula e Silva j****a@y****r 1
Matthias Dörfelt hi@m****e 1
Mohamed El Shorbagy 5****x 1
Nicolas Ulrich n****u@g****m 1
Stephan Wenninger 7****1 1
Sébastien Loriot s****t@c****g 1

Issues and Pull Requests

Last synced: 5 months ago

All Time
  • Total issues: 152
  • Total pull requests: 67
  • Average time to close issues: about 2 months
  • Average time to close pull requests: about 1 month
  • Total issue authors: 79
  • Total pull request authors: 27
  • Average comments per issue: 2.14
  • Average comments per pull request: 1.61
  • Merged pull requests: 40
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 10
  • Pull requests: 20
  • Average time to close issues: 14 days
  • Average time to close pull requests: about 1 month
  • Issue authors: 9
  • Pull request authors: 7
  • Average comments per issue: 1.2
  • Average comments per pull request: 0.7
  • Merged pull requests: 8
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • dsieger (15)
  • petrasvestartas (8)
  • cdcseacave (7)
  • XuRongYan (4)
  • ramcdona (4)
  • thovide (4)
  • j8asic (4)
  • breakerrorchen (4)
  • stephan-wenninger (4)
  • jtorresfabra (3)
  • f-brinkmann (3)
  • ghost (3)
  • mariuszhermansdorfer (3)
  • mokafolio (3)
  • licheng0794 (2)
Pull Request Authors
  • dsieger (10)
  • DominicBeerAlloyed (7)
  • grassofsky (5)
  • stephan-wenninger (5)
  • PJK136 (5)
  • Giacogiak (4)
  • TresSims (4)
  • Roy-KC (4)
  • mbotsch (3)
  • FabienPean (2)
  • cedarz (2)
  • menzelt (2)
  • mokafolio (2)
  • jaw (2)
  • xiconxi (2)
Top Labels
Issue Labels
enhancement (20) bug (6) docs (2) question (1)
Pull Request Labels

Dependencies

.github/workflows/build.yml actions
  • actions/checkout v3 composite
.github/workflows/coverage.yml actions
  • actions/checkout v3 composite
  • coverallsapp/github-action master composite
.github/workflows/docs.yml actions
  • actions/checkout v3 composite
  • peaceiris/actions-gh-pages v3 composite