libigl / libigl/libigl

Cross field singularity index violates Poincaré-Hopf theorem

Open
#2,526 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug pending verification
Dominant language
C++
Stars
5.1k
Forks
1.2k
Avg merge
7h 33m
Merged PRs (30d)
8

Description

Describe the bug

The singularity index computed via igl::find_cross_field_singularities is always positive, which leads to the violation of Poincaré-Hopf theorem (section 3.2 of [1]).

The original discussion and unit tests is from https://github.com/libigl/libigl-python-bindings/pull/295

Platform
  • Windows
  • macOS
  • Linux

[1] Vaxman, Amir, et al. "Directional field synthesis, design, and processing." Computer graphics forum. Vol. 35. No. 2. 2016.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the implementation of igl::find_cross_field_singularities and review the discussion and unit tests in libigl-python-bindings PR #295. Reproduce the reported all-positive indices on the relevant cross-field examples, then verify that the corrected signs satisfy the Poincaré-Hopf theorem and that regression tests cover the result.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
computer-graphics
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.