CONDOR pytorch implementation for ordinal regression with deep neural networks.
Documentation: https://GarrettJenkinson.github.io/condor_pytorch
About
CONDOR, short for CONDitionals for Ordinal Regression, is a method for ordinal regression with deep neural networks, which addresses the rank inconsistency issue of other ordinal regression frameworks.
It is compatible with any state-of-the-art deep neural network architecture, requiring only modification of the output layer, the labels, the loss function.
This repository implements the CONDOR functionality (neural network layer, loss function, and dataset utilities) for convenient use. Examples are provided via the "Tutorials" that can be found on the documentation website at https://GarrettJenkinson.github.io/condor_pytorch.
We also have CONDOR implemented for Tensorflow.
Installation or Docker
You can install the latest stable release of condor_pytorch directly from Python's package index via pip by executing the following code from your command line:
pip install condor-pytorch
We also provide Dockerfile's to help get up and started quickly with condor_pytorch. The cpu image can be built and ran as follows, with tutorial jupyter notebooks built in.
# Create a docker image, only done once
docker build -t cpu_pytorch -f cpu.Dockerfile ./
# run image to serve a jupyter notebook
docker run -it -p 8888:8888 --rm cpu_pytorch
# how to run bash inside container (with python that will have deps)
docker run -u $(id -u):$(id -g) -it -p 8888:8888 --rm cpu_pytorch bash
An NVIDIA based gpu optimized container can be built and run as follows (without interactive ipynb capabilities).
# only needs to be built once
docker build -t gpu_pytorch -f gpu.Dockerfile ./
# use the image after building it
docker run -it -p 8888:8888 --rm gpu_pytorch
Cite as
If you use CONDOR as part of your workflow in a scientific publication, please consider citing the CONDOR repository with the following DOI:
@article{condor2021,
title = "Universally rank consistent ordinal regression in neural networks",
journal = "arXiv",
volume = "2110.07470",
year = "2021",
url = "https://arxiv.org/abs/2110.07470",
author = "Garrett Jenkinson and Kia Khezeli and Gavin R. Oliver and John Kalantari and Eric W. Klee",
keywords = "Deep learning, Ordinal regression, neural networks, Machine learning, Biometrics"
}
1 Jul 31, 2022
21.8k Jan 9, 2023
450 Dec 28, 2022
80 Sep 17, 2022
35 Nov 25, 2022
![[TIP 2021] SADRNet: Self-Aligned Dual Face Regression Networks for Robust 3D Dense Face Alignment and Reconstruction](https://github.com/MCG-NJU/SADRNet/raw/main/data/output/30904b202ac883bc14e59c1225c9316c.gif)
99 Dec 30, 2022
11 Dec 16, 2022
1 Dec 2, 2021
2 Aug 1, 2022
8 Apr 03, 2022
12 Nov 11, 2022
85 Dec 15, 2022
104 Jan 01, 2023
68 Dec 26, 2022
36 Nov 23, 2022
3.2k Dec 23, 2022
58 Jan 02, 2023
2.1k Dec 29, 2022
10 Mar 10, 2022
115 Nov 23, 2021
413 Dec 31, 2022
42 Nov 03, 2022
20 Nov 28, 2022
1.5k Dec 30, 2022
2 Dec 28, 2021
2 Oct 21, 2021
61 Jan 01, 2023
137 Dec 13, 2022
8 Mar 31, 2022