Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
    Links to: sciencedirect.com
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.1%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: DIAGNijmegen
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: master
  • Size: 12.1 MB
Statistics
  • Stars: 57
  • Watchers: 4
  • Forks: 11
  • Open Issues: 4
  • Releases: 1
Created about 5 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md

HookNet - multi-resolution convolutional neural networks for semantic segmentation


Install

pip install hooknet

Dependencies

This code has been tested on Ubuntu 18.04, python==3.8, tensorflow-gpu==2.3.0

Examples and Docs

Please see HookNet - practical guide for an example on how to train/apply HookNet.

Additional Information

Paper

This model is presented in our paper:

HookNet: Multi-resolution convolutional neural networks for semantic segmentation in histopathology whole-slide images

If you use this code, please cite the paper:

@article{VANRIJTHOVEN2021101890, title = {HookNet: Multi-resolution convolutional neural networks for semantic segmentation in histopathology whole-slide images}, journal = {Medical Image Analysis}, volume = {68}, pages = {101890}, year = {2021}, issn = {1361-8415}, doi = {https://doi.org/10.1016/j.media.2020.101890}, url = {https://www.sciencedirect.com/science/article/pii/S1361841520302541}, author = {Mart {van Rijthoven} and Maschenka Balkenhol and Karina Siliņa and Jeroen {van der Laak} and Francesco Ciompi}, keywords = {Computational pathology, Semantic segmentation, Multi-resolution, Deep learning}, abstract = {We propose HookNet, a semantic segmentation model for histopathology whole-slide images, which combines context and details via multiple branches of encoder-decoder convolutional neural networks. Concentric patches at multiple resolutions with different fields of view, feed different branches of HookNet, and intermediate representations are combined via a hooking mechanism. We describe a framework to design and train HookNet for achieving high-resolution semantic segmentation and introduce constraints to guarantee pixel-wise alignment in feature maps during hooking. We show the advantages of using HookNet in two histopathology image segmentation tasks where tissue type prediction accuracy strongly depends on contextual information, namely (1) multi-class tissue segmentation in breast cancer and, (2) segmentation of tertiary lymphoid structures and germinal centers in lung cancer. We show the superiority of HookNet when compared with single-resolution U-Net models working at different resolutions as well as with a recently published multi-resolution model for histopathology image segmentation. We have made HookNet publicly available by releasing the source code11https://github.com/computationalpathologygroup/hooknet as well as in the form of web-based applications22https://grand-challenge.org/algorithms/hooknet-breast/.,33https://grand-challenge.org/algorithms/hooknet-lung/. based on the grand-challenge.org platform.} }

Pre-trained models

A pretraind model on breast or lung can be applied via https://grand-challenge.org/. Please create an user account and request access to an algorithm if you are interested.

You can try out a pretrained HookNet on breast tissue here:
https://grand-challenge.org/algorithms/hooknet/

You can try out a pretrained HookNet on lung tissue here:
https://grand-challenge.org/algorithms/hooknet-lung/

Acknowledgements

Created in the #EXAMODE project

Owner

  • Name: Diagnostic Image Analysis Group
  • Login: DIAGNijmegen
  • Kind: organization
  • Location: Radboud University Medical Center, Nijmegen, The Netherlands

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: Mart
    given-names: van Rijthoven
title: HookNet
version: v0.1.0-alpha
doi: 10.5281/zenodo.7559001
date-released: 2023-01-22

GitHub Events

Total
  • Issues event: 1
  • Watch event: 8
  • Issue comment event: 2
  • Fork event: 1
Last Year
  • Issues event: 1
  • Watch event: 8
  • Issue comment event: 2
  • Fork event: 1

Dependencies

docs/requirements.txt pypi
  • ipython *
  • jupyter *
  • jupytext *
  • myst-parser *
  • nbsphinx *
  • numpy *
  • pydata_sphinx_theme *
  • sphinx *
  • sphinx-autodoc-typehints *
  • sphinxcontrib-napoleon *
  • tensorflow-gpu *
requirements.txt pypi
  • numpy ==1.20.2
  • tensorflow_gpu ==2.3.0
setup.py pypi
  • numpy >=1.20.2
.github/workflows/docs.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • peaceiris/actions-gh-pages v3 composite
os-level-virtualization/docker/Dockerfile docker
  • tensorflow/tensorflow latest-gpu build