geopulse.devices.cp_unit

Cathodic-protection unit response to telluric E-field — STUB (WP3).

Classes

CathodicProtectionModel()

Cathodic-protection unit: PSP shift under telluric E-field (WP3).
class geopulse.devices.cp_unit.CathodicProtectionModel[source]

Bases: DeviceModel

Cathodic-protection unit: PSP shift under telluric E-field (WP3).

inject_gic(time_s, gic_A, ac_voltage_V=0.0, ac_frequency_Hz=50.0)[source]

Inject a GIC time series into the device and compute the response.

Parameters:

  • time_s (ndarray) – Time array in seconds. Shape (n_times,).

  • gic_A (ndarray) – GIC current in Amperes. Shape (n_times,).

  • ac_voltage_V (float) – Nominal AC voltage (transformers only). Default: 0.0.

  • ac_frequency_Hz (float) – AC system frequency in Hz. Default: 50.0.

Return type:

DeviceResponse

Returns:

DeviceResponse – Full response including harmonics and THD.