README

The Python Script contains scripts used in the Mask R-CNN project. Some scripts are from the Matterport RMask R-CNN repo  (https://github.com/matterport/Mask_RCNN), some are from the ImmersiveLimit repo (https://github.com/akTwelve/cocosynth) and others are original. Most scripts have been modified or tweaked for this project so it is best to work with these modified versions for the most faithful reproduction of our results.
The Notebooks folder cotains creating image dataset and annotations.

Thanks to the team member Tamer Abousoud, who is a big help on creating dataset. 

Folder:
---------
mrcnn folder is required for running the neural network. The scripts here slightly modified from their original for our model. This can replace or be added alongside an existing Matterport M-RCNN installation but paths will need updating.

Files:
-------

RunMaskRCNN.py - configure and train the network

MaskRCNN_Inference.py - run inference on trained network

compose_images_proj.py - script from Immersive Limit to create synthetic images (modified considerably)

coco_json_utils_proj.py - script from Immersive Limit for create a COCO instances .json file (modified considerably)

coco_create_subset.py - original script to create a COCO instances .json file when generating random subsets of synthetic images. The Jupyter notebook provides a clearer illustration.

img_process.py - original script of various image processing and annotating techniques. Some parts are unfinished/abandoned. More of a playground for experimentation.

COCOapi_Test.py - script for trying out the original `pycocotools` COCO api. Same as in Jupyter Notebook.