Giter Club home page Giter Club logo

unet-instance-cell-segmentation's Introduction

UNet for Instance Cell Segmentation on Pytorch

This project aims to perform well at instance segmentation on the BBBC006 cells dataset. We tested UNet over several configurations including the loss function, evaluation function and the datasets.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

Running the Training and Validation

For running the training you will use the main.py file. In case you're using a sort of cluster, you should see pbs_unet.pbs. In either case, the options for configuration are the same.

Options for configuration

Options:
  -h, --help            Show this help message and exit
  -e EPOCHS, --epochs=EPOCHS
                        Number of epochs
  -b BATCHSIZE, --batch-size=BATCHSIZE
                        Batch size
  -l LR, --learning-rate=LR
                        Learning rate
  -a LOAD, --load=LOAD  Load model file
  -r RUNS, --runs=RUNS  How many runs
  -d DATASET, --dataset=DATASET
                        Which dataset should use.
  -g GT, --groundtruth=GT
                        Which gt should use.
  -s SAVEDIR, --savedir=SAVEDIR
                        Which folder should use for checkpoints.
  -t VAL_PERC, --val-percentage=VAL_PERC
                        Validation Percentage
  -i N_CHANNELS, --n-channels=N_CHANNELS
                        Number of channels of the inputs.
  -c N_CLASSES, --n-classes=N_CLASSES
                        Number of classes of the output.
  -o OPTIMIZER, --optimizer=OPTIMIZER
                        Optimizer to use.
  -f LOSS, --loss=LOSS  Loss functios to use.
  -v EVALUATION, --evaluation=EVALUATION
                        Evaluation function to use.

If you want to use another optimizer or loss/evaluation function you must code it on main.py

Running the Visualization of Results

For running the visualizations you will use the visualization folder.

Show Visualization

If you want to see how a trained model performs out, you should use the result_visualization.py file. These report will create an image of the performance (Loss, Accuracy), an image of the outputs of the model and an image of the gt to compare.

Options for configuration

Options:
  -h, --help            Show this help message and exit
  -f FOLDER, --folder=FOLDER
                        Folder containing the csv files.
  -t TITLE, --title=TITLE
                        Title of the plot
  -i N_CHANNELS, --n-channels=N_CHANNELS
                        Number of channels of the inputs.
  -c N_CLASSES, --n-classes=N_CLASSES
                        Number of classes of the output.
  -l LOAD, --load=LOAD  Path and name of the load file.
  -d DATASET, --dataset=DATASET
                        Dataset for the inputs.
  -g GT, --gt=GT        Gt to compare.

Compare two Trained Models

If you want to show how the model performs out compared with another one, you should use the compare_two_results.py file. These report will create an image of the performance (Loss, Accuracy) of both models.

Options for configuration

Options:
  -h, --help            Show this help message and exit
  -f FOLDER, --folder=FOLDER
                        Folder containing the first to compare csv files.
  -c F_COMPARE, --folder_compare=F_COMPARE
                        Folder containing the second to compare csv files.
  -t TITLE, --title=TITLE
                        Title of the plot
  -s SAVEDIR, --savedir=SAVEDIR
                        Which folder should use for saving the results.

Authors of the Code

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • All of the UNet implementations that cross into my way.
  • Jose Carranza - maeotaku - for helping in the misc files.

unet-instance-cell-segmentation's People

Contributors

mamemo avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.