NOVA EPICS Integration

Thank you for your interest in developing interactive applications for NOVA. This documentation describes how you can retrieve unprivileged instrument status information from EPICS for use in NOVA applications.

This package can be installed with:

pip install "nova-epics[your_framework]"

Currently, the only supported option for frameworks is “trame” <https://www.kitware.com/trame/>__.

This library works by running JavaScript code that creates a WebSocket connection to an EPICS Tomcat server and then stores the necessary information in the application state. The steps to use it are to:

  1. Retrieve an instance of the interface class via get_epics_instance().

  2. Call connect() with XML and macro data needed to retrieve the correct PVs from EPICS.

  3. (Optional) Use the provided components to use the retrieved PVs in your application.

For step 2, you will need to provide an XML file and a macros string. https://github.com/nova-sdk/nova-epics/blob/main/tests contains examples. You can typically get both of these for a desired instrument via the URL of the DBWR-based status page.

Contents: