pytorch-hed

Python Package reimplementation of Holistically-Nested Edge Detection in PyTorch

View the Project on GitHub Davidelanz/pytorch-hed

Pytorch Holistically-Nested Edge Detection (HED)

CodeFactor Documentation Status travisCI codecov Pypi

This is a reimplementation in the form of a python package of Holistically-Nested Edge Detection [1] using PyTorch based on the previous pytorch implementation by sniklaus [2]. If you would like to use of this work, please cite the paper accordingly. Also, make sure to adhere to the licensing terms of the authors. Moreover, if you will be making use of this particular implementation[3], please acknowledge it.

Paper

  GitHub Ref
Original version based on Caffe https://github.com/s9xie/hed [1]
Another reimplementation based on Caffe https://github.com/zeakey/hed  
Original reimplementation based on PyTorch https://github.com/sniklaus/pytorch-hed [2]

Usage

First, you have to install the package (stable) with

pip install pytorch-hed

or, for the current (unstable) version

pip install git+https://github.com/Davidelanz/pytorch-hed.git

Usage:

import torchHED
   
# process a single image file 
torchHED.process_file("./images/sample.png", "./images/sample_processed.png")

# process all images in a folder
torchHED.process_folder("./input_folder", "./output_folder")

# process a PIL.Image loaded in memory and return a new PIL.Image
# img = PIL.Image.open("./images/sample.png")
img_hed = torchHED.process_img(img)

Results

Input Original Caffe Implementation [1] pytorch-hed [3]
sample sample sample

References

[1]  @inproceedings{Xie_ICCV_2015,
         author = {Saining Xie and Zhuowen Tu},
         title = {Holistically-Nested Edge Detection},
         booktitle = {IEEE International Conference on Computer Vision},
         year = {2015}
     }
[2]  @misc{pytorch-hed,
         author = {Simon Niklaus},
         title = {A Reimplementation of {HED} Using {PyTorch}},
         year = {2018},
         howpublished = {\url{https://github.com/sniklaus/pytorch-hed}}
    }
[3]  @misc{pytorch-hed-2,
         author = {Davide Lanza},
         title = {The {pytorch-hed} Python Package},
         year = {2020},
         howpublished = {\url{https://github.com/Davidelanz/pytorch-hed}}
    }