{"id":13574796,"url":"https://github.com/alecjacobson/gptoolbox","last_synced_at":"2025-05-15T03:07:23.469Z","repository":{"id":14347781,"uuid":"17057368","full_name":"alecjacobson/gptoolbox","owner":"alecjacobson","description":"Matlab toolbox for Geometry Processing.","archived":false,"fork":false,"pushed_at":"2025-04-11T00:21:45.000Z","size":29340,"stargazers_count":643,"open_issues_count":70,"forks_count":171,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-04-14T03:08:57.643Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"MATLAB","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alecjacobson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-02-21T13:46:13.000Z","updated_at":"2025-04-11T00:21:51.000Z","dependencies_parsed_at":"2023-12-18T21:05:21.138Z","dependency_job_id":"78678cc3-721a-49d4-b9ce-a912646aa56f","html_url":"https://github.com/alecjacobson/gptoolbox","commit_stats":{"total_commits":1448,"total_committers":31,"mean_commits":46.70967741935484,"dds":"0.14019337016574585","last_synced_commit":"53443c5a6e5f57557aea6e28386e420f3c35a2bf"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alecjacobson%2Fgptoolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alecjacobson%2Fgptoolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alecjacobson%2Fgptoolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alecjacobson%2Fgptoolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alecjacobson","download_url":"https://codeload.github.com/alecjacobson/gptoolbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264766,"owners_count":22041793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T15:00:54.764Z","updated_at":"2025-05-15T03:07:18.342Z","avatar_url":"https://github.com/alecjacobson.png","language":"MATLAB","funding_links":[],"categories":["Table of Contents","General Libraries","Subject-Specific Modelling"],"sub_categories":["Mathematics and Science","Manipulation, Processing and Comparison of Surface Meshes"],"readme":"# gptoolbox - Geometry Processing Toolbox\n\n![](images/gptoolbox-bounce.gif)\n\n[![Build Status](https://travis-ci.org/alecjacobson/gptoolbox.svg?branch=master)](https://travis-ci.org/alecjacobson/gptoolbox)\n\n\u003chttps://github.com/alecjacobson/gptoolbox/\u003e\n\nThis is a toolbox of useful matlab functions for geometry processing. There are\nalso tools related to constrainted optimization and image processing. Typically\nthese are utility functions that are not stand alone applications.\n\nHere's an incomplete list of cool features this matlab toolbox contains:\n\n- wrappers for TetGen, Triangle, QSlim, meshfix\n- mesh smoothing\n- mesh clean up (remove duplicates, remove unreferenced)\n- geodesic distances on triangle and tetrahedral meshes\n- mesh quantities and queries (normals, discrete gaussian curvature, list\n  boundary edges, topology, angles, dihedral angles etc.)\n- mesh deformation (as-rigid-as-possible (ARAP), moving least-squares, etc.)\n- mesh parameterization (harmonic, least squares conformal, ARAP, etc.)\n- automatic skinning weight computation (bounded biharmonic weights, bone heat)\n- 2D triangle mesh from binary image\n- Input/Output for many mesh formats\n  (.obj,.off,.stl,.wrl,.ply,.mesh,.node,.ele,.poly,.smf,.bdl,.face)\n- discrete differential geometry operators for triangle and tetrahedral meshes\n  (cotangent Laplacian, gradient, divergence)\n- quadratic programming, active set solver\n- scribble-based image colorization, diffusion curves\n- exact (un)signed distance field computation for meshes\n- constructive solid geometry operations on meshes, booleans\n- accelerated point location in triangle and tetrahedral meshes\n- image dithering\n- deep matlab function dependency\n\nThe functions have been organized into folders based on their primary\napplication:\n\n- external/\n- imageprocessing/\n- images/\n- matrix/\n- mesh/\n- mex/\n- utility/\n- wrappers/\n\n## Installation ##\nThe vast majority of this code is __straight MATLAB__ (`*.m` files). Thus, only\ninstalling MATLAB and adding the qptoolbox directory and its subdirectories to\nyour MATLAB path is needed for installation. Let's assume you cloned gptoolbox\nat `/Users/ajx/Repos/gptoolbox/`, then you could issue:\n\n    addpath(strjoin(strcat(['/Users/ajx/Repos/gptoolbox/'],{'external','imageprocessing', 'images', 'matrix', 'mesh', 'mex', 'quat','utility','wrappers'}),':'))\n\nTo make this change permanent, then issue:\n\n    savepath\n\nThere are some mex files, whose documentation for installation are included in\nrespective [mex/README.md](mex/README.md) file.\n\n### Full installation ###\n\nThis strives to be full installation instructions, but will no doubt remain\nincomplete for some time. Begin by adding paths as above. \n\nAs stated above, most files are straight matlab and will _just run_ if you have\ngptoolbox in your path.\n\n#### Compile `/mex` ####\n\nMost of our mex files will depend on [libigl](https://github.com/libigl/libigl).\nSome depend on [cgal](https://github.com/CGAL/cgal) and\n[embree](https://github.com/embree/embree). We recently switched to a\ncmake-based build.\n\nSee [mex/README.md](mex/README.md) for details.\n\n#### Compile `external/toolbox_fast_marching/` ####\n\nIn MATLAB issue:\n\n    cd external/toolbox_fast_marching/\n    compile_mex\n\n## Dependencies ##\n\ngptoolbox depends on MATLAB and some of its toolbox extensions. Many functions\nshould also work with Octave, though this has not been tested.\n\nFunctions that rely on `quadprog` have been tested and optimized assuming that\nthe Mosek toolbox has been installed, but should also work with the `quadprog`\nin MATLAB's Optimization Toolbox.\n\nMex files may have other external dependencies (e.g. CGAL, Eigen, libigl). See\ntheir respective READMEs for more information. When installing mex libraries,\nyou may need to modify the files in `wrappers/` (such as `path_to_libigl.m`) so\n`gptoolbox` knows where to look.\n\n## Attribution\n\nIf you use gptoolbox in your academic projects, please cite the papers we\nimplement as appropriate. To cite the library in general, you could use this\nBibTeX entry:\n\n```bibtex\n@misc{gptoolbox,\n  title = {{gptoolbox}: Geometry Processing Toolbox},\n  author = {Alec Jacobson and others},\n  note = {http://github.com/alecjacobson/gptoolbox},\n  year = {2024},\n}\n```\n\n## License ##\n\nThis work is dual licensed under MIT and Apache 2.\n\nPlease take extra note that the `external/` directory contains code from\nelsewhere with potentially more restricted licenses. \n\nMost of the `mex/` directory includes libigl and Eigen (and some include CGAL),\neach with their own licenses.\n\n## Contact ##\n\nThe Geometry Processing Toolbox grew out of Alec Jacobson's private codebase\nduring his PhD, but has benefited a lot from various collaborators at NYU, ETH\nZurich, Columbia, University of Toronto and elsewhere. Now, the Geometry\nProcessing Toolbox is a group endeavour. If you're intersted in contributing,\nplease contact Alec Jacobson (alecjacobson@gmail.com) or submit a pull request\non github.\n\n## Documentation ##\n\nFor now, documentation is limited to a per-function basis. For example, to find\ndocumentation for `cotmatrix`, in MATLAB issue:\n\n    help cotmatrix\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falecjacobson%2Fgptoolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falecjacobson%2Fgptoolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falecjacobson%2Fgptoolbox/lists"}