GEO GMT (Generic Mapping Tools)

This Geovisualization Case Study (using GMT tools) will demonstrate the sysnthesis functionality provided by APE (the Automated Pipeline Explorer).

The use case aims to demonstrate the usefulness of the synthesis approach for solving a problem of map creation. The scenario was demonstrated in 1, where the full workflows synthesis was accomplished in few incremental synthesis steps. Some of them are given here for demonstration:

  • E0 use case describes the initial workflow sinthesys step, labeled as E0 in the paper.

  • E1 use case extends the initial workflow sinthesys step with additional constraints enforcing better map annotations.

E0 - Initial Workflow

In order to run the synthesis APE-<version>.jar needs to be available: https://github.com/sanctuuary/APE.

Note

In order to be able to execute the generated workflows on the machine, GMT set of tools needs to be installed (http://gmt.soest.hawaii.edu/projects/gmt/wiki/Installing) However, this step is not required for the workflow synthesis, considering that the synthesis of conadidate workflows and their execution are 2 separate steps.

In order to use the APE library from the command line, simply run the APE-<version>-executable.jar file using command:

java -jar APE-<version>-executable.jar [path_to_ape_configuration_file]

As an example, if you would download the APE-1.0.1-executable.jar to the root of APE_UseCases repository on your local machine, you could run this demo by executing the following command:

cd ~/git/APE_UseCases
java -jar APE-<version>.jar GeoGMT/E0/ape.configuration

The results of the synthesis would be:

GeoGMT/E0/solutions.txt - First 100 candidate solutions in textual format
GeoGMT/E0/Figures/          - Data-flow figures corresponding to the first 10 solutions
GeoGMT/E0/Executables/  - Executable shell scripts corresponding to the first 6 solutions

E1 - Additional Constraints

By adding more constraints (constraints_e1.json), we avoid obtaining workflows that are ambiguous, redundant, or not relevant to the domain 1.

cd ~/git/APE_UseCases
java -jar APE-<version>.jar GeoGMT/E1/ape.configuration

Domain Model

Tool Taxonomy

../../../_images/geo_gmt_tools.png

Type Taxonomy

../../../_images/geo_gmt_types.png

References

1(1,2)

Kasalica, V., & Lamprecht, A.-L. (2019). Workflow discovery through semantic constraints: A geovisualization case study. In Computational science and its applications – ICCSA 2019 (pp. 473–488), Springer International Publishing, https://doi.org/10.1007/978-3-030-24302-9_53