Bakalářská práce 2022/2023
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Rostislav Lán bddb354ef5
Split init method, added docstrings, prepared for stl model conversion.
2 years ago
config Modified config file for parameter input. 2 years ago
res Found a good representative filtered picture. 2 years ago
src Split init method, added docstrings, prepared for stl model conversion. 2 years ago
.gitignore Added before/after pictures to README.md 2 years ago
README.md Updated README.md. 2 years ago

README.md

About this Project

This project is being developed as a practical part of bachelor's thesis at Brno Universtiy of Technology - Faculty of Information Studies. It is as of now a work in progress, no results guaranteed.

The topic of this thesis is Generating a 3D Fingerprint Model. This application can be used to apply series of image processing filters to a fingerprint image to make it more suitable for conversion to 3D stl model and printing. It should also have the functionality to convert the image to stl lithophane and map it to a 3d finger model.

Prerequisites

For now this is only viable for ubuntu gnu/linux machines Before cloning repository, you need these to succesfully use the application.

  • python version 3.10 is a requirement might work on earlier python 3 versions

        apt install python3.10
    
  • python graphical modules

        pip install numpy matplotlib pillow
    

Installation

Installation is relatively fast and easy.

  1. Clone the repository

        git clone ssh://git@strade.fit.vutbr.cz:3022/xlanro00/BP_DP-xlanro00.git
    
  2. Prepare an image file containing fingerprint

  3. Run the application

Usage

There are two ways to enter filter series

  • manually from command line, list filter names and parameters will be added later
        python src/main.py res/test_fp.png res/test_fp_cpy.png 100 gaussian erode dilate sharpen
    
  • manually from preset saved in a json config file, that can be used to create new presets
        python src/main.py res/test_fp.png res/test_fp_cpy.png 100 --config config/config.json default
    

Configuration

There is an option to input the filter series as a preset to json configuration file.

{
    "preset_name": [
        "filter_1",
        "filter_2",
        "filter_3"
    ]
}

Comparison

Image before processing the fingerprint and after applying a presets.

Before After

Generated STL lithophane

This section will be added later. It will describe the process of converting the fingerprint image data to 3D stl lithophane.

Roadmap

  • Load and store image
  • Apply basic image processing filters
    • Scale the image using given dpi
  • Create filter library with more filters
    • Add more suitable filters to the library
  • Use presets from config files
    • Add the option to save current filter presetto config file
  • Add the option to modify filter parameters
  • Convert the processed image to stl lithophane
    • Add the option to map the lithophane on a finger model
  • Export final model ready for 3D print

Author

Rostislav Lán - xlanro00@stud.fit.vutbr.cz

Supervisor

Ing. Petr Malaník

Project Link: https://strade.fit.vutbr.cz/git/xlanro00/BP_DP-xlanro00