Installation

We implemented appdesigner windows (e.g., sceneWindow, oiWindow, etc.) in Matlab 2020a/b. These ran with Matlab 2021a/b But, Mathworks introduced changes so that Matlab 2019b will not run them. Please update if you can.

---

To install

• Download the ISETCam github repository.
• Add ISETCam toolbox to your Matlab path.

Some ISETCam functions use methods from the following Matlab toolboxes

• Image Processing Toolbox
• Signal Processing Toolbox
• Statistics and Machine Learning Toolbox
• Deep Learning Toolbox

The image processing and signal processing toolboxes are used often; the statistics and deep learning toolboxes less often.

Check that the installation succeeded by running, for example,

• t_sceneIntroduction, or
• t_oiIntroduction.mlx.

GitHub repository

We have found the GitHub Desktop applications to be a very effective method for downloading and managing GitHub repositories.

Here are some notes for those of you who prefer using the command line interface.

Using git clone to download the repository on your machine is a simple way to install the toolbox and stay up-to-date. You can use git pull the repository to stay up-to-date as we fix bugs and add new computations. If you find errors we should fix, or you wish to add a new function, you can make a git pull request.

Downloading a zipped copy of the distribution (see Download ZIP button on gitHub page) is a second way to obtain the code. This approach makes it harder to stay coordinated as the code evolves.

If you are comfortable with git, and you want to develop extensively, you might fork the repository. You can still pull from our repository to stay in sync with our developing code, and when you have suggestions about changes you can submit pull requests.

Related toolboxes

• ISET3d toolbox. Used to create and manipulate 3D spectral scenes. This toolbox requires that you install docker. In April 2024, we implemented a new version of ISET3d (ISET3d-tiny) that ultimately will replace the older toolbox, which has become unwieldy (IMHO).
• ISETLens toolbox. Evaluation of optics including multi-element lenses, point spread functions, black box models - much of this is in ISETCam, but ISETLens does more.
• ISETBio toolbox. Model the human optics, cone mosaic, ganglion cells. The scene, optical image, color and many other calculations use ISETCam; uniquely human biology features (the cone mosaic, RGCs models, human lens, inert pigments) are in the ISETBio repository.

For those interested in the quantitative validation of the software, we have two related toolboxes

• ISETValidate. This toolbox includes many scripts and utilities that perform system and unit tests of the ISETCam and ISETBio; we use ISETValidate to make sure code changes have not introduced unwanted side effects.
• Unit Test Toolbox. Utilities we rely on to run the validation code and report out the test results.