base_indexer#

class arte.dataelab.base_indexer.BaseIndexer(single_kw=None, from_kw=None, to_kw=None)#

Bases: object

Base indexer for flexible data subset selection.

Indexers provide a flexible interface for selecting subsets of data from time series. They process various argument formats:

Positional arguments for direct element selection
Keyword arguments with customizable names
Slice syntax for range selection

Parameters:

single_kw (str or list of str, optional) – Additional keyword names for single element selection. Default keywords: ‘element’, ‘elements’
from_kw (str or list of str, optional) – Additional keyword names for start of range. Default keywords: ‘from_element’, ‘first’
to_kw (str or list of str, optional) – Additional keyword names for end of range. Default keywords: ‘to_element’, ‘last’

Examples

>>> indexer = BaseIndexer(single_kw='mode', from_kw='start')

>>> # Select single elements
>>> idx = indexer.process_args(5)              # Returns 5
>>> idx = indexer.process_args(element=5)      # Returns 5
>>> idx = indexer.process_args(mode=5)         # Returns 5

>>> # Select element range
>>> idx = indexer.process_args(first=10, last=20)  # Returns slice(10, 20)
>>> idx = indexer.process_args(start=10)           # Returns slice(10, None)

>>> # Select list of elements
>>> idx = indexer.process_args(elements=[1,5,9])   # Returns [1, 5, 9]

Notes

This class is typically used as a base for specialized indexers that understand data structure (e.g., x/y slopes, quadrants).