> 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/hypersim/library-blocks-reference/network-sources/ac-v-source.md).

# AC V Source

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b91e2b902d241580b0d63c1d5c82b213b8ec97c7%2Fimage%20(1155).png?alt=media" alt="" width="140"><figcaption></figcaption></figure>

The **AC Voltage Source** block, located in the **Network Sources** library, represents single- or three-phase voltage sources with a series RLC impedance.

{% hint style="info" %}
By default, the voltage/current source block operates in single-phase mode. When it is connected to a three-phase bus signal, it automatically switches to three-phase operation.
{% endhint %}

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-1e0d5cb6280acf5201dc88309f9ac21730d25e4d%2FACV.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="General" %}

<table><thead><tr><th width="240">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Starting mode (Slow/Fast)</strong></td><td>If <strong>Fast</strong>, the source activates or deactivates immediately. If <strong>Slow</strong>, the source amplitude ramps linearly from zero to the steady-state value when activated, and from the steady-state value to zero when deactivated (see captures below).</td></tr><tr><td><strong>RLC type</strong></td><td>Series (R, L, C in series) or parallel (R, L, C in parallel).</td></tr><tr><td><strong>Phase sequence</strong></td><td><ul><li><strong>Direct or Inverse (positive or negative):</strong> Maintains a constant 120-degree phase difference between phases when the phase angle is changed (by field entry or dial). In negative sequence, the signs of phases b and c are inverted.</li><li><strong>Zero (homopolar):</strong> Phases a, b, and c are in phase (0-degree differential). Modifying one phase applies the same value to the others.</li><li><strong>Per phase:</strong> Allows setting the same angle for selected phases. Modifying one selected phase applies the same value to the other selected phases.</li></ul></td></tr><tr><td><strong>Base Power (total)</strong></td><td>Base three-phase power (MVA).</td></tr><tr><td><strong>Base voltage (rmsLN)</strong></td><td>Base voltage, phase-to-ground (kV).</td></tr><tr><td><strong>Base Frequency</strong></td><td>Base frequency (Hz).</td></tr><tr><td><strong>Amplitude (peak)</strong></td><td>Peak source voltage per phase (V or pu).</td></tr><tr><td><strong>Angle</strong></td><td>Phase angle per phase (degrees). The input of the angle varies according to the selected phase sequence.</td></tr><tr><td><strong>R</strong></td><td>Resistance (ohm or pu).</td></tr><tr><td><strong>L</strong></td><td>Inductance (H or pu).</td></tr><tr><td><strong>C</strong></td><td>Capacitance (F or pu).</td></tr></tbody></table>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-05403a39c2b5fa929006d35cf71e02af8af7865d%2Ffast_slow_mode.jpg?alt=media" alt=""><figcaption><p>a) fast mode b) slow mode</p></figcaption></figure>
{% endtab %}

{% tab title="Load Flow" %}
These parameters can be used for the steady-state solution of the network.

| Parameter           | Description                                                                                                                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Type**            | <ul><li><strong>PQ:</strong> P and Q specified; V and θ calculated.</li><li><strong>PV:</strong> P and V specified; Q and θ calculated.</li><li><strong>Swing:</strong> V and θ specified; P and Q calculated.</li></ul> |
| **Voltage**         | Per-unit voltage. Specified for PV-bus and Slack-bus; calculated for PQ-bus.                                                                                                                                             |
| **Angle**           | Phase angle of voltage (degrees). Specified for Slack-bus; calculated for PQ-bus and PV-bus.                                                                                                                             |
| **Q minimum limit** | Minimum reactive power generation limit for PV-bus (Mvar).                                                                                                                                                               |
| **Q maximum limit** | Maximum reactive power generation limit for PV-bus (Mvar).                                                                                                                                                               |
| **P**               | Specified generation for PV-bus and Slack-bus; specified load for PQ-bus (MW).                                                                                                                                           |
| **Q**               | Specified load for PQ-bus; calculated within limits for PV-bus; calculated for Slack-bus (Mvar).                                                                                                                         |
| {% endtab %}        |                                                                                                                                                                                                                          |
| {% endtabs %}       |                                                                                                                                                                                                                          |

{% hint style="info" %}
**SI or pu units**

* **SI:** Specifies the values of the RLC elements, voltage, current or frequency in international units (ohm, henry, farad, volt, ampere and hertz);
* **pu:** Specifies the values of the RLC elements, voltage, current or frequency in pu;
  {% endhint %}

## Conserving ports

| Port               | Description                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------- |
| **Net\_1, Net\_2** | The current source injects a current from one bus (port) to another (port), without grounding. |

## Inputs

This block has no inputs.

## Outputs

This block has no outputs.

## Signals available for monitoring and external I/O connections (via sensors form)

All block inputs and outputs are available as signals for monitoring and for external I/O connections.

Additional signals are also available and are listed below with their descriptions.

| Signal   | Description                    |
| -------- | ------------------------------ |
| **I**    | Measured current (source) (A). |
| **VINT** | Source voltage signal (V).     |


---

# 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/hypersim/library-blocks-reference/network-sources/ac-v-source.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.
