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.
Jim Martens 08976dad82 Added required info for successful installation 4 months ago
.github/ISSUE_TEMPLATE Moved templates to correct location 10 months ago
src Completed documentation 10 months ago
.editorconfig Added editorconfig 1 year ago
.gitignore Added _env to gitignore 10 months ago
.gitmodules Added ssd_keras sub-module 1 year ago
LICENSE Improved formatting of LICENSE file 1 year ago
MANIFEST.in Added pycocotools as dependency 1 year ago
README.md Added required info for successful installation 4 months ago
pyproject.toml Added pyproject file 4 months ago
requirements.txt Added attributedict to dependencies 11 months ago
setup.py Added required info for successful installation 4 months ago
sonar-project.properties Added SonarQube project properties 11 months ago

README.md

Master Thesis

Allows reproduction of results in my master thesis.

Downloads License Python versions

The package supports testing and evaluating SSD and Bayesian SSD. The results can be visualised.

Installation

Please install python header files of your Python version. Those are needed to compile the pycocotools with Cython upon installation.

pip install twomartens.masterthesis
pip install 'git+https://github.com/philferriere/cocoapi.git#egg=pycocotools&subdirectory=PythonAPI'

The second line is important as Git dependencies cannot be specified in the setup.py file.

Please refer to GPU support for instructions on installing the non-Python dependencies for tensorflow.

Type the following to create the configuration file and to see the options:

tm-masterthesis config list

Especially the paths have to be set to the correct values.

Usage example

tm-masterthesis --help

Lists all available commands. As most commands are nested, it is advisable to request the help at different nesting levels.

tm-masterthesis config {get,set,list}

Allows for the modification and retrieval of the configuration values.

tm-masterthesis test {ssd,bayesian_ssd} iteration train_iteration

Tests the selected network, using iteration as identifier for the test run and train_iteration as identifier for the training iteration. If the config parameter ssd_test_pretrained is True then the training iteration is not relevant.

tm-masterthesis evaluate {ssd,bayesian_ssd} iteration

Runs the evaluation process using the test results identified by iteration, evaluation results are saved under iteration under the evaluation path.

tm-masterthesis visualise_metrics {ssd,bayesian_ssd} iteration

Uses the evaluation results stored under iteration and visualises it. The score JSON and the figure images are stored under iteration in a visualise folder under the output path.

There are more commands but the rest can be very tightly linked to requirements in the master thesis and might therefore not be of interest generally.

Development setup

Clone the repository locally. Then execute the following commands inside the repository:

git submodule init
git submodule update
pip install -e .
pip install 'git+https://github.com/philferriere/cocoapi.git#egg=pycocotools&subdirectory=PythonAPI'

Release History

  • 0.3.0
    • added cython dependency and information about required python header files
  • 0.2.0
    • added python 3.8 classifier
  • 0.1.0
    • first release

Meta

Jim Martens – @2martensgithub@2martens.de

Distributed under the Apache 2.0 license. See LICENSE for more information. The package contains the ssd_keras implementation of Pierluigi Ferrari.

https://github.com/2martens/

Contributing

  1. Fork it (https://github.com/2martens/masterthesis/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request