Giter Club home page Giter Club logo

deepgyro's Introduction

DeepGyro

Keras implementation of the deblurring method:
Gyroscope-Aided Motion Deblurring with Deep Networks [arXiv]

Testing

Download weights for DeepGyro from here and put them to the checkpoints folder. The weights for DeepBlind are also provided here.

To deblur images in the folder input/paper, execute:
python deepgyro.py -i input/paper

To deblur images with DeepBlind, execute:
python deepblind.py -i input/paper

Deblurring your own images

Before you can deblur your own images with DeepGyro, you need to compute gyro-based blur fields. You can use the code provided in the preprocess folder. Note that you will need gyroscope measurements, image timestamps, exposure times and some calibration information (see the next section). Once you have done this, put your data to the input/mydata folder and execute:

python deepgyro.py -i input/mydata

If you want to deblur images with DeepBlind, the blur fields are not needed. You can simply put your blurry images to input/mydata/blurred folder and execute:

python deepblind.py -i input/mydata

Make sure the folder structure is the same as in input/paper.

Generation of blur fields

You can generate your own blur fields by using the code in the preprocess folder. The raw input data is expected to be in the same format as the sample data in the preprocess/myrawdata folder. Generate blur fields using the command:

python generate.py -i myrawdata -o mydata

The output folder mydata can be moved to input folder to be processed by DeepGyro. Before you run generate.py on your data make sure to provide all necessary information as described in the following:

Blurry imagesmyrawdata/images/xxx.jpg
There can be more than one image. For example, you could capture a burst of images and deblur them all.

Image timestamps and exposure timesmyrawdata/images/images.txt
The text file images.txt should have the same number of lines as there are input images. Each line contains the timestamp and exposure time (in nanoseconds). Example line: 2705480529000 30000000.

Inertial measurementsmyrawdata/imu/imu.txt
The text file imu.txt contains inertial measurements including timestamps (in nanoseconds). Only gyroscope readings are required. The lines that start with “4” represent gyroscope. Example line: 4 358285205625 -1.5909724 -0.0620517 0.058423

Calibration informationcalibration.py
Update the calibration file calibration.py so that it corresponds to your setup. The file should include intrinsic camera parameters, camera readout time (rolling shutter skew), IMU-camera temporal offset and the rotation matrix that aligns the IMU frame with the camera frame.

Citation

If you find our code helpful in your research or work, please cite our paper.

@InProceedings{Mustaniemi_2019_WACV,
  author = {Mustaniemi, Janne and Kannala, Juho and Särkkä, Simo and Matas, Jiri and Heikkilä, Janne},
  title = {Gyroscope-Aided Motion Deblurring with Deep Networks},
  booktitle = {IEEE Winter Conference on Applications of Computer Vision (WACV)},
  month = {January},
  year = {2019}
}

deepgyro's People

Contributors

jannemus avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

deepgyro's Issues

Inference speed and memory usage

hi

I could not find inference speed info in the paper, does someone have some measurement to share?
Also, I see the weight file is pretty large (335Mb), so I assume the memory usage is large too, but does anyone have measurement to share on this too?

thanks

data generation tool for training

the paper mentioned "The data generation tool will be made publicly available upon the publication of the paper ", can you please share the data generation tool for training of deepgyro? Thanks a lot.

Dataset

Can you provide the link for the dataset(100k images) used for training the Deepgyro architecture?

Could you share your another deblurring paper Code ?

Hello, I have read your another paper , which is similar to DeepGyro, named "Fast Motion Deblurring for Feature Detection and
Matching Using Inertial Measurements". Could you share the Paper code? I want to learn how you implement it in code.

Question about method

Interesting method, but DeepBlind is not usually performs better than DeblurGAN in your proj samples. So, this may be not robust in reality?

Output images are not discernible

I follow the readme to test the effect in paper,but i got this.
car
bridge
could you please tell me how to transform this image to the natural image,Thanks!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.