# Usage


## CLI

Example of retrieving Archiver data, specifying the latest 30 seconds:
```console
ops-data-client get CrS-PHS:Cryo-D-0100:AmbientTemp
```

Example of retrieving data from both the SDS and Archiver over a specific time range:
```console
ops-data-client get RFQ-010:RFS-Cav-110:Fld-Wave_SDS-DODData \
    CrS-PHS:Cryo-D-0100:AmbientTemp \
    -s "2025-06-11 10:04:13" -e "2025-06-11 10:04:30"
```

For more CLI options, see the help message:
```console
ops-data-client -h
```

## Python

Example python code to be be run where SDS data is accessible, like in JupyterHub.

Import the module
```python
from ops_data_client import get_data
```

Get recent data from the Archiver in the form of a polars dataframe:
```python
dataframe = get_data(pvs="CrS-PHS:Cryo-D-0100:AmbientTemp")
```

Get data for a specific time range from both the SDS and the Archiver:
```python
dataframe = get_data(
    pvs=["RFQ-010:RFS-Cav-110:Fld-Wave_SDS-DODData",
         "PBI-APTM02:Ctrl-ECAT-100:WF-Temp11"],
    start="2025-06-11 04:06:25.925641123",
    end="2025-06-11 04:06:26.782784789"
)
```