{ "info": { "author": "fechbmaster", "author_email": "bernd.fecht1@hs-augsburg.de", "bugtrack_url": null, "classifiers": [], "description": "[![PyPI version](https://badge.fury.io/py/nirmapper.svg)](https://badge.fury.io/py/nirmapper)\n\n\n# 3DNIRmapper\n\n3DNIRMapper maps multiple textures with given camera parameters on a 3d-model using a z-buffer approach. It was originaly developed to map nearinfrared pictures on a 3d tooth model and was developed in proceedings of my master thesis.\n\nFor example with the given camera parameters it can map these two images to a 3d-modell...\n\n
\n\n[![preview](https://github.com/fechbmaster/3DNIRmapper/blob/master/nirmapper/resources/images/sample1.jpg)](#readme)\n[![preview](https://github.com/fechbmaster/3DNIRmapper/blob/master/nirmapper/resources/images/sample2.jpg)](#readme)\n\n
\n\n...by projecting them to the image area and resolving the overlapping parts as shown here:\n\n
\n\n[![preview](https://github.com/fechbmaster/3DNIRmapper/blob/master/nirmapper/resources/images/overlap.png)](#readme)\n\n\n
\n\n... and finally creates the combined textured 3d-modell:\n\n
\n\n[![preview](https://github.com/fechbmaster/3DNIRmapper/blob/master/nirmapper/resources/images/result.png)](#readme)\n\n
\n\nThe program is able to import wavefront objects and exports them to textured Collada files.\n\nThe package is on [pypi](https://pypi.org/project/nirmapper/)\nor can be cloned on [github](https://github.com/fechbmaster/3DNIRmapper).\n\n```\npip install nirmapper\n```\n\n## CLI Usage\n\nThe program comes with a cli, developed with Click. It contains two commands. \n\n### map\n\nThe first command maps textures to a 3d-model:\n```\nUsage: nirmapper map [OPTIONS] NAME MODEL_SRC TEXTURE_SRC DST\n\nOptions:\n --zfactor FLOAT The z factor defines how big the z-buffer should be\n for the visibility analysis. If results are bad put\n this up to 2 or 3. Be careful with values below zero\n because zfactor is multiplied with resolution of\n camera and must match aspect ratio of resolution.\n --thread / --unthread\n --help Show this message and exit.\n```\nwhere\n* NAME is the name of the model.\n* MODEL_SRC is the path to the model.\n* TEXTURE_SRC ist the path of the textures to map.\n* DST is the destination path.\n\nThe camera parameters must be provided for every picture to map in a XML-file in the TEXTURE_SRC that looks like this:\n\n```\n\n\n 35\n \n 1280\n 1024\n \n \n 32\n 25.6\n \n \n -1.2196\n 1.2096\n 9.8\n \n \n \n 0.715\n -0.169\n 0.082\n 0.674\n \n\n```\nIt can contain either euler or quaternion rotation although quaternions are highly recommended. For every texture to map there must be an .xml file with the same file name providing those parameters. An example can be found in nirmapper/resources/xmlExample/.\n\n### example\n\nThe second cli call creates a cube, tooth or elefant example:\n\n```\nUsage: nirmapper example [OPTIONS] DST\n\nOptions:\n --type [cube|tooth|elephant]\n --help Show this message and exit.\n\n```\nwhere:\n* DST is the destination path.\n\n## Code Usage\n\nTo use the implemented modules for own developments or improvement just include them to your project:\n\n```python\nimport nirmapper\n```\n\nFor example if you want to use on of the examples:\n\n```python\nfrom nirmapper.examples import generate_cube_example\n\ndst = '/tmp/Cube'\n\ngenerate_cube_example(dst)\n```\n\n## Tests\n\nAll tests can be found in the `tests` directory. To run the tests:\n\n```bash\n# Install pywavefront in develop mode\npython setup.py develop\n\n# Install required packages for running tests\npip install -r test-requirements.txt\n\n# Run all tests\npytest\n\n# Optionally specific tests modules can be runned sepeartely\npytest tests/test_parser.py\n```\n\nLicense\n-------\n\n3DNIRMapper is [Apache-licensed](https://github.com/fechbmaster/3DNirmapper/LICENSE)", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fechbmaster/3DNIRmapper", "keywords": "", "license": "Apache-2.0", "maintainer": "", "maintainer_email": "", "name": "nirmapper", "package_url": "https://pypi.org/project/nirmapper/", "platform": "", "project_url": "https://pypi.org/project/nirmapper/", "project_urls": { "Homepage": "https://github.com/fechbmaster/3DNIRmapper" }, "release_url": "https://pypi.org/project/nirmapper/1.1.10/", "requires_dist": null, "requires_python": ">2.7", "summary": "Python library to map textures on a Wavefront .obj files.", "version": "1.1.10" }, "last_serial": 4922040, "releases": { "1.1.10": [ { "comment_text": "", "digests": { "md5": "27d87e1f690cfe381ab8e41e31db2c89", "sha256": "c360bdbbba90d3331f82f0f52db48cc3850bb50bb6158e0357fd5ea50e2944e3" }, "downloads": -1, "filename": "nirmapper-1.1.10.tar.gz", "has_sig": false, "md5_digest": "27d87e1f690cfe381ab8e41e31db2c89", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 20456227, "upload_time": "2019-03-10T17:11:17", "url": "https://files.pythonhosted.org/packages/62/84/284c6a21af2eb785fa95d862fdde43590a662c4e276389ea15dd4084a18a/nirmapper-1.1.10.tar.gz" } ], "1.1.6": [ { "comment_text": "", "digests": { "md5": "875dd629f0a14b113e87102376b2af86", "sha256": "10227fd3d2029389a93af95458de456f7f90b5cf111497031db4905e9a05e8a8" }, "downloads": -1, "filename": "nirmapper-1.1.6.tar.gz", "has_sig": false, "md5_digest": "875dd629f0a14b113e87102376b2af86", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 16025140, "upload_time": "2019-02-27T14:48:38", "url": "https://files.pythonhosted.org/packages/dc/a0/63ddc427c3d6b5b2049db65f3df1079cceea98f3380c57c119a9fb71d8d3/nirmapper-1.1.6.tar.gz" } ], "1.1.7": [ { "comment_text": "", "digests": { "md5": "d4d3865bf10d5fcf49969757ee880c6a", "sha256": "a87f87b192bbec60e0e06c427bfd53c47721ca6c691d13ea2a243be6f53e39a8" }, "downloads": -1, "filename": "nirmapper-1.1.7.tar.gz", "has_sig": false, "md5_digest": "d4d3865bf10d5fcf49969757ee880c6a", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 16025143, "upload_time": "2019-02-27T14:54:24", "url": "https://files.pythonhosted.org/packages/a2/b2/b5f2c6ee9d6c6155f5e2401a5b7212babc94a1542ba4d057806cfbcd3b73/nirmapper-1.1.7.tar.gz" } ], "1.1.8": [ { "comment_text": "", "digests": { "md5": "18b19eacf5645c08a5bfa58a5893f89e", "sha256": "7c770a57ff57ed3caa4a8bce8770140383bc387bf588a0b6caaa3e73723b7f47" }, "downloads": -1, "filename": "nirmapper-1.1.8.tar.gz", "has_sig": false, "md5_digest": "18b19eacf5645c08a5bfa58a5893f89e", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 16025117, "upload_time": "2019-02-28T07:25:47", "url": "https://files.pythonhosted.org/packages/55/8a/65e80d5257d0fb987ab05a2fa093b37dac6ba2623d93c14f02bb62b479e1/nirmapper-1.1.8.tar.gz" } ], "1.1.9": [ { "comment_text": "", "digests": { "md5": "574c38333cdff3284df9d39dfcb37110", "sha256": "fb445df5e7aeb60790a9ce6b24131330f8f9cd9c419ebc2116e2bd48d0df5a75" }, "downloads": -1, "filename": "nirmapper-1.1.9.tar.gz", "has_sig": false, "md5_digest": "574c38333cdff3284df9d39dfcb37110", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 20449884, "upload_time": "2019-03-10T16:22:49", "url": "https://files.pythonhosted.org/packages/d0/67/1d5781a5e922730ff98637f0cc23ff83ad886d5515773b34b5d0c64aa8fa/nirmapper-1.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "27d87e1f690cfe381ab8e41e31db2c89", "sha256": "c360bdbbba90d3331f82f0f52db48cc3850bb50bb6158e0357fd5ea50e2944e3" }, "downloads": -1, "filename": "nirmapper-1.1.10.tar.gz", "has_sig": false, "md5_digest": "27d87e1f690cfe381ab8e41e31db2c89", "packagetype": "sdist", "python_version": "source", "requires_python": ">2.7", "size": 20456227, "upload_time": "2019-03-10T17:11:17", "url": "https://files.pythonhosted.org/packages/62/84/284c6a21af2eb785fa95d862fdde43590a662c4e276389ea15dd4084a18a/nirmapper-1.1.10.tar.gz" } ] }