Skip to content

Setup

Jump to bottom
Matthew Sit edited this page Mar 17, 2019 · 22 revisions

Installation of the standalone application

Follow this option if you are not familiar with Matlab and want to use ReVAS as-is. Matlab installation not required. Provides a graphical user interface (GUI) and requires no code writing/handling.

  1. Download the installation .zip file corresponding to your operating system.

  2. A ReVAS installer should appear in your downloads; open it and wait for the installer to load. You will be brought to the ReVAS Installer window.

  3. Follow the instructions on the installer. If successful, your ReVAS tool should start downloading.

  4. When the download is finished, you should see the following window.

  5. To start up ReVAS, navigate to the folder where you installed ReVAS. From that folder, the path to the application should be `SELAB > application > ReVAS'. Double-click on the ReVAS application to launch the ReVAS tool.

Downloading the files

Follow this option if you want to download the files and experiment for your own purposes, but do not intend on contributing back features/improvements to our code base.

  1. Go to the ReVAS repository GitHub page and press the green "Clone or download" button, followed by "Download ZIP".
  2. Open the files in MATLAB. This requires an installation of Matlab and a license to use Matlab. The university has licenses available for UC Berkeley affiliates, more information here and here.

Cloning the repository

Follow this option if you want to contribute back features/improvements to our code base, or if you want to use git to track your own changes.

  1. Go to the ReVAS repository GitHub page and "Fork" the repository to your own GitHub account.
  2. Looking at your repository now (yourusername/ReVAS NOT lowvisionresearch/ReVAS), press the green "Clone or download" button, select the text, open your terminal, and type git clone followed by the pasted text.
  3. If you are new to git, the data structures course at Berkeley has an excellent reference that explains how to use it. Standard practice is to make a commit with a descriptive message for every functional change you make.
  4. If you want to contribute your pushed commits back to the main lowvisionresearch/ReVAS repository, you can make a pull request, which is a request to merge your code back in. Your request will have to be approved before it takes effect, and edits may be requested before approval.

ReVAS

Clone this wiki locally