Observational Health Data Sciences and Informatics

The following sections detail the process for setting up Atlas and its dependencies.

The first prerequisite for ATLAS is to Install the OHDSI WebAPI and configure the appropriate sources. The following figure provides an example topology to show the different elements involved in the WebAPI architecture and a visual representation of the source configuration.

Note: The example above does not represent a physical architecture. The WebAPI configuration allows you to physically and logically segregate these data sources based on the requirements of your environment.

To use the Data Sources feature within ATLAS you must first setup and execute ACHILLES in your environment. Once you have successfully generated summary statistics and have exported your data to JSON format, you are ready to configure ATLAS to use this information.

Begin by downloading the latest release of ATLAS from GitHub.

Install the release onto a web server such that the application will be reachable via a URL such as:

http://<your_webserver>/atlas

Under the Atlas root folder, edit the file /js/config.js to configure the following properties:

define([], function () {
  var config = {};
  config.services = [{
    name: '<YOUR ENVIRONMENT NAME>',
    url: 'http://your_webserver/WebAPI/'
  }];
 
  config.webAPIRoot = config.services[0].url;
 
  config.dataSourcesLocation = '/achilles/data/datasources.json';
  config.dataSourcesRoot = '/achilles/data';
 
  return config;
});

config.services: Edit this array to provide a name for your environment and the URL for the WebAPI that was set up in WebAPI section.

config.dataSourcesLocation & config.dataSourcesRoot (v1.x of Atlas - these configuration settings are no longer required in v2.0): If you have set up your CDM statistics (Achilles), these properties should be set to the URL where your CDM statistics resides. In the configuration below, we are using a relative path since we assume you have hosted your CDM statistics on the same web server as ATLAS but under a different directory.

You should now be able to navigate to ATLAS from your web browser.

http://<your_webserver>/atlas