USAXS tiled data server: databroker and /share1 directory.
Run the tiled data server for the USAXS beam line on workstation usaxscontrol. Since this server provides open access, it is only accessible within the APS subnet.
To start this tiled server (after configuring as described in the [Install](#install} section), navigate to this directory and run:
in-screen.sh
Then, use any web browser (within the APS firewall) to visit
URL: http://THIS_WORKSTATION_NAME:8000
.
The web interface is a simple UI demonstrating many features of the tiled server and also providing access to online documentation. Visit the documentation to learn how to build your own interface to tiled.
- serve data from Bluesky databroker catalogs
- serve data from user experiment file directory
- Identify NeXus/HDF5 files with arbitrary names.
- Identify SPEC data files with arbitrary names and read them.
- Read
.jpg
(and other image format) files. - Read the synApps MDA format (Python support)
- Write a custom data file identifier.
- Write a custom data file loader.
- Authentication
- Learn how to ignore files such as
.xml
(without startup comments).
- bluesky/tiled#175
- https://blueskyproject.io/tiled/how-to/read-custom-formats.html#case-2-no-file-extension
-
Setup and activate a custom micromamba (conda) environment as directed in
environment.yml
. (Do not expect that file needs editing as of 2022-11-23.)Note: This step defines a
CONDA_PREFIX
environment variable in the bash shell. Used below. -
Edit tiled's configuration file:
config.yml
path
is the name seen by the tiled clients.tree
should not be changed- for databroker catalogs,
uri
is the address of the mongodb catalog for thispath
- for file directories,
directory
is the path to the directory. Either absolute or relative to the directory of this README.md file.
-
Edit bash starter shell script file
start-tiled.sh
- Override definition of
MY_DIR
at your choice. - Choose one definition of
CONDA_ENV
.
- Override definition of
-
Edit web interface to display additional columns:
-
In the
$CONDA_PREFIX
directory, edit fileshare/tiled/ui/config/bluesky.yml
so it has the content indicated by thebluesky.yml
below. -
Edit file
share/tiled/ui/configuration_manifest.yml
and add a line at the bottom to include thebluesky.yml
file:- config/bluesky.yml
-
specs:
- spec: CatalogOfBlueskyRuns
columns:
- header: Bluesky Plan
select_metadata: start.plan_name
field: plan_name
- header: Scan ID
select_metadata: start.scan_id
field: scan_id
- header: Time
select_metadata: start.time
field: start_time
default_columns:
- plan_name
- scan_id
- start_time