1. Package Requirement: 
- pathlib
- tqdm 
- numpy 
- scipy 
- scikit-image 
- scikit-learn
- matplotlib
- torch
- timm
- Pillow
- imageio

All packages can be installed using pip (e.g. "pip install pathlib"). 


2. Required dataset 
- The GTF dataset can be downloaded at https://www.martimbrandao.com/friction-from-vision/


3. Expected project directory strcucture:

ProjectRoot/
    project.py                 # code for main experiment
    intermediate_results.py    # code for producing sample images used in the experiment
    friction-from-vision/
        GTF/
            dataset.mat        # GTF metadata (ROIs, friction values, file names)
            images/
                <original images from GTF>
                <*_cropped.jpg ROI crops> 
    residual_plots/            # Automatically created; residual plots are saved here
    Intermediate_Reslts        # Automatically created; sample images produced by intermediate_results.py are saved here


4. How to run
- change the PROJECT_DIR variable in project.py as needed
- the for this project was developed on a Windowse 11 machine. If running on Linux/MacOS, update all path variables in project.py and intermediate_results.py accordingly.
- run "python project.py" 
- run "python intermediate_results.py"



