fAIr Predictor

Run your fAIr Model Predictions anywhere !

Prerequisites

fAIr Predictor has support for GPU , CPU and tflite based devices

• Install tensorflow-cpu or tflite-runtime according to your requirements

tflite-runtime support is for having very light deployment in order to run inference & tensorflow-cpu might require installation of efficientnet

Example on Collab

# Install 
!pip install fairpredictor

# Import 
from predictor import predict

# Parameters for your predictions 
bbox=[100.56228021333352,13.685230854641182,100.56383321235313,13.685961853747969]
model_path='checkpoint.h5'
zoom_level=20
tms_url='https://tiles.openaerialmap.org/6501a65c0906de000167e64d/0/6501a65c0906de000167e64e/{z}/{x}/{y}'

# Run your prediction 
my_predictions=predict(bbox,model_path,zoom_level,tms_url)
print(my_predictions)

## Visualize your predictions 

import geopandas as gpd
import matplotlib.pyplot as plt
gdf = gpd.GeoDataFrame.from_features(my_predictions)
gdf.plot()
plt.show()

Works on CPU ! Can work on serverless functions, No other dependencies to run predictions

Use raster2polygon

There is another postprocessing option that supports distance threshold between polygon for merging them , If it is useful for you install raster2polygon by :

pip install raster2polygon

Load Testing

CAUTION : Always take permission of server admin before you perform load test

In order to perform load testing we use Locust , To enable this hit following command within the root dir

• Install locust

  pip install locust
  

• Run locust script

  locust -f locust.py
  

Populate your HOST and replace it with BASE URL of the Predictor URL

Docker

Build

sudo docker build . -t fairpredictor 

Run

sudo docker run --rm --name fairpredictor -v $(pwd):/mnt -p 8000:8000 fairpredictor

Navigate to localhost:8000 and shoot following request body

{
  "bbox": [100.56228021333352, 13.685230854641182, 100.56383321235313, 13.685961853747969],
  "checkpoint": "/mnt/tests/checkpoints/ramp/checkpoint.tflite",
  "zoom_level": 20,
  "source": "https://tiles.openaerialmap.org/6501a65c0906de000167e64d/0/6501a65c0906de000167e64e/{z}/{x}/{y}"
}