Alignment, a collaborative, system aided, user driven ontology/vocabulary matching and validation platform.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
app Apply fixes from StyleCI Apr 18, 2018
bootstrap initial transfer Nov 20, 2016
config fixed travis config Apr 18, 2018
database Apply fixes from StyleCI Apr 17, 2018
deployment fixed docker deployment Mar 30, 2018
public added travis.yml and environement Apr 18, 2018
resources Merge pull request #84 from okgreece/develop/1 Apr 18, 2018
routes fixed import procedure Apr 18, 2018
storage Added some test files. Fixed Jobs timeout issues. Apr 12, 2018
tests removed AcachaTests Apr 18, 2018
.env.example added Dockerfile and other build files Sep 18, 2017
.env.travis fixed travis config Apr 18, 2018
.gitattributes Create .gitattributes Nov 20, 2016
.gitignore fixed docker deployment. Need to attach to container and run start.sh Nov 15, 2017
.php_cs added php.cs Apr 18, 2018
.styleci.yml added styleci.yml Apr 18, 2018
.travis.yml trying to fix travis config Apr 18, 2018
LICENSE Initial commit Nov 20, 2016
_ide_helper.php Apply fixes from StyleCI Apr 17, 2018
artisan initial transfer Nov 20, 2016
composer.json refactored similarity calculation job Apr 11, 2018
composer.lock Added some test files. Fixed Jobs timeout issues. Apr 12, 2018
gulpfile.js initial transfer Nov 20, 2016
initVolumes.sh fixed docker deployment. Need to attach to container and run start.sh Nov 15, 2017
package.json initial transfer Nov 20, 2016
phpunit.xml initial transfer Nov 20, 2016
readme.md fixed readme Apr 18, 2018
server.php Apply fixes from StyleCI Apr 17, 2018

readme.md

StyleCI Build Status

Alignment

Typical Workflow

Ontology matching is a crucial problem in the world of Semantic Web and other distributed, open world applications. Diversity in tools, knowledge, habits, language, interests and usually level of detail may drive in heterogeneity. Thus, many automated applications have been developed, implementing a large variety of matching techniques and similarity measures, with impressive results.

However, there are situations where this is not enough and there must be human decision in order to create a link. We present Alignment, a collaborative, system aided, user driven ontology matching application. Alignment offers a simple GUI environment for matching two ontologies/vocubularies with aid of configurable similarity algorithms. We undertake research for the evaluation and validation of the default settings, taking into account expert users feedback.

Multiple users can work on the same project simultaneously. The application offers also social features, as users can vote, providing feedback, on the produced linksets. The linksets are available through a SPARQL endpoint and an API.

Alignment is the outcome of the experience working with heterogeneous public budget data, and has been used to align SKOS Vocabularies describing budget data across diverse level of administrations of the EU and it’s member states.

Requirements

  • Composer
  • PHP(7.2.*)
  • PHP capable web server
  • MySQL
  • Java 8
  • Rapper utility
  • Skosify utility

To install Rapper utility on Debian based systems please follow the instructions below: Open a terminal and paste the command:

sudo apt-get install raptor2-utils

To install Skosify please follow the instructions below:

pip install --upgrade skosify

Skosify is used to validate, and correct if possible SKOS vocabularies, or convert RDFS/OWL ontologies into SKOS, in order to be able to render by the application.

Installation steps

#clone the repo
git clone https://github.com/okgreece/Alignment.git

#run composer
composer install

#create an .env file from .env.example
cp .env.example .env

#change your database credentials using your favorite text editor

#run the migrations
php artisan migrate

#seed the database
php artisan db:seed

#run the Job Que. Change www-data accordingly, to reflect your server user name.
sudo -u www-data php artisan queue:listen --timeout=600 --sleep=30 --tries=5

# in case you hit on 500 errors, try changing permissions. Your web server should 
# have write permissions on public and storage folders at least.

Import Silk Configuration

You can now import your own Silk configuration to be used by Silk engine. Just go to Settings panel and create a new Setting. You will be prompt to give a friendly name and upload a Silk LSL configuration file. Uploaded file will be validated using libxml library and the appropriate schema. If the file is validated correctly it will be shown on your project configuration to choose. Then calculate the similarities using your newly updated Silk LSL.

Deploy with Docker

Edit the the file deployment/docker-compose.yml to change the env variable MYSQL_ROOT_PASSWORD to match your preferences. Then from your command line run:

#initialize the volumes
sh initVolumes.sh

#build docker image
docker-compose -f deployment/docker-compose.yml up --build -d

After the build finishes successfully, at the moment you need to attach to the openbudgets_alignment container and run the following script

docker exec -it {your_container_id} bash
sh start.sh

Follow the instructions given in order to setup the database correctly. Then open the APP_URL with your browser and...happy linking!!!