Skip to content
View hyp-nerf's full-sized avatar

Block or report hyp-nerf

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
hyp-nerf/README.md

πŸš€HyP-NeRF: Learning Improved NeRF Priors using a HyperNetwork

NeurIPS 2023

Bipasha Sen* 1 Gaurav Singh* 1, Aditya Agarwal* 1, Rohith Agaram 1, Madhava Krishna 1, Srinath Sridhar 2

*denotes equal contribution, 1 International Institute of Information Technology Hyderabad, 2 Brown University

applications_teaser.mp4

This is the official implementation of the paper "HyP-NeRF: Learning Improved NeRF Priors using a HyperNetwork" accepted at NeurIPS 2023

πŸ‘‰ TODO

  • Release pretrained checkpoints.
  • Code Release
    • Training Code
    • Architecture modules, renderer, Meta MRHE
  • ...

CREATING THE ENVIRONMENT

Please follow the steps outlined in torch-ngp repository for creating the environment upto and including the Build extension subheading.

Dataset

Download the ABO Dataset. We use the images and the transforms from abo-benchmark-material.tar and the metadata file abo-listings.tar for training. Place them in a directory structure as follows:

dataset_root
β”œβ”€β”€ ABO_rendered
β”‚   β”œβ”€β”€ B00EUL2B16
β”‚   β”œβ”€β”€ B00IFHPVEU
β”‚   ...
β”‚
└── ABO_listings
  └── listings
      └── metadata
       Β Β  β”œβ”€β”€ listings_0.json.gz
          ...
       Β Β  └── listings_f.json.gz

Training

To train a model on the ABO dataset run the following command:

CUDA_VISIBLE_DEVICES=0 python main_nerf.py <dataset_root> --workspace <workspace dir> --bound 1.0 --scale 0.8 --dt_gamma 0 --class_choice CHAIR --load_ckpt

Testing

To render a specific NeRF from the codebook, run the following command:

CUDA_VISIBLE_DEVICES=0 python main_nerf.py <dataset_root> --workspace <workspace dir containing the pretrained ckpt> --bound 1.0 --scale 0.8 --dt_gamma 0 --class_choice CHAIR --load_ckpt --test --test_index <index of codebook>

πŸ‘ Acknowledgement

Some parts of the code are inspired and borrowed from torch-ngp (which we use as our backbone) and INR-V. We thank the authors for providing the source code.

πŸ“œ BibTeX

If you find HyP-NeRF useful in your work, consider citing us.

@article{hypnerf2023,
  title={HyP-NeRF: Learning Improved NeRF Priors using a HyperNetwork},
  author={Sen, Bipasha and Singh, Gaurav and Agarwal, Aditya and Agaram, Rohith and Krishna, K Madhava and Sridhar, Srinath},
  journal={NeurIPS},
  year={2023}
}

Popular repositories Loading

  1. HyP-NeRF HyP-NeRF Public

    Code Implementation for HyP-NeRF

    Python 19 3

  2. hyp-nerf.github.io hyp-nerf.github.io Public

    Forked from nerfies/nerfies.github.io

    Project Page for HyP-NeRF

    JavaScript