captest.filters.Backtracking

class captest.filters.Backtracking(*, axis_azimuth, axis_tilt, cross_axis_tilt, gcr, keep_backtracking, custom_name, name)

Remove intervals where single-axis-tracker backtracking is active.

Transcribes pvlib’s own tracking.singleaxis backtracking test (Anderson & Mikofski 2020): an interval is backtracking-active when the sun is above the horizon and row-to-row shade would occur under true-tracking. Solar position is computed from capdata.site['loc'] via pvlib; tracker geometry defaults to capdata.site['sys'] and is overridable per parameter.

By default keeps true-tracking intervals and removes backtracking-active ones; set keep_backtracking=True to invert (keep only backtracking).

Degrades to a warn-and-no-op (returns the index unchanged) when pvlib is unavailable, capdata.site (or its loc/sys) is missing, or the resolved geometry is invalid.

__init__(**params)

Methods

`__init__`(**params)
`from_config`(config)	Build an instance from a `to_config()` dict.
`run`(capdata)	Execute the step, record runtime state, and append self to filters.
`to_config`()	Serialize this step to a config dict (every param, defaults included; the param-system `name` is omitted).

Attributes

`args_repr`	Render the step's params for the summary.
`axis_azimuth`
`axis_tilt`
`cross_axis_tilt`
`custom_name`
`explanation`	Human-readable description of the step's effect (read after run()).
`gcr`
`keep_backtracking`
`name`
`param`