BakingTray
  • BakingTray Documentation
  • Getting Started
    • Hardware requirements
    • Known issues
    • Initial Installation
      • Software installation
      • Setting up ScanImage
    • Hardware setup
      • Motor Setup
        • PI stage setup
        • Calibrating a linear actuator
        • Verifying stage motions
      • Setting up a VT1000 vibratome
      • Setting up the laser
    • Finishing the install
      • Check the noise on your amplifiers
      • Starting BakingTray
      • Settings Files
      • Calibration
        • Basic calibrating procedures
        • Calibrating image size
        • Achieving high stitching accuracy
        • Fine-tuning positioning accuracy
        • Stitching tweak walkthrough
    • Stitching data
  • Users
    • Introduction
    • Sample preparation
    • User Guide
      • Starting BakingTray
      • Step 0: Loading the sample
      • Step 1: Setting imaging parameters
      • Step 2: Preparing the sample
      • Step 3: Selecting the imaging area
      • Step 4: Starting the acquisition
      • Step 5: Concluding the acquisition
      • Setting up checklist
      • Resuming an acquisition
      • Manual ROI acquisitions
    • Excitation choices
    • Choosing imaging settings
    • Troubleshooting
      • Hardware problems
      • Computer problems
      • Cutting problems
      • Imaging problems
    • Data structure
    • autoROI
  • Developers
    • Developers
      • Code overview
      • Developer notes
      • Motion control classes
      • The recipe file
      • Auto-ROI
      • Simulated mode
      • Contributing
    • FAQ
    • Gallery
Powered by GitBook
On this page
  • Windows
  • Disabling Random Windows Reboots
  • Ensure Windows Does Not Enter Sleep Mode
  • Data storage and RAID
  • Raid Mode
  • Software versions
  • Install Software
  • Installation and configuration of ScanImage
  • Installation of BakingTray
  1. Getting Started
  2. Initial Installation

Software installation

Setting up the acquisition PC and installing required software and drivers.

PreviousInitial InstallationNextSetting up ScanImage

Last updated 6 months ago

Before proceeding, ensure you are familiar with the .

Windows

BakingTray requires Windows and will not run on Linux or Mac OS. Installs have been known to run on Windows 7, 10, and 11. If possible install as it is less aggressive with updates and has less useless crap installed by default.

Disabling Random Windows Reboots

You must ensure that Windows will not attempt to install updates or reboot the system without permission.

If using Windows 7 ensure you select the update setting that allows the user to choose when to install updates. For Windows 10 and 11 the story . It is still recommended you install updates when the system is idle: BakingTray will not be affected if you do this.

Ensure Windows Does Not Enter Sleep Mode

Configure the Windows Power settings such that the PC will never go to sleep when unattended.

Data storage and RAID

You will want at least 4 TB of local storage, on a physical volume separate from the OS drive. If you have a resonant scanner this must be either an SSD or a platter disk striped RAID with at least two drives (2 disk RAID 0 or 4 disk RAID 0+1). A single 8 TB SSD works very well.

Raid Mode

Consult your motherboard manual and set the on-board SATA ports to RAID mode if necessary before installing Windows. Windows is stupid and fails to boot if you switch to RAID mode afterwards.

In the event that you do need to switch SATA mode and Windows complains (it will likely BSOD) then you can try the following

  1. Just boot it into safe mode and it should automatically install the RAID drivers. After booting into safe mode once it should then be able to boot normally. If this fails, check whether the RAID drivers are installed (look on motherboard manufacturer' website and download the drivers) then try again.

Software versions

Install Software

After installing Windows and any hardware drivers you must install the following software:

  • PI software that came with your hardware: PI GCS, PI MATLAB GCS2, Stage database, USB driver, PIMikroMove, PITerminal, PIUpdateFinder

The following software is useful but not critical

  • TeamViewer (or similar)

We have noticed rare random hard-crashes of MATLAB in later releases (for sure in R2019a and R2019b). These were traced to 3D acceleration and occurred on both Win 7 and Win 10. Updating Nvidia drivers did not help but starting MATLAB in software OpenGL mode did get rid of the problem.

Installation and configuration of ScanImage

Installation of BakingTray

  • code

  • code/resources

  • code/components and its sub-directories

You can use the function at BakingTray/addBTtopath.m to do this or, better yet, do it with a setup.m file containing the line of this sort:

addpath(genpath('C:\MATLAB\BakingTray\code'))

This way you are robust to possible future changes in the directory structure. The pathtool GUI will also work if you prefer, but do not add the base BakingTray directory and all its sub-directories: this may have unintended consequences.

BakingTray has not been extensively tested on a range of MATLAB and ScanImage versions. Only general indications are provided here. It is the intention that BakingTray can be run on recent MATLAB and ScanImage versions, so you should feel free to use the latest versions of both and if something fails. However, it is known that certain combinations do not work. MATLAB R2019b to R2021b are known to work with ScanImage SI Free v5.6-1 up to Basic 2023.0.0. MATLAB versions R2022b and R2023b seem not to be compatible with ScanImage (at least up Basic 2023.0.0).

. You should install the following toolboxes: Curve Fitting, Data Acquisition, Image Acquisition, Image Processing, Parallel Computing, Signal Processing, Statistics & Machine Learning. Some of those are not currently used by BakingTray but they may be in the future so it's easier to install them if possible. If you lack some of those toolboxes, just install as many as possible and if you run into problems.

or newer if you do not have a vDAQ.

. This is used in the absence of a MATLAB package manager.

If using PI stages, install the PI drivers for the stages and follow the instructions for setting up the MATLAB PI interface. If you need to install the SDK in order to compile the PI drivers, . The PI MATLAB code will need to be in your path. It should be located at C:\Users\Public\PI\PI_MATLAB_Driver_GCS2 once installed.

Install . The old version (5.6.x) will probably work but BakingTray is compatible with SI Basic, which is much nicer and buying it gets you tech support from Vidrio.

Follow the steps in

Now is a good time to .

Clone the master branch of and add to your path:

hardware requirements
Windows LTSC
is more complicated
http://www.askvg.com/how-to-change-sata-hard-disk-mode-from-ide-to-ahci-raid-in-bios-after-installing-windows
file an Issue
MATLAB
file an Issue
NI DAQmx v 19.0
Putty
7-Zip
Faulhaber motion manager
WinSCP
Git for Windows
you may find this link useful
ScanImage
Setting Up ScanImage
check the noise on your amplifiers
BakingTray