> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/artemis-library/wideband-and-marti-fd-line-fitter.md).

# Wideband and Marti FD Line Fitter

## Description

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-5bacfffc9adb9421bd91142cf76ab16948598f15%2FArtemis_wideband_marti_FDLine_filter_block.png?alt=media" alt="" width="241"><figcaption></figcaption></figure>

The **Wideband and Marti-FD line fitter** block, located in the **ARTEMiS/SSN/Lines** library, manages the rational-function fitting routines used by the SSN Wideband line/cable and Marti-FD line models. It performs vector fitting to generate poles-residues files for use at run time. The Marti-FD fitter enforces real poles as required by the Marti-FD model. The block can read transmission geometry from the SimPowerSystems Line parameters GUI for overhead lines and from the Crinoline-based GUI for cables.

{% hint style="info" %}
Save the geometry in the SimPowerSystems or Crinoline GUI before running the fitter. The fitter reads the .mat (lines) or .geo (cables) file directly.
{% endhint %}

The fitters produce .dat (Wideband line/cable) and .pun (Marti-FD line) files for SSN second-generation line models. These files are also compatible with EMTP-RV and Hypersim.

{% hint style="danger" %}
This block requires a valid RT-LAB license on the simulator with the feature ARTEMiS enabled. Refer to[ ARTEMiS Requirements](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/artemis-requirements.md) for details.
{% endhint %}

## Mask parameters

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-786d2fca857e76b125318406106d23dce0595c36%2FArtemis_wideband_marti_FDLine_filter_mask.png?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Main & Scan options" %}

<table><thead><tr><th width="252.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Model Type</strong></td><td>Select the model to fit: Line (Wideband), Cable (Wideband), or Line (Modal domain FD-line).</td></tr><tr><td><strong>Line parameters filename (.mat)</strong><br><strong>Cable parameter filename (.geo)</strong></td><td>SimPowerSystems Line parameters GUI filename (used when Model Type is a line).<br>Crinoline cable GUI filename (used when Model Type is a cable).</td></tr><tr><td><strong>Open line parameter GUI</strong><br><strong>Open cable parameter GUI</strong></td><td>Opens the SimPowerSystems Line parameters GUI (used when Model Type is a line).<br>Opens the Crinoline cable GUI (used when Model Type is a cable).</td></tr><tr><td><strong>Line length (km) (Line Only)</strong></td><td>Line length in kilometers (for lines). Note: the Crinoline cable GUI includes cable length; in that case, the GUI length is used.</td></tr><tr><td><strong>Start frequency scan and fitting of line model</strong></td><td>Starts the frequency scan and computes the selected model fittings.</td></tr><tr><td><strong>Minimum frequency (Hz)</strong></td><td>Minimum scan frequency. For DC lines or cables, use 0.001 Hz.</td></tr><tr><td><strong>Number of decades for scan</strong></td><td>Number of decades (<em>nd</em>) from the minimum frequency.</td></tr><tr><td><strong>Number of points per decade</strong></td><td>Points per decade (<em>pd</em>). The fitter uses <em>nd*pd</em> frequency points.</td></tr></tbody></table>
{% endtab %}

{% tab title="Wideband line options" %}

<table><thead><tr><th width="253">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>F<strong>itter EMTP-type output file</strong></td><td>Filename of the poles/residues file for Wideband line/cable.<br>Used by SSN Wideband line models and compatible with EMTP-RV.</td></tr><tr><td><strong>Line to ground default admittance (mhos)</strong></td><td>Default shunt admittance (Siemens) for characteristic function calculations. Suggested value: 2e-10 mhos (as in EMTP-RV).</td></tr><tr><td><strong>H(w) number of poles per mode</strong></td><td>Number of poles per mode for the propagation function <em>H(w)</em> (<em>Hnppm</em>). There is one mode per phase.<br>Total <em>H(w)</em> poles = <em>Hnppm*nph</em> (<em>nph is the</em> number of phases, w is the angular frequency in rad/s).</td></tr><tr><td><strong>DC correction</strong></td><td>Enable low-frequency/DC compensation. Uses the first propagation mode and adds <em>Hnppm</em> new poles to reduce <em>H(w)</em> error.</td></tr><tr><td><strong>Improved DC fit maximum frequency (Hz)</strong></td><td>Maximum frequency up to which the DC response is compensated (active when DC correction is enabled).</td></tr><tr><td><strong>Yc(w) total number of poles</strong></td><td>Total number of poles for the characteristic admittance <em>Yc(w)</em>.</td></tr><tr><td><strong>Fitting weight</strong></td><td>Frequency-dependent weighting: "Uniform" (equal weight) or "1/f for f&#x3C;1 Hz" (higher weight below 1 Hz for improved low-frequency accuracy).</td></tr><tr><td><strong>Show fitting curves</strong></td><td>Displays fitting results for <em>Hmodal(w)</em>, <em>H(w)</em>, and <em>Yc(w)</em>.</td></tr><tr><td><strong>Generate EMTP-RV compatible YZ scan file</strong></td><td>Produces a .lyz or .cyz file compatible with EMTP-RV to compare line/cable Y–Z parameters.</td></tr><tr><td><strong>Use EMTP-RV .lyz or .cyz file for fitting</strong></td><td>Overrides the scan and reads Y–Z data from the specified EMTP-RV file for fitting (uses EMTP-RV parameter calculations).</td></tr></tbody></table>

{% hint style="info" %}
When DC correction is enabled for the Wideband fitter, the specified number of *H(w)* poles is effectively doubled in the first propagation mode.
{% endhint %}
{% endtab %}

{% tab title="Mart-FD-line options" %}

<table><thead><tr><th width="250.60003662109375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Frequency of eigenvalue calculation (Hz)</strong></td><td>Frequency at which modal transformation matrices are evaluated. The Marti model uses a constant modal transformation across frequencies (exact for balanced lines, good for lightly unbalanced overhead lines, usually unsuitable for cables). Available for lines only.</td></tr><tr><td><strong>Fitter EMTP-type output file (.pun)</strong></td><td>Poles/residues filename for the SSN Marti-type FD-line model. Compatible with EMTP-RV.</td></tr><tr><td><strong>Maximum number of Zc(w) poles</strong></td><td>Maximum number of poles for characteristic impedance <em>Zc(w)</em> in the modal domain (<em>nzcp</em>). The fitter may produce fewer poles. Total poles = <em>nzcp*nph</em>.</td></tr><tr><td><strong>Maximum number of Ap(w) poles</strong></td><td>Maximum number of poles for the propagation function <em>Ap(w)</em> in the modal domain (<em>naap</em>). The fitter may produce fewer poles. Total poles = <em>naap*nph</em>.</td></tr><tr><td><strong>Plot fitting</strong></td><td>Displays fitting results for all modes.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Line and cable parameter GUIs <a href="#widebandandmarti-fd-linefitter-lineandcableparameterguis" id="widebandandmarti-fd-linefitter-lineandcableparameterguis"></a>

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-1d1ad1b13dd6b276bd4441c8902d3517d6accc30%2FArtemis_wideband_marti_FDLine_filter_gui.png?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Line parameter" %}
The fitter uses the SimPowerSystems Line parameters GUI.

After a geometry has been entered in this GUI, it must be saved for the fitter GUI to be used. The fitter GUI reads directly the geometry file (here a .mat file) to compute the line parameters. To examine a previously entered geometry, press the ‘Load user data’ button.

{% hint style="info" %}
This GUI does not include line length; enter length in the fitter block.
{% endhint %}
{% endtab %}

{% tab title="Cable parameter" %}
The fitter GUI makes use of the Crinoline-based GUI, developed for Hydro-Quebec.

After a geometry has been entered in this GUI, it must be saved for the fitter GUI in order to be used. The fitter GUI reads directly the geometry file (here a .geo file) to compute the cable parameters, including in this case the total cable length.

In the Crinoline cable GUI, select the desired geometry name to review existing data. The cable length is taken from this GUI.

{% hint style="info" %}
To point the cable GUI to a custom database at opening, set in the MATLAB workspace: SSN\_CABLEPARAM\_USE\_THIS\_DATA\_PATH='C:\MATLAB\_WORK\mycablegeometry'.
{% endhint %}
{% endtab %}
{% endtabs %}

## Inputs

This block has no inputs.

## Outputs

This block has no outputs.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/artemis-library/wideband-and-marti-fd-line-fitter.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
