icosphere

Constructs geodesic icosahedron given subdivision frequency.

https://github.com/vedranaa/icosphere

Science Score: 46.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: ieee.org
  • Committers with academic emails
    1 of 2 committers (50.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.7%) to scientific vocabulary
Last synced: 7 months ago · JSON representation

Repository

Constructs geodesic icosahedron given subdivision frequency.

Basic Info
  • Host: GitHub
  • Owner: vedranaa
  • License: lgpl-2.1
  • Language: Jupyter Notebook
  • Default Branch: main
  • Homepage:
  • Size: 4.34 MB
Statistics
  • Stars: 24
  • Watchers: 1
  • Forks: 3
  • Open Issues: 5
  • Releases: 0
Created about 5 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

Geodesic icosahedron

Creating geodesic icosahedron given subdivision frequency.

Installation

Install the module using pip install icosphere or clone the repository.

Use

python from icosphere import icosphere nu = 5 # or any other integer vertices, faces = icosphere(nu)

Examples

Check the examples in icosphere github, python script uses matplotlib for visualization, and one of jupyter notebooks uses plotly. You can also open the notebooks in colab: Open In Colab - with ploty, Open In Colab - with matplotlib.

Why use subdivision frequency?

For a certain subdivision frequency nu, each edge of the icosahedron will be split into nu segments, and each face will be split into nu**2 faces. This is different than a more common approach which recursively applies a subdivision with nu = 2, for example as used in pytorch3d ico_sphere, pymeshlab sphere, trimesh icosphere, and PyMesh generate_icosphere.

The advantage of using the subdivision frequency, compared to the recursive subdivision, is in controlling the mesh resolution. Mesh resolution grows quadratically with subdivision frequencies while it grows exponentially with iterations of the recursive subdivision. To be precise, using the recursive subdivision, the number of vertices and faces in the resulting icosphere grows with iterations iter as nr_vertex = 12 + 10 * (4**iter -1) and nr_face = 10 * 4**iter which gives a sequence of mesh vertices

12, 42, 162, 642, 2562, 10242, 40962, 163842, 655362, 2621442, 10485762...

Notice for example there is no mesh having between 2562 and 10242 vertices. Using subdivision frequency, the number of vertices and faces grows with nu as Notice for example there is no mesh having between 2562 and 10242 vertices. Using subdivision frequency, the number of vertices and faces grows with nu as nr_vertex = 12 + 10 * (nu**2 -1) and nr_face = 20 * nu**2 which gives a sequence of mesh vertices

 12, 42, 92, 162, 252, 362, 492, 642, 812, 1002, 1212, 1442, 1692, 1962,
 2252, 2562, 2892, 3242, 3612, 4002, 4412, 4842, 5292, 5762, 6252, 6762,
 7292, 7842, 8412, 9002, 9612, 10242...

Now there is 15 meshes having between 2562 and 10242 vertices. The advantage is even more pronounced when using higher resolutions.

The code was originally developed for this work.

Reference this work

Dahl, V. A., Dahl, A. B., & Larsen, R. (2014). Surface Detection Using Round Cut. 2014 2nd International Conference on 3D Vision. https://doi.org/10.1109/3dv.2014.60

bibtex @inproceedings{Dahl_2014, doi = {10.1109/3dv.2014.60}, url = {https://doi.org/10.1109%2F3dv.2014.60}, year = 2014, month = {dec}, publisher = {{IEEE}}, author = {Vedrana A. Dahl and Anders B. Dahl and Rasmus Larsen}, title = {Surface Detection Using Round Cut}, booktitle = {2014 2nd International Conference on 3D Vision} }

Owner

  • Name: Vedrana Andersen Dahl
  • Login: vedranaa
  • Kind: user
  • Location: Denmark
  • Company: DTU, Technical University of Denmark

Associate Professor at DTU Compute

GitHub Events

Total
  • Watch event: 1
  • Fork event: 1
Last Year
  • Watch event: 1
  • Fork event: 1

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 78
  • Total Committers: 2
  • Avg Commits per committer: 39.0
  • Development Distribution Score (DDS): 0.141
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Vedrana Andersen Dahl v****a@g****m 67
Vedrana v****d@d****k 11
Committer Domains (Top 20 + Academic)
dtu.dk: 1

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 4
  • Total pull requests: 3
  • Average time to close issues: 5 months
  • Average time to close pull requests: N/A
  • Total issue authors: 4
  • Total pull request authors: 2
  • Average comments per issue: 0.75
  • Average comments per pull request: 1.67
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • jacobbieker (1)
  • tomfrankkirk (1)
  • plopidou (1)
  • gangyilisdu (1)
Pull Request Authors
  • akx (2)
  • tomfrankkirk (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,332 last-month
  • Total dependent packages: 2
  • Total dependent repositories: 2
  • Total versions: 4
  • Total maintainers: 1
pypi.org: icosphere

Constructs geodesic icosahedron given subdivision frequency.

  • Versions: 4
  • Dependent Packages: 2
  • Dependent Repositories: 2
  • Downloads: 2,332 Last month
Rankings
Dependent packages count: 3.1%
Downloads: 10.4%
Dependent repos count: 11.6%
Average: 11.8%
Stargazers count: 14.8%
Forks count: 19.1%
Maintainers (1)
Last synced: 8 months ago

Dependencies

setup.py pypi