updated documentation config and structure
Sebastian Wendel
|
|
@ -1,15 +0,0 @@
|
|||
# .readthedocs.yml
|
||||
# Read the Docs configuration file
|
||||
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
|
||||
|
||||
# Required
|
||||
version: 2
|
||||
|
||||
# Build documentation with MkDocs
|
||||
mkdocs:
|
||||
configuration: mkdocs.yml
|
||||
|
||||
# Declare the Python requirements required to build your docs
|
||||
python:
|
||||
install:
|
||||
- requirements: docs/requirements.txt
|
||||
16
README.md
|
|
@ -4,9 +4,19 @@ SPDX-License-Identifier: CC-BY-SA-4.0
|
|||
|
||||
# An open and affordable imaging platform for citizen oceanography
|
||||
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| CI/CD | [](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/test.yml) [](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/build.yml) |
|
||||
| Package | [](https://pypi.org/project/planktoscope/) [](https://pypi.org/project/planktoscope/) |
|
||||
| Meta | [](https://github.com/pypa/hatch) [](https://github.com/psf/black) [](https://github.com/ambv/black) [](https://github.com/pycqa/isort) [!
|
||||
|
||||
|
||||
[License - GPL](https://img.shields.io/badge/license-GPL-blue.svg)](<https://spdx.org/licenses/>) |
|
||||
|
||||
<https://shields.io/badge/reuse-compliant-green>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## What is this?
|
||||
|
||||
|
|
@ -18,7 +28,7 @@ The goal of the PlanktoScope is to allow citizen to engage in scientific program
|
|||
|
||||
The PlanktoScope has been described in a paper available on the [bioRxiv preprint server](https://www.biorxiv.org/content/10.1101/2020.04.23.056978v1). The first results of this program and its outline are also available as a [preprint](https://www.biorxiv.org/content/10.1101/2020.08.31.263442v1).
|
||||
|
||||
| [](https://www.biorxiv.org/content/10.1101/2020.04.23.056978v1) | [](https://www.biorxiv.org/content/10.1101/2020.08.31.263442v1) |
|
||||
| [](https://www.biorxiv.org/content/10.1101/2020.04.23.056978v1) | [](https://www.biorxiv.org/content/10.1101/2020.08.31.263442v1) |
|
||||
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
||||
|
||||
## Key Features
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
|
|||
|
||||
# Welcome to the PlanktoScope build and use documentation
|
||||
|
||||
|
||||
|
||||
|
||||
You can find here more information about how to build your own PlanktoScope.
|
||||
|
||||
|
|
@ -16,7 +16,7 @@ You can find here more information about how to build your own PlanktoScope.
|
|||
|
||||
## Build your machine
|
||||
|
||||
- [Assembly Guide](assembly_guide.md)
|
||||
- [Assembly Guide](images/assembly_guide.md)
|
||||
|
||||
## Usage
|
||||
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
|
|||
|
||||
# Assembly guide of the PlanktoScope
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 0: Gather everything you need
|
||||
|
||||
|
|
@ -29,7 +29,7 @@ Soldering deals with high heat and potentially toxic materials, so make sure to
|
|||
|
||||
## Step 1: Laser cutting
|
||||
|
||||
|
||||
|
||||
|
||||
Laser cut all components using the .ai file ensuring all cuts are complete. The current design should have a 5mm material thickness. Start by placing laser cut base A on a flat workspace. Make sure all holes are complete, and negative space is clear.
|
||||
|
||||
|
|
@ -38,120 +38,120 @@ Laser cut all components using the .ai file ensuring all cuts are complete. The
|
|||
|
||||
## Step 2: Standoff installation
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Place 8 standoffs (M2.5 6mm) into the designated holes on the laser-cut base A. A pair of pliers make the job more comfortable. Do not overtighten as it is possible to crack the base material.
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 3: Motor HAT preparation
|
||||
|
||||
|
||||
|
||||
|
||||
Insert and solder the terminal blocks and headers onto the motor driver PCB.
|
||||
|
||||
|
||||
|
||||
|
||||
Place the motor driver PCB on to the indicated standoffs.
|
||||
|
||||
## Step 4: Magnets setup
|
||||
|
||||
|
||||
|
||||
|
||||
Now is a good time to think about how the magnets will function within the microscope. The magnets in the sample stage will need to attract to the magnets on the flow cell holder. The magnets in the objective holder will need to attract the magnets on the mount. Keep this in mind as you are adding your magnets and tapping your respective M12 holders so your orientation will be correct.
|
||||
|
||||
|
||||
|
||||
|
||||
You can now fix your magnets into their appropriate holes on sample stage **B**.
|
||||
It is recommended to glue the magnets in place. If the magnets are too large to fit in, the holes can be widened with a handheld drill. However, they should be quite snug in place. Before you glue them in place make sure that the polarity is maintained, as they will be impossible to remove after gluing.
|
||||
|
||||
## Step 5: Sample stage assembly
|
||||
|
||||
|
||||
|
||||
|
||||
Don’t be alarmed by the color swap, this is the sample stage **B**. You can now fit the pegs on the driver mounts into the corresponding holes on the sample stage. They should be glued in place with superglue or epoxy. You can spin the shaft to align the driver mounts on the 2 steppers if it helps making the process easier.
|
||||
|
||||
|
||||
|
||||
|
||||
You should now have a sample stage and motor assembly that looks like this.
|
||||
|
||||
## Step 6: Lenses tapping and mounting
|
||||
|
||||
|
||||
|
||||
|
||||
You now need to tap the holes for the M12 lenses in stage and mount **M** and **D**. It is helpful for alignment to do both the objeDtive and tube lens mount together. It is important to do this as straight as possible. A drop of mineral or olive oil can help the process. Be careful to use a right-hand tap (that goes down when turning clockwise).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
You can now screw the objective lens (the 25mm one) in part **D**.
|
||||
|
||||
|
||||
|
||||
## Step 7: Camera preparation
|
||||
|
||||
You can now unscrew the lens from the Pi camera, being careful not to disturb the sensor below.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 8: Camera mount
|
||||
|
||||
|
||||
|
||||
|
||||
You can mount the camera using the appropriate holes on the camera mount **G**. Be careful to avoid getting oil or dust on the sensor.
|
||||
|
||||
## Step 9: LED preparation
|
||||
|
||||
|
||||
|
||||
|
||||
The LED can then be wired up and put into its mount **F**. If you wire the LED yourself, remember to give enough length to reach the motor driver on the other end of the microscope. You can also add a bit of glue to fix **F** to the motor mount **E** at this time to make assembly easier, though it is not required.
|
||||
|
||||
!!! warning
|
||||
|
||||
|
||||
|
||||
This picture shows the correct wiring for the LED. Please make sure the red wire is on the long pin of the LED.
|
||||
|
||||
## Step 10: Vertical slices assembly
|
||||
|
||||
You can now start placing the motor mount/LED assembly- **B**,
|
||||
|
||||
|
||||
|
||||
**C**,
|
||||
|
||||
|
||||
|
||||
**D**,
|
||||
|
||||
|
||||
|
||||
**E**,
|
||||
|
||||
|
||||
|
||||
**F**,
|
||||
|
||||
|
||||
|
||||
and **G** into the base **A**.
|
||||
|
||||
## Step 11: Pump setup
|
||||
|
||||
The pump can then be mounted in place on **H**. Thread the wires through the hole with the pump tubing pointed toward the holes on the mount.
|
||||
|
||||
|
||||
|
||||
Fix the pump in place.
|
||||
|
||||
|
||||
|
||||
## Step 12: Pump mounting
|
||||
|
||||
You can now mount the pump on base **A**.
|
||||
|
||||
|
||||
|
||||
Your setup should look like this. Don't worry about the wiring, we'll have a look at it in the next step!
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 13: Motor HAT wiring
|
||||
|
||||
|
||||
|
||||
|
||||
You will now want to wire the steppers and pump to the terminals on the motor driver board.
|
||||
|
||||
|
|
@ -168,34 +168,34 @@ You will now want to wire the steppers and pump to the terminals on the motor dr
|
|||
|
||||
## Step 14: Raspberry Pi setup and installation
|
||||
|
||||
|
||||
|
||||
|
||||
At this point, you can insert your flashed SD card into your Raspberry Pi. [Consult the guide for flashing your SD card](https://www.planktoscope.org/replicate/assemble-your-kit) before you do this. The heat sink can also be added to the processor.
|
||||
|
||||
!!! note
|
||||
If you choose the Expert path, you still need to flash your sd card, either with the [lite version](https://downloads.raspberrypi.org/raspios_lite_armhf_latest) of Raspberry OS or with the [desktop version](https://downloads.raspberrypi.org/raspios_armhf_latest).
|
||||
|
||||
|
||||
|
||||
|
||||
Mount the Raspberry Pi containing the flashed SD card on the standoffs attached to the laser cut base A.
|
||||
|
||||
## Step 15: Standoffs
|
||||
|
||||
|
||||
|
||||
|
||||
Add 8 standoffs (M2.5 15mm) to fix the motor driver board and the Raspberry Pi to the base.
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 16: Camera flex cable
|
||||
|
||||
|
||||
|
||||
|
||||
At this point you can use the Pi camera flex cable to connect the camera to the Pi. This is done by gently pulling up the tensioners, inserting the cable in the right orientation, then pushing the tensioners back in place to set the cable. Try not to kink or fold the flex cable too much as it is possible to damage it.
|
||||
|
||||
## Step 17: Power supply wiring
|
||||
|
||||
|
||||
|
||||
|
||||
The power wires can be wired into place on the motor driver board.
|
||||
|
||||
|
|
@ -204,19 +204,19 @@ The power wires can be wired into place on the motor driver board.
|
|||
|
||||
## Step 18: Prepare the GPS HAT
|
||||
|
||||
|
||||
|
||||
|
||||
Insert the battery to power the GPS HAT and solder the terminal mounts in place.
|
||||
|
||||
## Step 19: Install the GPS HAT
|
||||
|
||||
|
||||
|
||||
|
||||
Mount the GPS HAT over the motor driver PCB using the standoffs attached to the laser cut base **A**.
|
||||
|
||||
## Step 20: Install the Fan HAT
|
||||
|
||||
|
||||
|
||||
|
||||
Place the cooling fan HAT above the Raspberry Pi by mounting it to the standoffs on base **A**.
|
||||
|
||||
|
|
@ -225,25 +225,25 @@ Place the cooling fan HAT above the Raspberry Pi by mounting it to the standoffs
|
|||
|
||||
## Step 21: Secure the HATS
|
||||
|
||||
|
||||
|
||||
|
||||
Secure the cooling fan HAT and GPS HAT by tightening the 8 screws to the standoffs on base A
|
||||
|
||||
## Step 22: Install back panel
|
||||
|
||||
|
||||
|
||||
|
||||
Insert the laser cut border **I** into base **A**.
|
||||
|
||||
## Step 23: GPS output connector
|
||||
|
||||
|
||||
|
||||
|
||||
Insert the power and GPS connectors into side plate **J**.
|
||||
|
||||
## Step 24: Install side panel
|
||||
|
||||
|
||||
|
||||
|
||||
Place the side plate **J** into the designated slots on the base. You can connect the GPS cable to its connector on the board.
|
||||
|
||||
|
|
@ -252,19 +252,19 @@ Place the side plate **J** into the designated slots on the base. You can connec
|
|||
|
||||
## Step 25: Install the other side panel
|
||||
|
||||
|
||||
|
||||
|
||||
Mount the side plate **K** on base **A** using the assigned slots.
|
||||
|
||||
## Step 26: Secure the sides together
|
||||
|
||||
|
||||
|
||||
|
||||
Secure the laser cut sides with the screws and nuts.
|
||||
|
||||
## Step 27: Secure the sides to the base plate
|
||||
|
||||
|
||||
|
||||
|
||||
Secure the laser cut sides to the base plate **A** with the screws and nuts.
|
||||
|
||||
|
|
@ -273,7 +273,7 @@ Secure the laser cut sides to the base plate **A** with the screws and nuts.
|
|||
|
||||
## Step 28: Insert the camera ribbon cable in the camera
|
||||
|
||||
|
||||
|
||||
|
||||
You can now connect the camera flex cable into the connector on the camera board. Once again, gently pull up the tensioners, insert the cable in the right orientation, and push the tensioners back in place to set the cable. Try not to kink or fold the flex cable too much as it is possible to damage it.
|
||||
|
||||
|
|
@ -287,56 +287,56 @@ To assemble, slide the ribbon in its connector and close it off. You need to tig
|
|||
|
||||
!!! warning
|
||||
Once assembled, the ribbon should NOT look like this:
|
||||
|
||||
|
||||
|
||||
It should rather look like this:
|
||||
|
||||
|
||||
|
||||
## Step 30: Insert the ribbon cable
|
||||
|
||||
|
||||
|
||||
|
||||
Attach the GPIO ribbon to connect the cooling fan HAT to the GPS HAT.
|
||||
|
||||
!!! tip
|
||||
You can try to route the flat ribbon from the camera under the ribbon cable you are connecting now.
|
||||
|
||||
|
||||
|
||||
## Step 31: Fluidic assembly
|
||||
|
||||
|
||||
|
||||
|
||||
Feed in the tubing from syringe 1 to form the fluidic path as shown.
|
||||
|
||||
|
||||
|
||||
|
||||
Feed in the tubing from syringe 2 to form the fluidic path as shown
|
||||
|
||||
|
||||
|
||||
|
||||
Feed in a length of tubing as shown through motor mount **H** and illumination mount **FE**
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 32: Close your PlanktoScope
|
||||
|
||||
!!! warning
|
||||
Take a moment to check your wiring one last time. Also check the routing, make sure the LED wires and the pump stepper wires are in their dedicated channel.
|
||||
|
||||
|
||||
|
||||
|
||||
Place the top **L** into the slots on the PlanktoScope body. Secure it in place with screws and nuts.
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 33: Enjoy
|
||||
|
||||
Congratulations on a job well done. You can have some rest, get a tea and some biscuits!
|
||||
|
||||
|
||||
|
||||
|
||||
You can now plug the machine in and test it. If you have choose the Expert's path, now is a good time to [finish setting up your machine](expert_setup.md).
|
||||
|
||||
## Step 34: Read the getting started guide
|
||||
|
||||
[A guide to get started with your machine use is available!](getting_started.md)
|
||||
[A guide to get started with your machine use is available!](images/getting_started.md)
|
||||
|
|
|
|||
BIN
docs/assets/logo-white.png
Normal file
|
After Width: | Height: | Size: 40 KiB |
111
docs/contributions.md
Normal file
|
|
@ -0,0 +1,111 @@
|
|||
<!--
|
||||
SPDX-License-Identifier: CC-BY-SA-4.0
|
||||
-->
|
||||
|
||||
# Contributing <!-- omit in toc -->
|
||||
|
||||
First of all, thank you for contributing to FabCityOS! The goal of this document is to provide everything you need to know in order to contribute to FabCityOS and its different integrations.
|
||||
|
||||
- [Assumptions](#assumptions)
|
||||
- [How to Contribute](#how-to-contribute)
|
||||
- [Development Workflow](#development-workflow)
|
||||
- [Git Guidelines](#git-guidelines)
|
||||
- [Release Process (for internal team only)](#release-process-for-internal-team-only)
|
||||
|
||||
## Assumptions
|
||||
|
||||
1. **You're familiar with [git](https://git-scm.com/) and the [Merge Request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html)(PR) workflow.**
|
||||
2. **You've read the PlanktoScope [documentation](https://planktonscope.readthedocs.io/) and the [images/readme](/images/readme.md).**
|
||||
3. **You know about the PlanktoScope [community on Slack](https://planktoscope.slack.com/). Please use this for help.**
|
||||
|
||||
## How to Contribute
|
||||
|
||||
1. Make sure that the contribution you want to make is explained or detailed in a GitHub issue! Find an [existing issue](https://github.com/PlanktoScope/PlanktoScope/issues) or [open a new one](https://github.com/PlanktoScope/PlanktoScope/issues/new/choose).
|
||||
2. Once done, [fork the PlanktoScope repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo) in your Github account. Ask a mastertainer if you want your issue to be checked before making a PR.
|
||||
3. [Create a new Git branch](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository).
|
||||
4. Review the [Development Workflow](#development-workflow) section that describes the steps to mastertain the repository.
|
||||
5. Make the changes on your branch.
|
||||
6. [Submit the branch as a PR](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) pointing to the `master` branch of the master fabcity-os-core-chart repository. A mastertainer should comment and/or review your Pull Request within a few days. Although depending on the circumstances, it may take longer. We do not enforce a naming convention for the PRs, but **please use something descriptive of your changes**, having in mind that the title of your PR will be automatically added to the next [release changelog](https://github.com/PlanktoScope/PlanktoScope/releases).
|
||||
|
||||
## Development Workflow
|
||||
|
||||
### Setup <!-- omit in toc -->
|
||||
|
||||
In order to use the different tools on this repository, you will first need to:
|
||||
|
||||
```sh
|
||||
```
|
||||
|
||||
### Tests and Linter <!-- omit in toc -->
|
||||
|
||||
Each PR should pass the linter to be accepted.
|
||||
|
||||
```sh
|
||||
make lint
|
||||
```
|
||||
|
||||
Each PR should also check if the generated file `manifests/fcoscore.yaml` is updated with the new modifications.
|
||||
You can generated the manifest with the command line:
|
||||
|
||||
```bash
|
||||
helm template fcoscore . | grep -v 'helm.sh/chart:\|app.kubernetes.io/managed-by:' > manifests/FabCityOS.yaml
|
||||
```
|
||||
|
||||
Or just by comment the PR:
|
||||
|
||||
```txt
|
||||
@FabCityOS sync-manifest
|
||||
```
|
||||
|
||||
Additionally, the CI will run a test to check if there are changes introduced to the charts. If changes were introduced, it will require you to update the Chart version.
|
||||
|
||||
## Git Guidelines
|
||||
|
||||
### Git Branches <!-- omit in toc -->
|
||||
|
||||
All changes must be made in a branch and submitted as PR.
|
||||
We do not enforce any branch naming style, but please use something descriptive of your changes.
|
||||
|
||||
### Git Commits <!-- omit in toc -->
|
||||
|
||||
As minimal requirements, your commit message should:
|
||||
|
||||
- be capitalized
|
||||
- not finish by a dot or any other punctuation character (!,?)
|
||||
- start with a verb so that we can read your commit message this way: "This commit will ...", where "..." is the commit message.
|
||||
e.g.: "Fix the home page button" or "Add more tests for create_index method"
|
||||
|
||||
We don't follow any other convention, but if you want to use one, we recommend [this one](https://chris.beams.io/posts/git-commit/).
|
||||
|
||||
### Pull Requests <!-- omit in toc -->
|
||||
|
||||
Some notes on PRs:
|
||||
|
||||
- [Convert your PR as a draft]() if your changes are a work in progress: no one will review it until you pass your PR as ready for review.<br>
|
||||
The draft PR can be very useful if you want to show that you are working on something and make your work visible.
|
||||
- The branch related to the PR must be **up-to-date with `master`** before merging. Fortunately, this project [integrates a bot]() to automatically enforce this requirement without the PR author having to do it manually.
|
||||
- All PRs must be reviewed and approved by at least one mastertainer.
|
||||
- The PR title should be accurate and descriptive of the changes. The title of the PR will be indeed automatically added to the next [release changelogs]().
|
||||
|
||||
## Release Process (for internal team only)
|
||||
|
||||
FabCityOS tools follow the [Semantic Versioning Convention](https://semver.org/).
|
||||
|
||||
### Automation to Rebase and Merge the PRs <!-- omit in toc -->
|
||||
|
||||
This project integrates a bot that helps us manage pull requests merging.<br>
|
||||
_[Read more about this]()._
|
||||
|
||||
### How to Publish the Release <!-- omit in toc -->
|
||||
|
||||
⚠️ Before doing anything, make sure you got through the guide about [Releasing an Integration]().
|
||||
|
||||
⚠️ Every PR that is merged to `master` introducing changes to the PlanktoScope needs to modify the file [``](), by increasing the version of the chart accordingly.
|
||||
|
||||
Every PR that is merged to `master` triggers the automated release process, as specified at [``](). A GitHub Action will be triggered and publish a new release on the GitHub repository [releases](). This will enable users to start using the new version of the chart immediately after publishing.
|
||||
|
||||
Thank you again for reading this through, we can not wait to begin to work with you if you made your way through this contributing guide ❤️
|
||||
|
||||
- pdfimages -all protocols/PlanktoScope\ -\ Setup\ and\ Sampling\ Guide\ VER3.pdf protocols/dumps/PlanktoScope_Setup_and_Sampling_Guide_VER3
|
||||
sudo apt-get install pandoc texlive-latex-base texlive-fonts-recommended texlive-extra-utils texlive-latex-extra
|
||||
sudo apt install poppler-utils
|
||||
|
|
@ -9,16 +9,16 @@ Congratulations! You have finished assembling your machine, now is the time to t
|
|||
## How to connect to and control the machine
|
||||
|
||||
On powering up, your PlanktoScope will create its own isolated WiFi network. It should appear on the list of available wifi networks about two minutes after the first startup.
|
||||
|
||||
|
||||
|
||||
As you can see, its name will be similar to `PlanktoScope-Baba*****_*****`. This name is unique to your machine and is linked to the serial number of the Raspberry CPU. You can connect to this network now.
|
||||
|
||||
Once connected, you will not have acces to the Internet, only to the PlanktoScope interface. You can access the page at [http://planktoscope.local:1880/ui](http://planktoscope.local:1880/ui) from your favorite web browser.
|
||||
|
||||
!!! tip
|
||||
You are able to configure your machine to connect to another network if you want in the [Wifi settings page](ui_guide.md#wifi). If you do this, your machine will be accessible to anybody connected to this network. Please keep in mind your organisation security policies before doing this.
|
||||
You are able to configure your machine to connect to another network if you want in the [Wifi settings page](images/ui_guide.md#wifi). If you do this, your machine will be accessible to anybody connected to this network. Please keep in mind your organisation security policies before doing this.
|
||||
|
||||
From there, you can have a look at the [UI guide](ui_guide.md) to get a handle on how it works.
|
||||
From there, you can have a look at the [UI guide](images/ui_guide.md) to get a handle on how it works.
|
||||
|
||||
## How to image plankton
|
||||
|
||||
|
|
|
|||
BIN
docs/images/assembly_guide/pictures/complete.webp
Normal file
|
After Width: | Height: | Size: 52 KiB |
BIN
docs/images/assembly_guide/pictures/image22.webp
Normal file
|
After Width: | Height: | Size: 15 KiB |
BIN
docs/images/assembly_guide/pictures/image30.webp
Normal file
|
After Width: | Height: | Size: 31 KiB |
BIN
docs/images/assembly_guide/pictures/ribbon_good.webp
Normal file
|
After Width: | Height: | Size: 290 KiB |
BIN
docs/images/assembly_guide/pictures/ribbon_wrong.webp
Normal file
|
After Width: | Height: | Size: 654 KiB |
BIN
docs/images/assembly_guide/pictures/step1.webp
Normal file
|
After Width: | Height: | Size: 39 KiB |
BIN
docs/images/assembly_guide/pictures/step10.webp
Normal file
|
After Width: | Height: | Size: 46 KiB |
BIN
docs/images/assembly_guide/pictures/step12.webp
Normal file
|
After Width: | Height: | Size: 39 KiB |
BIN
docs/images/assembly_guide/pictures/step13.webp
Normal file
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/images/assembly_guide/pictures/step14.webp
Normal file
|
After Width: | Height: | Size: 53 KiB |
BIN
docs/images/assembly_guide/pictures/step15.webp
Normal file
|
After Width: | Height: | Size: 26 KiB |
BIN
docs/images/assembly_guide/pictures/step17.webp
Normal file
|
After Width: | Height: | Size: 38 KiB |
BIN
docs/images/assembly_guide/pictures/step18.webp
Normal file
|
After Width: | Height: | Size: 53 KiB |
BIN
docs/images/assembly_guide/pictures/step19.webp
Normal file
|
After Width: | Height: | Size: 37 KiB |
BIN
docs/images/assembly_guide/pictures/step2.webp
Normal file
|
After Width: | Height: | Size: 29 KiB |
BIN
docs/images/assembly_guide/pictures/step20.webp
Normal file
|
After Width: | Height: | Size: 40 KiB |
BIN
docs/images/assembly_guide/pictures/step21.webp
Normal file
|
After Width: | Height: | Size: 60 KiB |
14402
docs/images/assembly_guide/pictures/step22.svg
Normal file
|
After Width: | Height: | Size: 1.1 MiB |
BIN
docs/images/assembly_guide/pictures/step24.webp
Normal file
|
After Width: | Height: | Size: 65 KiB |
BIN
docs/images/assembly_guide/pictures/step25.webp
Normal file
|
After Width: | Height: | Size: 78 KiB |
BIN
docs/images/assembly_guide/pictures/step26.webp
Normal file
|
After Width: | Height: | Size: 86 KiB |
BIN
docs/images/assembly_guide/pictures/step28.webp
Normal file
|
After Width: | Height: | Size: 58 KiB |
BIN
docs/images/assembly_guide/pictures/step29.webp
Normal file
|
After Width: | Height: | Size: 68 KiB |
BIN
docs/images/assembly_guide/pictures/step3.webp
Normal file
|
After Width: | Height: | Size: 26 KiB |
BIN
docs/images/assembly_guide/pictures/step31.webp
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
docs/images/assembly_guide/pictures/step34.webp
Normal file
|
After Width: | Height: | Size: 70 KiB |
BIN
docs/images/assembly_guide/pictures/step4.webp
Normal file
|
After Width: | Height: | Size: 80 KiB |
BIN
docs/images/assembly_guide/pictures/step5.webp
Normal file
|
After Width: | Height: | Size: 47 KiB |
BIN
docs/images/assembly_guide/pictures/step6.webp
Normal file
|
After Width: | Height: | Size: 102 KiB |
BIN
docs/images/assembly_guide/pictures/step8.webp
Normal file
|
After Width: | Height: | Size: 38 KiB |
BIN
docs/images/assembly_guide/pictures/step9.webp
Normal file
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/images/assembly_guide/render/Step2.webp
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
docs/images/assembly_guide/render/led.webp
Normal file
|
After Width: | Height: | Size: 8.3 KiB |
BIN
docs/images/assembly_guide/render/step15.webp
Normal file
|
After Width: | Height: | Size: 53 KiB |
BIN
docs/images/assembly_guide/render/step16.webp
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
docs/images/assembly_guide/render/step17.webp
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
docs/images/assembly_guide/render/step18-1.webp
Normal file
|
After Width: | Height: | Size: 22 KiB |
BIN
docs/images/assembly_guide/render/step18.webp
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
docs/images/assembly_guide/render/step19.webp
Normal file
|
After Width: | Height: | Size: 65 KiB |
BIN
docs/images/assembly_guide/render/step20.webp
Normal file
|
After Width: | Height: | Size: 61 KiB |
BIN
docs/images/assembly_guide/render/step21.webp
Normal file
|
After Width: | Height: | Size: 64 KiB |
BIN
docs/images/assembly_guide/render/step22.webp
Normal file
|
After Width: | Height: | Size: 25 KiB |
BIN
docs/images/assembly_guide/render/step23.webp
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
docs/images/assembly_guide/render/step25.webp
Normal file
|
After Width: | Height: | Size: 64 KiB |
BIN
docs/images/assembly_guide/render/step26.webp
Normal file
|
After Width: | Height: | Size: 55 KiB |
BIN
docs/images/assembly_guide/render/step27.webp
Normal file
|
After Width: | Height: | Size: 42 KiB |
BIN
docs/images/assembly_guide/render/step28.webp
Normal file
|
After Width: | Height: | Size: 61 KiB |
BIN
docs/images/assembly_guide/render/step29.webp
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
docs/images/assembly_guide/render/step30.webp
Normal file
|
After Width: | Height: | Size: 74 KiB |
BIN
docs/images/assembly_guide/render/step31.webp
Normal file
|
After Width: | Height: | Size: 63 KiB |
BIN
docs/images/assembly_guide/render/step33.webp
Normal file
|
After Width: | Height: | Size: 66 KiB |
BIN
docs/images/assembly_guide/render/step34.webp
Normal file
|
After Width: | Height: | Size: 62 KiB |
BIN
docs/images/assembly_guide/render/step35.webp
Normal file
|
After Width: | Height: | Size: 45 KiB |
BIN
docs/images/assembly_guide/render/step5.webp
Normal file
|
After Width: | Height: | Size: 35 KiB |
BIN
docs/images/assembly_guide/render/step6-2.webp
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/images/assembly_guide/render/step6.webp
Normal file
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/images/assembly_guide/render/step7.webp
Normal file
|
After Width: | Height: | Size: 41 KiB |
BIN
docs/images/assembly_guide/render/step8.webp
Normal file
|
After Width: | Height: | Size: 42 KiB |
BIN
docs/images/assembly_guide/render/step9.webp
Normal file
|
After Width: | Height: | Size: 44 KiB |
BIN
docs/images/getting_started/wifi.webp
Normal file
|
After Width: | Height: | Size: 51 KiB |
BIN
docs/images/readme/copepod.webp
Normal file
|
After Width: | Height: | Size: 25 KiB |
BIN
docs/images/readme/plankton_collage.webp
Normal file
|
After Width: | Height: | Size: 36 KiB |
BIN
docs/images/readme/planktonplanet_pub.webp
Normal file
|
After Width: | Height: | Size: 100 KiB |
BIN
docs/images/readme/planktoscope_cad.webp
Normal file
|
After Width: | Height: | Size: 15 KiB |
BIN
docs/images/readme/planktoscope_pub.webp
Normal file
|
After Width: | Height: | Size: 100 KiB |
BIN
docs/images/ui_guide/administration.webp
Normal file
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/images/ui_guide/fluidic_acquisition.webp
Normal file
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/images/ui_guide/gallery.webp
Normal file
|
After Width: | Height: | Size: 9 KiB |
BIN
docs/images/ui_guide/hardware_config.webp
Normal file
|
After Width: | Height: | Size: 9 KiB |
BIN
docs/images/ui_guide/home.webp
Normal file
|
After Width: | Height: | Size: 14 KiB |
BIN
docs/images/ui_guide/home_shutdown.webp
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
docs/images/ui_guide/home_unlocked.webp
Normal file
|
After Width: | Height: | Size: 14 KiB |
BIN
docs/images/ui_guide/optic_configuration.webp
Normal file
|
After Width: | Height: | Size: 28 KiB |
BIN
docs/images/ui_guide/sample_net.webp
Normal file
|
After Width: | Height: | Size: 21 KiB |
BIN
docs/images/ui_guide/sample_pass.webp
Normal file
|
After Width: | Height: | Size: 14 KiB |
BIN
docs/images/ui_guide/sample_selection.webp
Normal file
|
After Width: | Height: | Size: 17 KiB |
BIN
docs/images/ui_guide/sample_validation.webp
Normal file
|
After Width: | Height: | Size: 17 KiB |
BIN
docs/images/ui_guide/system_monitoring.webp
Normal file
|
After Width: | Height: | Size: 24 KiB |
BIN
docs/images/ui_guide/tab_list.webp
Normal file
|
After Width: | Height: | Size: 10 KiB |
BIN
docs/images/ui_guide/update.webp
Normal file
|
After Width: | Height: | Size: 6.1 KiB |
BIN
docs/images/ui_guide/update_ready.webp
Normal file
|
After Width: | Height: | Size: 50 KiB |
BIN
docs/images/ui_guide/update_restarting.webp
Normal file
|
After Width: | Height: | Size: 34 KiB |
BIN
docs/images/ui_guide/update_start.webp
Normal file
|
After Width: | Height: | Size: 24 KiB |
BIN
docs/images/ui_guide/wifi.webp
Normal file
|
After Width: | Height: | Size: 11 KiB |
|
|
@ -6,7 +6,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
|
|||
|
||||
Starting with the release of v2.2, a new user interface brings a whole new user interface. This guide will help you get familiar with it.
|
||||
|
||||
|
||||
|
||||
|
||||
## Home
|
||||
|
||||
|
|
@ -18,7 +18,7 @@ From here, you can quickly access any of the available tabs. The buttons are onl
|
|||
* Administration
|
||||
* Hardware Config
|
||||
|
||||
|
||||
|
||||
|
||||
!!! tip
|
||||
This list is also available from any other tab and allows you to quickly navigate between tabs.
|
||||
|
|
@ -33,29 +33,29 @@ From this page, you can also shutdown the machine when you are done.
|
|||
|
||||
To shutdown the machine, first unlock the shutdown button by clicking on "Unlock Button".
|
||||
|
||||
|
||||
|
||||
|
||||
You can then click on "Shutdown". The machine will ask for a final confirmation and will then shut itself down.
|
||||
|
||||
|
||||
|
||||
|
||||
## Sample Tab
|
||||
|
||||
|
||||
|
||||
|
||||
In this page, you can enter all the information regarding the current sample you want to image. This includes the project name, the operator, but also the type of collection device you used.
|
||||
|
||||
|
||||
|
||||
|
||||
Depending on the device you choose, the page will change to reflect the needed information.
|
||||
|
||||
There is a mechanism of validation of the submitted data. Please be careful to use the format given in example for each input field.
|
||||
|
||||
|
||||
|
||||
|
||||
The GPS status block will give you the current information on the GPS fix and location, your direction and speed. This can be used to grab the location when in the field.
|
||||
|
||||
|
||||
|
||||
|
||||
Once all the fields are completed, you can go to the next tab by clicking the -> arrow. This will make sure all the inserted data is valid.
|
||||
|
||||
|
|
@ -63,7 +63,7 @@ Once all the fields are completed, you can go to the next tab by clicking the ->
|
|||
|
||||
This page allows you to control the optical setup of the acquisition.
|
||||
|
||||
|
||||
|
||||
|
||||
In the Optic Characterization block, you can control to turn the light on or not. You also have to choose the optics in use in the machine.
|
||||
|
||||
|
|
@ -82,7 +82,7 @@ As with all the tabs, once you are satisfied with your focus and your image sett
|
|||
|
||||
Finally, this is where the magic happens! You will be able to chose the final parameters of your capture.
|
||||
|
||||
|
||||
|
||||
|
||||
First of all, change the Fraction Size of your sample. You can then choose a unique ID for your acquisition, the number of pictures you want to take, the pumped volume (in between images), the delay to stabilize the image and the Flowcell thickness. All those settings will influence the Total imaged volume (the total volume captured during the acquisition) and the Total pumped volume.
|
||||
|
||||
|
|
@ -91,7 +91,7 @@ First of all, change the Fraction Size of your sample. You can then choose a uni
|
|||
|
||||
## Gallery
|
||||
|
||||
|
||||
|
||||
|
||||
This simple page will allow you to navigate the local directory of the machine and visualize the captured data.
|
||||
|
||||
|
|
@ -99,7 +99,7 @@ This simple page will allow you to navigate the local directory of the machine a
|
|||
|
||||
This tab allows you to monitor the physical characteristics of the machine and follow the processor load, CPU temperature, memory use and disk usage.
|
||||
|
||||
|
||||
|
||||
|
||||
You also can find information about the software version you are using, the machine name and its camera.
|
||||
|
||||
|
|
@ -121,7 +121,7 @@ Before purging the local data, make sure your data has been backed up at least t
|
|||
|
||||
## Wifi
|
||||
|
||||
|
||||
|
||||
|
||||
This page will give you information about the network the PlanktoScope is connected to. It will also allows you to connect your machine to a new WiFi network.
|
||||
|
||||
|
|
@ -139,7 +139,7 @@ Clicking on the button `Reset wifi networks` will erase ALL networks saved previ
|
|||
|
||||
## Administration
|
||||
|
||||
|
||||
|
||||
|
||||
On this page you can find the logs generated by the python script and also the [Danger Zone](https://www.youtube.com/watch?v=siwpn14IE7E).
|
||||
|
||||
|
|
@ -149,19 +149,19 @@ You should only touch here if you know what you are doing. The update process ca
|
|||
|
||||
After clicking on the button to launch the update, the script will first check that there is an available update.
|
||||
|
||||
|
||||
|
||||
|
||||
The script will then kill node-red, update its code and restart it.
|
||||
|
||||
|
||||
|
||||
The python script will also restart the python script.
|
||||
|
||||
|
||||
|
||||
Once the message displayed top right show "The segmenter is ready", you're good to go on the latest version!
|
||||
|
||||
|
||||
|
||||
## Hardware Configuration
|
||||
|
||||
|
||||
|
||||
|
||||
You can change the hardware settings of your machine here. If you use a Waveshare hat for the steppers, instead of the adafruit one, if you want to invert the stepper output (switch the stepper 1 with the stepper 2 for example) and the Steps per ml settings of the pump.
|
||||
|
|
|
|||
119
mkdocs.yml
|
|
@ -1,35 +1,118 @@
|
|||
---
|
||||
# SPDX-License-Identifier: CC-BY-SA-4.0
|
||||
|
||||
site_name: PlanktoScope
|
||||
site_description: An open and affordable imaging platform for \
|
||||
citizen oceanography
|
||||
site_url: http://PlanktoScope.github.io/PlanktoScope
|
||||
edit_uri: blob/master/docs
|
||||
repo_name: PlanktoScope/PlanktoScope
|
||||
repo_url: https://github.com/PlanktoScope/PlanktoScope
|
||||
|
||||
nav:
|
||||
- Setup:
|
||||
- Introduction:
|
||||
- Introduction: introduction.md
|
||||
- Specs: specs.md
|
||||
- Research: research.md
|
||||
- Hardware:
|
||||
- Circularity: build_workshops.md
|
||||
- Planktoscope HAT: hat_hardware.md
|
||||
- Assembly:
|
||||
- Assembly guide: images/assembly_guide.md
|
||||
- Trainer Notes: trainer_notes.md
|
||||
- Software:
|
||||
- Basic Install: easy_install.md
|
||||
- Create Master SD Card: create_sd.md
|
||||
- Expert Setup: expert_setup.md
|
||||
- Remote Access: remote_access.md
|
||||
- Assembly:
|
||||
- Assembly guide: assembly_guide.md
|
||||
- Usage:
|
||||
- Getting started: getting_started.md
|
||||
- User Interface: ui_guide.md
|
||||
- Collection devices: collection_devices.md
|
||||
- Hardware:
|
||||
- Planktoscope HAT: hat_hardware.md
|
||||
- Under the hood:
|
||||
- Internals:
|
||||
- Software architecture: software_architecture.md
|
||||
- MQTT Messages: mqtt_messages.md
|
||||
- Create Master SD Card: create_sd.md
|
||||
- Update the Device Tree: update_device-tree.md
|
||||
- Changelog:
|
||||
- Changelog: changelog.md
|
||||
- Usage:
|
||||
- Getting started: images/getting_started.md
|
||||
- User Interface: images/ui_guide.md
|
||||
- Collection devices: collection_devices.md
|
||||
- Community:
|
||||
- people: people.md
|
||||
- Community: community.md
|
||||
- Code of Conduct: code_of_conduct.md
|
||||
- Contribute:
|
||||
- Edit this documentation: edit_this_doc.md
|
||||
- Edit the code: edit_the_code.md
|
||||
- Hardware: hardware_development.md
|
||||
- Software: edit_the_code.md
|
||||
- Documentation: edit_this_doc.md
|
||||
- Protocols: protocols.md
|
||||
- About:
|
||||
- Changelog: changelog.md
|
||||
- License: license.md
|
||||
- Funding: funding.md
|
||||
- Contact: contact.md
|
||||
|
||||
theme:
|
||||
name: readthedocs
|
||||
logo: assets/logo-white.png
|
||||
locale: en
|
||||
name: material
|
||||
font:
|
||||
text: Roboto
|
||||
code: Roboto Mono
|
||||
features:
|
||||
- content.code.annotate
|
||||
- navigation.sections
|
||||
- navigation.expand
|
||||
- navigation.tabs
|
||||
- navigation.tabs.sticky
|
||||
- navigation.instant
|
||||
palette:
|
||||
- media: "(prefers-color-scheme: dark)"
|
||||
scheme: slate
|
||||
primary: indigo
|
||||
accent: indigo
|
||||
toggle:
|
||||
icon: material/weather-night
|
||||
name: Switch to light mode
|
||||
- media: "(prefers-color-scheme: light)"
|
||||
scheme: default
|
||||
primary: indigo
|
||||
accent: indigo
|
||||
toggle:
|
||||
icon: material/weather-sunny
|
||||
name: Switch to dark mode
|
||||
|
||||
plugins:
|
||||
- glightbox
|
||||
- charts
|
||||
|
||||
extra_javascript:
|
||||
- https://cdn.jsdelivr.net/npm/vega@5
|
||||
- https://cdn.jsdelivr.net/npm/vega-lite@5
|
||||
- https://cdn.jsdelivr.net/npm/vega-embed@6
|
||||
|
||||
extra:
|
||||
generator: false
|
||||
|
||||
markdown_extensions:
|
||||
- smarty
|
||||
- sane_lists
|
||||
- admonition
|
||||
- attr_list
|
||||
- md_in_html
|
||||
- sane_lists
|
||||
- smarty
|
||||
- tables
|
||||
- toc:
|
||||
permalink: true
|
||||
- pymdownx.details
|
||||
- pymdownx.superfences:
|
||||
custom_fences:
|
||||
- name: mermaid
|
||||
class: mermaid
|
||||
format: !!python/name:pymdownx.superfences.fence_code_format
|
||||
- name: vegalite
|
||||
class: vegalite
|
||||
format: !!python/name:mkdocs_charts_plugin.fences.fence_vegalite
|
||||
- pymdownx.emoji:
|
||||
emoji_index: !!python/name:materialx.emoji.twemoji
|
||||
emoji_generator: !!python/name:materialx.emoji.to_svg
|
||||
options:
|
||||
custom_icons:
|
||||
- overrides/.icons
|
||||
- pymdownx.tasklist:
|
||||
custom_checkbox: true
|
||||
|
|
|
|||