In conjunction with the OpenWorm Foundation and Orthogonal Research and Education Lab
Hello, contributors! 🎃 Welcome to our Hacktoberfest project. We're aiming to annotate a dataset of C. elegans images to fine-tune the Detection 2 model and SAM segmentation for an upcoming GSoC project. Your contribution will play a pivotal role in advancing research in this area.
images/
: Contains the C. elegans images.segmentation_maps/
: Contains the segmentation maps for the images.data.csv
: A CSV file listing the image file names.
We need bounding boxes around each C. elegans cell in the images. dataset link, csv_file link
- Bounding Box: The bounding box should tightly enclose the cell without cutting any part of it.
- Overlapping Cells: In cases where cells overlap, draw individual bounding boxes for each visible cell.
- Avoid Background: Ensure that the bounding box only contains the cell and as little background as possible.
For this project, we'll be using the open-source tool MakeSense.
- Visit MakeSense.
- Click on
Upload Images
and select the C. elegans images you want to annotate. - Define a label, e.g., "C. elegans cell".
- Start drawing bounding boxes following the guidelines provided.
- Once done, click on the
Export
button and select theCOCO (JSON)
format. - Save the exported JSON annotations locally.
- Fork this repository.
- Clone your forked repository to your local machine.
- Create an Issue: Before starting the annotation, create an issue in the main repository indicating that you're taking up 10 images for annotation. Mention the exact image names in the order they appear in
data.csv
to ensure clarity and avoid overlapping work. - Pick the next 10 images in order from the
data.csv
that haven't been annotated yet. - Annotate the images using MakeSense and the guidelines provided.
- Save the annotations in COCO JSON format.
- Create a new folder with your name (e.g.,
JohnDoe/
). Inside this folder, create two subfolders:images/
andannotations/
. - Place the annotated images in the
images/
folder and the COCO JSON annotations in theannotations/
folder. - Update the
data.csv
file by adding your name next to the images you've annotated. - Commit your changes with a meaningful commit message.
- Push your changes to your forked repository.
- Create a Pull Request to the main repository with a title like "Annotations by [Your Name]". In the PR description, mention
Close #[Issue Number]
to link and close the issue you created. - Once your PR is reviewed and merged, you can pick another set of images to annotate if you wish!
- Every valid PR will count towards your Hacktoberfest contributions.
- Top contributors will be acknowledged in the project's documentation and chance for the upcoming gsoc project.
If you have any questions or face any issues, please open an issue in this repository, and we'll get back to you as soon as possible.
Happy annotating and happy Hacktoberfest! 🍂🎉
Watch this video on Detectron 2 link