Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/martinchristen/pyRT

pyRT - The Python Raytracer
https://github.com/martinchristen/pyRT

Last synced: about 2 months ago
JSON representation

pyRT - The Python Raytracer

Host: GitHub
URL: https://github.com/martinchristen/pyRT
Owner: martinchristen
License: other
Created: 2016-08-30T20:45:45.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2022-04-07T09:28:22.000Z (almost 3 years ago)
Last Synced: 2024-04-26T23:21:41.628Z (9 months ago)
Language: Jupyter Notebook
Homepage:
Size: 38.1 MB
Stars: 79
Watchers: 5
Forks: 21
Open Issues: 7
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

awesome-physics - pyRT - a raytracer/image generator for Python (Optics / Sound)

README

        PyRT - The Python Raytracer

===========================

http://pyrt.org

|CI| |donate| |contributions welcome| |Code Climate| |image5| 

.. figure::   https://github.com/martinchristen/pyRT/blob/master/docs/img/pyRT_256.png

   :alt: Logo

**PyRT** (pronounced *pirate*) is a raytracer/image generator for **Python 3.5** and higher.

This project is mainly done with the following in mind:

-  Ray Tracing in the Jupyter Notebook

-  Teaching ray tracing

-  Exploring ray tracing concepts for geo data using Python.

-  Rendering geo data, including large point clouds.

-  Implementing new algorithms for rendering large 3D city models.

-  Creating 3D-Maps from OpenStreetMap data

-  Server-side rendering / cloud based rendering

-  ...

|mandelbrot| |earthquake| |noise|

PyRT is **work in progress**.

Installation

------------

Installation can be done with pip. Please note that pyrt is still under **heavy development** and not yet meant for production.

(API breaks are possible!)

.. code:: shell

    pip install pyrt

Currently it is recommended to pip directly from the repository:

.. code:: shell

    pip install https://github.com/martinchristen/pyRT/archive/master.zip --upgrade

Dependencies

------------

PyRT doesn't have any dependencies, however, pillow and numpy are highly recommended.

 

Getting Started: Try the examples

---------------------------------

There are a lot of examples available how to use this module. This is

the recommended way to get started with pyRT.

|Example 01| |Example 12b| |Example 13| |Example 08|

`View all examples `__

Creating Scenes

---------------

PyRT is *not* a 3D-modelling package. It is all about rendering from

code.

In PyRT you create a scene first. Scenes consist of atleast one camera

and geometry. Creation of scenes is done in an object oriented way:

.. code:: python

    from pyrt.math import *

    from pyrt.geometry import Triangle, Vertex

    from pyrt.material import PhongMaterial

    from pyrt.camera import PerspectiveCamera

    from pyrt.renderer import SimpleRT

    from pyrt.scene import Scene

    camera = PerspectiveCamera(640,480)

    scene = Scene()

    scene.add(Triangle(Vertex(position=(0, 0, 0)), 

                       Vertex(position=(0, 5, 0)), 

                       Vertex(position=(1, 5, 0)), material=PhongMaterial()))

                       

    scene.setCamera(camera)

    engine = SimpleRT()

    imgdata = engine.render(scene)

PyRT has an open rendering concept, you can create **your own

renderer**. In the example above "SimpleRT" was used, which is a

minimalistic reference implementation.

Python & RayTracing, isn't that too slow ?

------------------------------------------

No. Custom renderers can be written in C with Python bindings. This is

planned in future, later versions will even support the GPU using OpenCL

and/or other libraries, but at the moment the primary focus is to create

a "pythonic" ray tracer.

License

-------

PyRT is released under MIT. More information about this license can be

found under: https://opensource.org/licenses/MIT

About the Author

----------------

PyRT is created and maintained by Martin Christen. You can contact me by

e-mail: [email protected]

Please note: This project is mostly developed in my spare time, there is no

official support or anything.

.. |CI| image:: https://travis-ci.org/martinchristen/pyRT.svg?branch=master

   :target: https://travis-ci.org/martinchristen/pyRT

.. |donate| image:: https://img.shields.io/badge/donate-pyRT%20backers-orange

   :target: https://pages.donately.com/pybaselassociation/campaign/pyrt-version-1-0

.. |contributions welcome| image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat

   :target: https://github.com/martinchristen/pyrt/issues

.. |Code Climate| image:: https://codeclimate.com/github/martinchristen/pyRT/badges/gpa.svg

   :target: https://codeclimate.com/github/martinchristen/pyRT

.. |Code Health| image:: https://landscape.io/github/martinchristen/pyRT/master/landscape.svg?style=flat

   :target: https://landscape.io/github/martinchristen/pyRT/master

.. |image5| image:: https://img.shields.io/badge/license-MIT-blue.svg

   :target: https://github.com/martinchristen/pyRT/blob/master/LICENSE.md

.. |Example 01| image:: https://github.com/martinchristen/pyRT/blob/master/examples/11.png

.. |Example 12b| image:: https://github.com/martinchristen/pyRT/blob/master/examples/12b.gif

.. |Example 13| image:: https://github.com/martinchristen/pyRT/blob/master/examples/13.png

.. |Example 08| image:: https://github.com/martinchristen/pyRT/blob/master/examples/08.png

.. |mandelbrot| image:: https://github.com/martinchristen/pyRT/blob/master/docs/img/mandelbrot.png

.. |noise| image:: https://github.com/martinchristen/pyRT/blob/master/docs/img/noise.png

.. |earthquake| image:: https://github.com/martinchristen/pyRT/blob/master/docs/img/earthquake.png