mfs_locator

Table of Contents
  1. About The Project
  2. Getting Started
  3. License

About The Project

The mfs_locator is a spacial implementation resolving the Euclidean distance between several points. In this project, given a list of coordinates, we get two pairs of coordinates that are close to one another.

The Algorithm implemented removes any duplicates in the list supplied to process the residule. The implementation is that, to get the two nearest pairs we compute the distance matrix, then we get the minimum scoring in the matrix.

Getting Started

Prerequisites

Installation

  1. Change directory

    cd mfs_locator
  2. Set up virtual environment:

     virtaulenv --python=/location/of/python3.8 ./ 
  3. Activate enviroment.

    source bin/activate
  4. Install dependencies

    pip install -r requirements.txt
  5. Make migrations

    python manage.py makemigrations
  6. Migrate

    python manage.py migrate
  7. Set up new user

    python manage.py createsuperuser --email admin@example.com --username admin
    
  8. Run the app

    python manage.py runserver
    

Test unit & API documentation

The end point is coformat to Swagger sturcure and so is the documentation for the API.

  1. Run tests
    python manage.py test
    

Documentation

The documentation can be accessed under the following three paths from the base URL:

/swagger

eg:

http://localhost:8000/swagger

/swagger.yaml

http://localhost:8000/swagger.yaml

and

/redoc

http://localhost:8000/redoc

License

Distributed under the GPL-3.0 License. See LICENSE for more information.