a robustly implemented Algorithm for Dirichlet energy of the normal
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images
utils
COPYING
README.md
ariaDNE.m
data.ply
data2.ply
example.m
pathSetup.m

README.md

ariaDNE: a robustly implemented algorithm for Dirichlet Energy of the Normal

DOI

teaser

DNE background: Dirichlet Normal Energy (DNE) quantifies local curvature in 3D surfaces; a discretized version for 3D meshes is effective for biological studies of morphological surfaces. For a continuous 2D manifold embedded in 3D, DNE is defined by,

continuous

where K1, K2 are the principal curvatures. The discrete version is defined by suming local curvature of each vertex across a surface mesh, weighted by the area distributed to that vertex,

discrete

Unlike other shape metrics, DNE is landmark-free and independent of the surface’s initial position, orientation and scale. However, recent studies found that the currently published implementation of DNE is sensitive to various surface preparation procedures, raising concerns regarding comparability and objectivity of utilizing DNE in morphological research. This package provides a robustly implemented algorithm for DNE (ariaDNE).

ariaDNE algorithm: We leverage the observation that local curvature can be stably estimated via a weighted PCA approach. The procedure is outlined as follows:

  1. Apply a weighted PCA localized around the query point by means of the Gaussian kernel fucntion.
  2. Find the principal component that is cloest to the vertex normal, and estimate the local curvature by its principal score curvature
  3. Summing the local curvature across the mesh and obtain the glocal DNE.

For the exact procedure, see this document (pdf).

Code: The function 'ariaDNE.m' computes ariaDNE of a mesh surface.

Demos: This package includes a demo for computing ariaDNE on a 3D mesh representing a second mandibular tooth from Callicebus. Download the package and run example.m in Matlab.

Compatibility and dependencies:

  • Developed and tested with Matlab 2017b on Mac and Linux.

Disclaimer: The code is for acadmic use only. Please contact the author Shan Shan for any questions or bugs.

License: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.