Skip to content

Installation

Jump to bottom
Brian Wandell edited this page Jul 13, 2025 · 12 revisions

Operating systems

We have run it on Macs and Linux extensively. Some folks have used Windows, but with some trouble. I think they use the Windows Subsystem for Linux (WSL).

Required

To run ISET3d-tiny locally the user needs

  1. MATLAB, along with the image processing, signal processing, and parallel computing toolboxes.

  2. Docker (typically pre-installed on Mac & Linux, but needs to be downloaded on Windows).

  3. A PBRT Docker image. It should be pulled automatically when needed. You can get also get it manually using commands such as:

              `docker pull vistalab/pbrt-v4-cpu` 
          `docker pull vistalab/pbrt-v4-gpu`

or any of the other pbrt-v4 images located in the vistlab organization on dockerhub.

ISETCam

We use ISET3d with ISETCam (for engineers working with cameras) or ISETBio (for scientists and engineers working with human vision).

ISETCam can be downloaded using: git clone http://github.com/ISET/isetcam.git

The human vision library, ISETBio, now runs on top of ISETCam. You can have ISETBio, ISETCam and ISET3d all on your path.

Remote rendering

ISET3d-tiny can make use of PBRT-v4's GPU support under certain conditions:

  1. Our Docker containers only support Nvidia GPUs with Compute Capability 6.0 or higher (local or remote)
  2. You'll need to have an ISET3d-tiny Docker image for your configuration

Optional

We have many repositories in the ISET organization that rely on ISETCam and ISET3d. One particular repository, mainly for teaching and thinking is ISETLens. Another fun tool we use for certain teaching projects is Don Dansereau's lightfield toolbox.

ISETLens

The ISETLens toolbox is used from time-to-time in ISET3d to visualize and edit lenses. The toolbox is not used often or required for most things. But it can be helpful for understanding.

Lightfield Toolbox

Donald Dansereau has written a useful Lightfield Toolbox for Matlab. We are organizing our data to take advantage of Donald's work, and we typically clone his repository into the external/ directory. We suggest that you use Donald's directory rather than the one placed on github by Hazirbas.

Clone this wiki locally