f23c8cd490
Fix jitter at specific screen sizes during scan See merge request openflexure/openflexure-microscope-server!404
88 lines
3.4 KiB
Markdown
88 lines
3.4 KiB
Markdown
# Guide: Running the OpenFlexure Microscope Simulation Server
|
|
|
|
This guide walks you through running the simulation server for the OpenFlexure Microscope, along with useful tips for using the simulation features.
|
|
|
|
The simulation server GUI is a copy of the GUI you would find on the hardware with a simulated sample you can explore. Most functionality included in the hardware operates on the simulation server. This includes:
|
|
|
|
* Camera stage mapping and 'click to move'
|
|
* Scanning and stitching*
|
|
* Autofocus
|
|
* Image capture
|
|
* Stage navigation
|
|
|
|
**Please note: the final stitch at the end of a scan currently doesn't work on Windows.*
|
|
|
|
---
|
|
|
|
## Starting the Simulation Server
|
|
|
|
1. **Activate your virtual environment** (the same one created during installation, as described in the [README](./README.md)).
|
|
2. **Run the simulation server** using the following command:
|
|
|
|
```bash
|
|
openflexure-microscope-server --fallback -c ./ofm_config_simulation.json
|
|
```
|
|
|
|
> Note: If you are using Windows, we advise running this command in PowerShell. If it doesn't work this, might be a permission issue on managed machines, in which case try executing the command in a CMD terminal.
|
|
|
|
This can fail with an error that the chosen port is already in use. In that case, append `--port 8081`
|
|
|
|
---
|
|
|
|
## Video Walkthrough
|
|
|
|
For a step-by-step demonstration, watch the [full video walkthrough on running the simulation server](https://youtu.be/Z8verCqfj9s).
|
|
|
|
---
|
|
|
|
## Running a simulated scan
|
|
|
|
To run a simulated scan, you first need to set a background image:
|
|
|
|
1. Click on the settings tab on the left
|
|
2. Navigate to the **Camera** settings under **Microscope Settings**
|
|
3. Click `Remove Sample`. This removes the simulated sample from the camera stream
|
|
4. Click on the **Background Detect** tab on the left and click `Set Background`
|
|
5. Repeat the steps 1 and 2 to return to the camera settings and click `Add Sample`
|
|
|
|
You are now ready to start a simulated scan in the Slide Scan tab.
|
|
|
|
---
|
|
|
|
## Simulation Settings and Tips
|
|
|
|
---
|
|
|
|
### Autocalibration
|
|
|
|
* Your simulated microscope should prompt you to complete the auto-calibration wizard upon your first use of the simulated server.
|
|
* If the stage moves in the wrong direction in the **View** or **Navigate** tabs, you can re-run **Auto-calibration** from the UI to correct it.
|
|
* To auto-calibrate your microscope, go to: **Settings → Camera to Stage Mapping → Auto-Calibrate Using Camera**.
|
|
|
|
---
|
|
|
|
### Sample Coverage
|
|
|
|
* The default **sample coverage** of 25% is often too high for simulations. A figure closer to 10% performs better.
|
|
* You can adjust this in the **Background Detect tab** under:
|
|
**Configure → Sample Coverage**
|
|
|
|
---
|
|
|
|
### Background and Samples
|
|
|
|
* You can **load a sample** to simulate imaging conditions, using the **Load Sample** options in the **Settings tab**.
|
|
* To remove a sample and reset the view, use the **Remove Sample** option in the **Settings tab**.
|
|
* You can load and remove simulated samples under: **Settings → Camera → Load/Remove Sample**
|
|
|
|
---
|
|
|
|
### Scans
|
|
|
|
* If you perform a scan with **0 images** (i.e. cancelling the scan before any images are collected), it will **disappear** from the scan list as soon as a new scan starts.
|
|
* Scans are automatically given **Scan IDs** in numerical order if the user does not provide one.
|
|
|
|
---
|
|
|
|
If you need further help, reach out to the community on the [OpenFlexure Forum](https://openflexure.discourse.group/).
|
|
|