The MDStudio ATB service provides access to the Automatic Topology Builder server (ATB) at the University of Queensland, Brisbane Australia.

MDStudio ATB can be used in the MDStudio environment as Docker container or as standalone service.

NOTE: To use the ATB service you are required to have a user account on the ATB server. On your ATB server account page you should generate an ATB API token that is required for communication with the service endpoints via the atb_api_token argument.

MDStudio ATB can be installed quickly from a pre-compiled docker image hosted on DockerHub by:

docker pull mdstudio/mdstudio_atb docker run (-d) mdstudio/mdstudio_atb 

In this mode you will first need to launch the MDStudio environment itself in order for the MDStudio ATB service to connect to it. You can unify this behaviour by adding the MDStudio ATB service to the MDStudio service environment as:

MDStudio/docker-compose.yml: services: mdstudio_atb: image: mdstudio/mdstudio_atb links: - crossbar environment: - CROSSBAR_HOST=crossbar volumes: - ${WORKDIR}/mdstudio_atb:/tmp/mdstudio/mdstudio_atb 

And optionally add mdstudio_atb to MDStudio/core/auth/settings.dev.yml for automatic authentication and authorization at startup.

You can custom build the MDStudio ATB Docker container by cloning the MDStudio_atb GitHub repository and run:

docker build MDStudio_atb/ -t mdstudio/mdstudio_atb 

After successful build of the container follow the steps starting from docker run in install option 1.

If you prefer a custom installation over a (pre-)build docker container you can clone the MDStudio_atb GitHub repository and install mdstudio_atb locally as:

pip install (-e) mdstudio_atb/ 

Followed by:

./entry_point_mdstudio_atb.sh 

or

export MD_CONFIG_ENVIRONMENTS=dev,docker python -u -m mdstudio_atb