Skip to content

most-inesctec/stfXCore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

stfXCore

BCH compliance Build Status

❗ This repository is a mirror of the now archived original stfXCore. Further development occurs here. ❗

The central microservice of the SpatioTemporal Feature eXtractor (stfX). This service, built using spring, is responsible for everything that is not the computation of spatiotemporal change features. More specifically, this service responsibilities include:

  • Aggregation of the spatiotemporal change features computed by the remaining services;
  • Storing temporal snapshots as well as the corresponding extracted spatiotemporal change features;
  • Filter the obtained spatiotemporal change features according to the user inputted thresholds, thus obtaining the features of interest;
  • Identification of immutability (feature presented in section~\ref{sol:novel-change-features});
  • Filtering of noise produced by the utilised computation methods;
  • Indexing of spatiotemporal change features according to the temporal range;
  • Identification of unimportant temporal ranges;
  • Coalescing of features of interest.

This server's updated API can be consulted here.

Section 5.2.2 of the thesis associated to the stfX contains a detailed description of this microservice architecture and general guidelines.

stfXCore packages overview

Package Description
Models CRUD interface for the data entities managed in the application. Models do not handle any business logic, solely entity self-contained logic.
Controllers Responsible for handling the stfX API endpoints and further delegate actions to the other architecture components.
Repositories Specify persistence in the database using ORM.
Services Fetch data from the Models, handle it and then provide the processed data to the Controllers. The majority of the business logic is implemented here.

The figure below illustrates how different components of the stfXCore interact to retrieve the spatiotemporal change features of interest to the end-user.

Screenshot 2020-08-01 at 16 15 43

Getting started

To run a container with the application, in a standalone manner, use:

cd stfXCore
sh docker-build.sh
docker run -p 8080:8080 stfx-core