tag#

class arte.dataelab.tag.Tag(tag_string)#

Bases: object

Unique identifier for a dataset snapshot.

A Tag is a string identifier (typically a timestamp) that uniquely identifies a collection of data files representing a snapshot of the system state at a specific time. Tags are used to:

  • Organize data by acquisition time

  • Group related files (frames, commands, calibrations)

  • Cache computed results

  • Enable batch analysis across multiple acquisitions

Tags must contain at least one underscore and typically follow the format: YYYYMMDD_HHMMSS (e.g., ‘20240101_120000’)

Parameters:

tag_string (str) – Tag identifier string. Must contain exactly one underscore or one slash.

Examples

>>> tag = Tag('20240101_120000')
>>> print(tag)  # '20240101_120000'
>>> day = tag.get_day_as_string()  # '20240101'

>>> # Create tag with current timestamp
>>> tag = Tag.create_tag()

Notes

The day portion is extracted as everything before the first underscore, allowing flexible tag formats as long as they start with a date-like identifier.

See also

arte.utils.timestamp.Timestamp

For creating timestamps

BaseAnalyzer

Uses tags to identify datasets

Methods

create_tag()

Create a tag with the current timestamp

get_day_as_string

get_remainder_as_string
static create_tag()#

Create a tag with the current timestamp

get_day_as_string()#
get_remainder_as_string()#