Visualising

The pipeline generates a Vitessce view config file for each processed dataset. This file can then be used to load the views and data as configured in the parameters files.

You can locally serve and visualize the data in a few steps.

By default, the base url used within the view config is http://localhost:3000/ (this can be changed in the parameters file). This url indicates Vitessce to look for data at that location.

You can set up a http server locally to serve the processed files so a Vitessce instance can load them. There are several tools that can setup a http server. We recommend using serve (requires Node.js), but you can use any tool that can enable CORS.

You can serve the view config file and data by specifying the output directory (note that the pipeline adds its version to the outdir defined in the parameters file file).

serve -C -p 3000 /path/to/outdir/0.5.2/

Make sure to enable CORS and set the appropriate port number. In this case, using serve, this is done through the -C and -p flags respectively.

Your view configs should then be accessible at http://localhost:3000/{project}-{dataset}-config.json.

You can then load them in a Vitessce instance like the WebAtlas app deployed at https://webatlas.cog.sanger.ac.uk/latest/index.html.

Specify your locally served view config through the config parameter like https://webatlas.cog.sanger.ac.uk/latest/index.html?config=http://localhost:3000/{project}-{dataset}-config.json and load this URL in your browser to visualize your data in a Vitessce viewer.