updated readme docs

This commit is contained in:
Sebastian Wendel 2023-01-19 15:05:23 +01:00
parent 5b3e36b060
commit 1ff358a24e
No known key found for this signature in database
GPG key ID: 14ED8B1EC3371ECE
5 changed files with 51 additions and 39 deletions

View file

@ -1,67 +1,79 @@
<!-- # PlanktoScope: Open and Affordable Quantitative Imaging Platform
SPDX-License-Identifier: CC-BY-SA-4.0
-->
# An open and affordable imaging platform for citizen oceanography ![planktoscope_hero](docs/images/project_description/planktoscope_hero.png)
| | | ## What are Plankton?
| --- | --- |
| CI/CD | [![CI - Test](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/test.yml/badge.svg)](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/test.yml) [![CD - Build](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/build.yml/badge.svg)](https://github.com/PlanktoScope/PlanktoScope/actions/workflows/build.yml) |
| Package | [![PyPI - Version](https://img.shields.io/pypi/v/planktoscope.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/planktoscope/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/planktoscope.svg?logo=python&label=Python&logoColor=gold)](https://pypi.org/project/planktoscope/) |
| Meta | [![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch) [![code style - black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![types - Mypy](https://img.shields.io/badge/types-Mypy-blue.svg)](https://github.com/ambv/black) [![imports - isort](https://img.shields.io/badge/imports-isort-ef8336.svg)](https://github.com/pycqa/isort) [![License - GPL](https://img.shields.io/badge/license-GPL-blue.svg)](<https://spdx.org/licenses/>) |
![PlanktoScope Render](docs/images/readme/planktoscope_cad.webp) _"Drifting endlessly, midway between the sea of air above and the depths of the abyss below, these strange creatures and the marine inflorescence that sustains them are called 'plankton' — the wanderers"_ - **Rachel Carson**
![Plankton collage](docs/images/readme/plankton_collage.webp)
## What is this? Plankton are tiny organisms that drift in the oceans and play a crucial role in the global ecosystem. They are responsible for fixing 30-50% of the world's carbon dioxide and form the foundation of the global food chain. Despite their importance, studying plankton can be challenging due to the vast area of the oceans and the limited resources of research fleets and specialized equipment. The PlanktoScope is an open-source hardware and software platform that aims to make it easier to study plankton by providing high-throughput quantitative imaging capabilities at a low cost.
The PlanktoScope is an open-source, affordable imaging platform for citizen oceanography. It's built around a Raspberry Pi, a couple of HATs, some stepper motors and a few centimeters of silicon tubes. Its cost is at about $500 in parts. ![planktoscope_hero](docs/images/project_description/planktoscope_architecture.png)
The goal of the PlanktoScope is to allow citizen to engage in scientific programs, either at sea or onshore. You can use the PlanktoScope to image the different species of Plankton living in a body of water. ## What is a PlanktoScope?
## Get the papers The PlanktoScope is a modular, open-source platform for high-throughput quantitative imaging of plankton samples. Its small size, ease of use, and low cost make it suitable for a variety of applications, including the monitoring of laboratory cultures or natural micro-plankton communities. It can be controlled from any WiFi-enabled device and can be easily reconfigured to meet the changing needs of the user.
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). [Learn more about how it works](https://www.planktoscope.org/how-it-works)
| [![PlanktoScope Preprint](docs/images/readme/planktoscope_pub.webp)](https://www.biorxiv.org/content/10.1101/2020.04.23.056978v1) | [![PlanktonPlanet Preprint](docs/images/readme/planktonplanet_pub.webp)](https://www.biorxiv.org/content/10.1101/2020.08.31.263442v1) | ## Read the Paper
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
The PlanktoScope has been described in the article ["PlanktoScope: Affordable Modular Quantitative Imaging Platform for Citizen Oceanography"](https://www.frontiersin.org/articles/10.3389/fmars.2022.949428/full), published in Frontiers in Marine Science in July 2022.
DOI: [https://doi.org/10.3389/fmars.2022.949428](https://doi.org/10.3389/fmars.2022.949428)
## Key Features ## Key Features
- Image small animals and algae living in water Here are some key features of the PlanktoScope:
- Focus stage control
- Pump control
- Automatic image capture
- Automatic segmentation
## How do I build one? 1. **Low cost**: The PlanktoScope is designed to be affordable, with parts costing under $1000.
2. **Modular**: The PlanktoScope is modular, meaning it can be easily reconfigured to meet the changing needs of users.
3. **Open-source**: The PlanktoScope is based on open-source hardware and software, making it accessible to a wide community of engineers, researchers, and citizens.
4. **Versatility**: The PlanktoScope is versatile, and can be used to study a variety of plankton types, including laboratory cultures and natural micro-plankton communities.
5. **High-throughput**: The PlanktoScope is capable of high-throughput quantitative imaging, allowing users to analyze large numbers of samples quickly and efficiently.
6. **WiFi-enabled**: The PlanktoScope can be controlled from any WiFi-enabled device, making it easy to use and deploy in a variety of settings.
7. **Portable**: The PlanktoScope is small and portable, making it easy to transport and use in the field.
8. **Ease of use**: The PlanktoScope is designed to be easy to use, with instructions for assembly and use available on the PlanktoScope website.
## How do I get one?
You can access the complete documentation on [Read The Docs](https://planktonscope.readthedocs.io/). You can access the complete documentation on [Read The Docs](https://planktonscope.readthedocs.io/).
|Get the kit|Assemble your kit|Start your machine|
|--|--|--|
|![Get the kit](docs/images/readme/get_kit.png)|![Assemble your kit](docs/images/readme/assemble_kit.png)|![Start your machine](docs/images/readme/start_pscope.png)|
## How do I get involved? ## Getting Involved
There are several ways to join the development effort, share your progress with your build or just ask for help. There are several ways you can join the development effort and contribute to this project.
We are using slack as a communication platform between interested parties. You can [request to join by filling this form](https://docs.google.com/forms/d/e/1FAIpQLSfcod-avpzWVmWj42_hW1v2mMSHm0DAGXHxVECFig2dnKHxGQ/viewform). ### Communication Platform
This repository is also a good way to get involved. Please fill in an issue if you witnessed a bug in the software or hardware. If you are able, you can also join the development effort. Look through the [issues opened](https://github.com/PlanktonPlanet/PlanktoScope/labels/good%20first%20issue) and choose one that piques your interest. Let us know you want to work on it in the comments, we may even be able to guide your beginnings around the code. We use Slack as a communication platform for interested parties. You can request to join by filling out [this form](https://docs.google.com/forms/d/e/1FAIpQLSfcod-avpzWVmWj42_hW1v2mMSHm0DAGXHxVECFig2dnKHxGQ/viewform).
## License: Our work is fully open source ### Reporting Issues
Depending on the material they cover, different licenses apply to the files of this repository. If you have identified a bug in the software or hardware, please open an issue in this repository to report it.
If you make any change for your use, please fork this repository and publish your improvements. It will help others, and we can integrate those changes in this repository if needed. ### Contributing to Development
Also, all licenses are contaminating, if you want to use any of this material for a project that you cannot open-source, please contact us using Slack so we can see what can be done to help you and your project. You can also contribute to the development effort by working on open issues. Check out the [issues labeled as good first issues](https://github.com/PlanktoScope/PlanktoScope/labels/good%20first%20issue) and let us know in the comments if you are interested in working on one. We may be able to provide guidance as you get started with the code.
## Hardware files ## License Information
All hardware files and documentation (everything in the `hardware` directory) is released under a [CERN-OHL-S-2.0 license](https://ohwr.org/cern_ohl_s_v2.txt). This repository contains various types of materials that are covered by different licenses. Please read the following information carefully to determine which license applies to the materials you wish to use.
## Software source ### Hardware Files
The source code (everything in the directories `flows` and `scripts`) is released under a [GPL-3.0 license](https://www.gnu.org/licenses/gpl-3.0.en.html). All hardware files and documentation located in the `hardware` directory are released under the [CERN-OHL-S-2.0](https://ohwr.org/cern_ohl_s_v2.txt) license.
## Everything else (documentation, pictures, etc...) ### Software Source Code
Everything else is released under a [Creative Commons CC-BY-SA license](https://creativecommons.org/licenses/by-sa/4.0/). The source code located in the `flows` and `scripts` directories is released under the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.en.html) license.
### Other Materials
All other materials, including documentation and pictures, are released under the [Creative Commons CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) license.
If you wish to use any of the materials in this repository for a project that cannot be open-sourced, please contact us using Slack so we can discuss potential solutions.
We encourage you to fork this repository and publish any improvements you make. Doing so helps others and allows us to potentially integrate your changes into this repository.

Binary file not shown.

After

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 63 KiB

View file

@ -1,4 +1,4 @@
# Open and frugal modular imaging platform for citizen oceanography # PlanktoScope: Open and Affordable Quantitative Imaging Platform
![planktoscope_hero](images/project_description/planktoscope_hero.png) ![planktoscope_hero](images/project_description/planktoscope_hero.png)