pyecsca.sca.trace_set.inspector module
Provides a traceset implementation based on Riscure’s Inspector traceset format (.trs).
-
class SampleCoding(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]
Bases: IntEnum
-
Int8 = 1[source]
-
Int16 = 2[source]
-
Int32 = 4[source]
-
Float8 = 17[source]
-
Float16 = 18[source]
-
Float32 = 20[source]
-
dtype()[source]
-
class Parsers[source]
Bases: object
-
static read_int(bytes)[source]
-
static read_bool(bytes)[source]
-
static read_float(bytes)[source]
-
static read_str(bytes)[source]
-
static write_int(i, length=1)[source]
-
static write_bool(b, length=1)[source]
-
static write_float(f, length=None)[source]
-
static write_str(s, length=None)[source]
-
class InspectorTraceSet(*traces, **kwargs)[source]
Bases: TraceSet
Riscure Inspector trace set format (.trs).
-
num_traces:
int[source]
-
num_samples:
int[source]
-
sample_coding:
SampleCoding[source]
-
data_space:
int = 0[source]
-
title_space:
int = 0[source]
-
global_title:
str = 'title'[source]
-
description:
Optional[str] = None[source]
-
x_offset:
int = 0[source]
-
x_label:
Optional[str] = None[source]
-
y_label:
Optional[str] = None[source]
-
x_scale:
float = 1[source]
-
y_scale:
float = 1[source]
-
trace_offset:
int = 0[source]
-
log_scale:
int = 0[source]
-
scope_range:
float = 0[source]
-
scope_coupling:
int = 0[source]
-
scope_offset:
float = 0[source]
-
scope_impedance:
float = 0[source]
-
scope_id:
Optional[str] = None[source]
-
filter_type:
int = 0[source]
-
filter_frequency:
float = 0[source]
-
filter_range:
float = 0[source]
-
external_clock:
bool = False[source]
-
external_clock_threshold:
float = 0[source]
-
external_clock_multiplier:
int = 0[source]
-
external_clock_phase_shift:
int = 0[source]
-
external_clock_resampler_mask:
int = 0[source]
-
external_clock_resampler_enabled:
bool = False[source]
-
external_clock_frequencty:
float = 0[source]
-
external_clock_time_base:
int = 0[source]
-
classmethod read(input, **kwargs)[source]
Read Inspector trace set from file path, bytes or file-like object.
- Parameters:
input (Union[str, Path, bytes, BinaryIO]) – Input file path, bytes or file-like object.
- Return type:
InspectorTraceSet
- Returns:
-
-
classmethod inplace(input, **kwargs)[source]
- Return type:
InspectorTraceSet
-
write(output)[source]
Save this trace set into a file.
- Parameters:
output (Union[str, Path, BinaryIO]) – An output path or file-like object.
-
property sampling_frequency: int[source]
Return the sampling frequency of the trace set.
