jgraving / unet-tensorflow-keras

A concise code for training and evaluating Unet using tensorflow+keras

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Unet-tensorflow-keras

A concise code for training and evaluating Unet using tensorflow+keras

A simple practice of the mixture usage of tensorflow and keras for the segmentation task. Sometime using Keras to manage the training is not flexiable. But we still want to utilize the convenience of Keras to build the model. Using Keras to build the model is super easy and fully compatible with Tensorflow. See https://blog.keras.io/keras-as-a-simplified-interface-to-tensorflow-tutorial.html for an introduction.

I use the Unet architecture and modify its unsampling part to automatically adjust the feature map width and height when merge (concat) with previous layers. In this way, we do not need to compute the specific input size to fit the model but take an arbitrary size.

UPDATE, July 2017:

  • Change the code to fit Tensorflow > 1.0
  • Adding a loader file to use Keras generator to load image and mask with automatic augmentation
  • Adding a VIS module to manage the evaluation metric.
  • Adding opt.py to support easier use

Usage

  • See loader.py to organize your train/test data hierarchy

  • Set necessary hpyerparameters and run train.py

    python train.py --data_path ./datasets/your_dataset_folder/ --checkpoint_path ./checkpoints/unet_example/
  • Visualize the train loss, dice score, learning rate, output mask, and first layer convolutional kernels per iteration in tensorboard

    tensorboard --logdir=train_log/
    
  • When checkpoints are saved, you can use eval.py to test an input image with an arbitrary size.

  • Evaluate your model

    python eval.py --data_path ./datasets/your_dataset_folder/ --load_from_checkpoint ./checkpoints/unet_example/model-0 --batch_size 1

About

A concise code for training and evaluating Unet using tensorflow+keras


Languages

Language:Python 100.0%