Skip to main content

Argussight

Argussight is a versatile video processing tool designed to manage and run multiple streaming processes using one or several input sources. It primarily works with FFmpeg streams, ensuring high compatibility and performance for video processing tasks.

Originally developed as an extension of the video-streamer project by the MXCuBE organization, Argussight can also operate as a standalone application. Its flexible design allows it to be reconfigured for integration with other components, making it adaptable to various use cases.

Advantages of using Argussight

  • Enhanced User Experience: Multiple streams could be displayed at once from the same source, providing a comprehensive view from different angles and/or sources.

  • Facilitates Usage of Computer Vision Algorithms: Developers can make use of different computer vision algorithms, directly on the images and do not need to handle the complexity of handling video-loading or streaming.

  • On-the-Fly Configuration: The system can dynamically adjust streams, such as changing parameters for video anlaysis, change position of region of interest or simply switching between views according to user preferences, withou needing to restart or reconfigure the entire process.

Design Overview

Argussight is built around four key components, each playing a vital role in its functionality.

  • Spawner: The core of Argussight, responsible for controlling, spawning and terminating video processes.

  • GRPC Server: Thightly connected to the Spawner, it handles the communication with a client application.

  • Video processes: Processes that are each running a specific video-related task, like generating or modifying camera streams.

  • Stream-Layer: An abstraction layer positioned between streaming processes and external systems. This layer simplifies access to the streams while enhancing security through port abstraction.

Argussight Overview

Documentation 📚

Check out the full documentation to explore everything, this project has to offer! Including:

  • Information about all natively integrated video-related processes
  • A detailed explanation about the project's core functionalities
  • A comprehensive guide on how to start and run the project
  • A developers guide
  • and more!

Installation

First you need to clone the repository.

git clone https://github.com/mxcube/argussight.git

# Navigate to the newly created directory
cd argussight

Optionally, you can create a conda environment for this project

conda env create -f conda-envrionment.yml

If you chose not to, you need to have ffmpeg installed on your system, you can do so via your corresponding package manager. On Debian-based Linux distributions (Ubuntu, Debian, Pop!_OS, ...) for example you can install it like this

sudo apt-get install ffmpeg

Now install the remaining dependencies using pip

# for Development
pip install -e .

# for Usage
pip install .

or poetry

poetry install

Usage

⚠️ Attention ⚠️

If you want to use the Recorder class (enabled per default), please be aware that it creates a temporary folder in the location, you start the server at. In the configurations folder, you can change the name of said folder, please make sure that no other folder in your current location has the same name, as it will otherwise delete the contents of that folder (default is temp).

  • To rename the temporary folder, go to argussight/core/configurations/processes/savers/video_recorder.yaml and change the value of temp_folder.
  • To disable the Recorder class, go to argussight/core/configurations/config.yaml and remove the process named Recorder

Start the Server

Once you installed all the dependencies, you can run the argussight server by using

argussight

command in a terminal window.

Start communication with the GRPC Server

To communicate with the grpc server, you need to establish a connection with the channel. By default the server is running on port 50051 (changeable in the argussight/grpc/server.py file). The code example below shows how to start a connection and get a response for the GetProcessesRequest:

import grpc
import argussight.grpc.argus_service_pb2 as pb2
import argussight.grpc.argus_service_pb2_grpc as pb2_grpc

channel = grpc.insecure_channel("localhost:50051")
stub = pb2_grpc.SpawnerServiceStub(channel)

# try to reach the server
try:
    response = stub.GetProcesses(pb2.GetProcessesRequest())
except Exception as e:
    # handle exception here
    print(e)

Access your streams

To access your streams, you first need a running streaming process. To create one, you need to make a process that inherits the Streamer class. Please refer to the documentation on how to do that. If your class inherits Streamer and is correctly configured in the config.yaml file, the Argussight class will take care of adding every instance of your class to the Abstraction-Layer. To access the streams from outside, you can then create a websocket connection to ws://localhost:7000/ws/${name}, where localhost:7000 is the default location of the Abstraction-Layer (configurable in config.yaml), and name is the unique name of your process instance.

Metadata

Release files for argussight 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for argussight 0.3.2
File Size Uploaded Provenance Actions
argussight-0.3.2.tar.gz 30.2 kB Without provenance Details for argussight-0.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for argussight 0.3.2
File Interpreter ABI Platform Actions
argussight-0.3.2-py3-none-any.whl Python 3 none any Details for argussight-0.3.2-py3-none-any.whl

Total release size: 70.4 kB

Release files / argussight-0.3.2.tar.gz

Download URL argussight-0.3.2.tar.gz
Size 30.2 kB
Tags Source
SHA-256 checksum
How to use checksums
56d4d72177925d0953c1cd2bd4210d0c876825f3dd2690867e28d9de9ce3a60a
BLAKE2b-256 checksum
How to use checksums
b78eee6cf950a8d8e7b16f4beb94acc3f26be0da71a232d138ce0f82f0462c22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.11.14 Linux/6.17.0-35-generic

Release files / argussight-0.3.2-py3-none-any.whl

Download URL argussight-0.3.2-py3-none-any.whl
Size 40.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
907f964e0e3d6426dc321fe4027ca47207cea0aadd99180627f35503332bbbc4
BLAKE2b-256 checksum
How to use checksums
ef0c836d25bc33d56540824c5edffc9d0570930899072ce3a97c9b645d4de9f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.11.14 Linux/6.17.0-35-generic

Security for argussight 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page