nextline-web

The front-end web app of Nextline.

Nextline is a DAQ sequencer of the Observatory Control System (OCS). Nextline allows line-by-line execution of concurrent Python scripts, which control telescopes, by multiple users simultaneously from web browsers.

Citation

Nextline consists of multiple packages. Please use the following DOI for the core package to cite Nextline in general unless you need to refer to a specific package.

Screenshot

How to run the Nextline front-end web app

The section shows how to run the Nextline front-end web app. To start, you need to know the URL of the back-end API server.

As a Docker container

Docker images of the Nextline front-end web app are created as ghcr.io/simonsobs/nextline-web.

Environment variables in the container

You can configure the web app in the container with these variables.

| Environment variable | Default value | Description | | -------------------- | ----------------------- | ------------------------------------------ | | PUBLIC_PATH | / | Path in the URL of the web app | | API_HTTP | http://localhost:8000 | URL of the GraphQL API server | | API_NAME | localhost | Text to be shown as part of the title | | SEED_COLOR | #607D8B | The source color (hex) of dynamic colors* |

*Accessible colors in light and dark modes are dynamically generated by Dynamic Color in Material Design.

For example, if you are to run the web app at the port 8080 with the path /nextline/ and use the GraphQL API server at http://localhost:5000/graphql as the name API 1, you can do so with the following command.

docker run -p 8080:80 -e PUBLIC_PATH=/nextline/ -e API_HTTP=http://localhost:5000/-e API_NAME="API 1" graphql ghcr.io/simonsobs/nextline-web

If you are on the localhost, the web app is running at http://localhost:8080/nextline/.