Software installation
Setting up the acquisition PC and installing required software and drivers.
Before proceeding, ensure you are familiar with the hardware requirements.
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 Windows LTSC as it is less aggressive with updates and has less useless crap installed by default.
Disabling Random Windows Reboots
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 is more complicated. It is still recommended you install updates when the system is idle: BakingTray will not be affected if you do this. Make sure you manually restart the PC if necessary right after the upgrades, otherwise the PC will reboot automatically in the middle of the night, possibly interrupting an acquisition.
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
In the event that you do need to switch SATA mode and Windows complains (it will likely BSOD) then you can try the following
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's website and download the drivers) then try again.
Software versions
The recommended configuration is the latest release of ScanImage Basic 2023 and MATLAB R2021b. ScanImage Premium is not needed for BakingTray. ScanImage 2026 is not yet supported. BakingTray has not been 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 file an Issue 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. MATLAB versions R2022b and R2023b seem not to be compatible with ScanImage (at least up to Basic 2023.0.0).
Install Software
After installing Windows and any hardware drivers you must install the following software:
MATLAB. You should install the Image Processing Toolbox. The Image Acquisition Toolbox is optional and may be used for camera-based diagnostics. Signal Processing and Statistics & Machine Learning are useful to have on the rig, but are not currently used by BakingTray.
NI DAQmx v 19.0 or newer if you do not have a vDAQ.
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)
Git for Windows. 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, you may find this link useful. 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.
Installation and configuration of ScanImage
Install ScanImage. 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 Setting Up ScanImage
Now is a good time to check the noise on your amplifiers.
Installation of BakingTray
Clone the master branch of BakingTray and add to your path:
codecode/resourcescode/componentsand 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 a line of this sort:
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.
Last updated