> 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/model-and-simulation/edit-a-model-schematic/design-templates.md).

# Design Templates

## **Overview** <a href="#how-design-templates-work" id="how-design-templates-work"></a>

A **design template** is a standard design file with **predefined settings** such as sheet size, attribute fields, hierarchy mode, and other configuration options.

When a new design is created from a template, HYPERSIM loads the template, assigns the new design a unique name (such as *Circuit1*), and disconnects it from the original file to prevent accidental overwriting. All settings and retained content from the template are copied into the new design, providing a consistent starting point for future projects.

## Create a design template

To create a template, you can start with an existing design, remove all circuit elements and unnecessary pages, and save it in the **template directory:**

C:\OPAL-RT\HYPERSIM\\\<hypersim\_version>\Windows\HyperWorksUI\Templates

Template files can be assigned any valid file name. The file name is used as the **template name** when it appears in the template list.

A key template attribute is **DesignType**, which identifies the template and can be referenced by automation scripts. In the default HYPERSIM template, **DesignType** is set to HYPERSIM, and the template includes a predefined set of attributes intended for HYPERSIM simulations.

{% hint style="danger" %}
Design templates are an integral part of the HYPERSIM open architecture. They should be used and modified with caution to prevent corruption of simulation data and critical built-in attributes.
{% endhint %}

Keep in mind that software updates may modify the built-in templates. If you have created custom templates based on them, you may need to update them to include new attributes and settings. While many changes can be applied using patch scripts, the recommended approach for major updates is to recreate your custom template from the latest **HYPERSIM.ecf** template and reapply your modifications.

### Add a title block

In addition to defining attributes and settings, a common use of templates is to create a **title block**. The title block is stored in the template and automatically appears in all designs created from that template.

Simple title blocks can be created using the **Text Tool** and configured through the **Text Object Options** dialog (**Ctrl+I**). For a more professional appearance, title blocks can also be created as graphics in an external drawing application and imported into the template, as shown below.

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

[Attributes](https://github.com/Opal-RT-Technologies/product-docs-hypersim/tree/release-2026.4/model-and-simulation/edit-a-model-schematic/display-attributes-and-variables-on-the-schematic.md) can be used for automatically updating the various stamp fields.

## Sheet template

A **sheet template** is used with the **Options > Design > Import Sheet Info** command to apply sheet-specific settings such as the border, title block, and print setup.

While these settings can be included in a design template, sheet templates provide flexibility by allowing different sheet layouts and border styles to be applied within the same design. Typically, **design templates** define application settings, attributes, and scripts, while **sheet templates** are used to customize the sheet appearance.

### Sheet sizes and borders

HYPERSIM does not include predefined sheet sizes. Sheet borders and page layouts can be customized for each design or imported from an existing design or template.

Because HYPERSIM supports a wide range of printers, plotters, and media formats, the relationship between the drawing area and the printed output can vary. Understanding these settings helps ensure that schematics are displayed and printed as intended.

The following information is included in a complete sheet definition:

* Sheet width and height (drawing area size)
* Location grid origin and spacing
* Border text format and style
* Whether the border size is linked to the current printer page setup
* Whether the sheet can automatically expand across multiple pages
* Any text or graphic objects designated as border items

Together, these settings define the sheet layout, appearance, and printing behavior.

HYPERSIM provides two ways to define sheet size and border layouts:

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-5cf9efa69a678174aea9750efc093879e734fc08%2Fsheet-template.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Import an existing layout** using **Options** > **Import Sheet Info**. This is the quickest method and uses the settings from an existing design or template.
* **Create a custom layout** using **Options** > **Sheet Size Wizard** and **Options** > **Border Wizard**. This method allows you to define the sheet size, drawing grid, border style, title block, and graphics to meet your drawing standards.

## **Import sheet settings from another design, page or template** <a href="#importing-sheet-settings-from-another-design-page-or-template" id="importing-sheet-settings-from-another-design-page-or-template"></a>

If another page, design, or template already contains the desired sheet and border settings, they can be imported into the current design using the **Import Sheet Info** command.

This command:

* Removes all current text and graphic objects marked as **Border** items.
* Copies all **Border** text and graphic objects from the source page or design. The **Border** property is set individually for each object through its **Properties** dialog.
* Copies the sheet settings, including sheet size, grid configuration, and border text settings.
* Optionally copies the printer page setup.

{% hint style="info" %}

* When importing from a design file, only the settings and border items from **Page 1** are imported.
* Circuit elements and design attributes in the destination design are not affected by the import operation.
  {% endhint %}

## **Use the Sheet Size Wizard to custom sheet size** <a href="#custom-sheet-size-using-sheet-size-wizard" id="custom-sheet-size-using-sheet-size-wizard"></a>

### Select which pages to modif

If the design contains more than one page, the Sheet Size Wizard displays the following initial screen. Settings can be applied to individual pages or to the entire design.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-91fbc12b3d83953355e2c157337486f3bc9cd240%2Fsheet-size-wizard-1.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

### Select fixed or auto-scaled border

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-83fad590f6e1cd0ad0d4822b8a38e486ea972b25%2Fsheet-size-wizard-2.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

<table><thead><tr><th width="169.66668701171875">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>Scale border to match printer setup</strong></td><td>Selecting this option causes the current printer setup to be used to determine the sheet size. Any changes in print setup (using the Print Setup command in the File menu) will immediately affect the sheet border.<br>This is the recommended setting for most cases as it provides a guaranteed match between the drawing area and the output device.<br>The only disadvantage of using this setting is that the sheet size will change if printer’s settings changed. Most printers have slightly different printable areas, even on the same size paper.</td></tr><tr><td><strong>Fixed border size</strong></td><td>Selecting this option causes fixed values to be used for the border size and position (as it appears on the screen), regardless of printer page setup.<br>The advantage of this setting is that the sheet configuration will remain fixed regardless of changing output devices.<br>The disadvantages are that the border size may not fit exactly to the aspect ratio of the printable area on the user’s printer. Choose the desired border scaling method and click Next.</td></tr></tbody></table>

{% tabs %}
{% tab title=" Scaled border Size" %}

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-8e49c4197e52fb189539e375ffe9573dc6e7c788%2Fsheet-size-wizard-3.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

<table><thead><tr><th width="180.11114501953125">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>Single printed page</strong></td><td>When this option is selected, the drawing border on the screen will always match the current printer page setup. Any change in printer setup will automatically be reflected in the sheet displayed on the screen.<br>This is the simplest setting and recommended for most case.</td></tr><tr><td><strong>Auto-expand</strong></td><td>This setting also adjusts to match the printer page setup, but automatically expands to use multiple pages if the user draws outside the current border. This will allow assembling larger drawings by piecing together a number of smaller sheets.</td></tr><tr><td><strong>Advanced</strong></td><td>The advanced setting is similar to Auto-expand but allows specifying exactly how many sheets high and wide the user wants to display, plus it allows an additional scale factor to be applied to shrink or expand the output.</td></tr></tbody></table>
{% endtab %}

{% tab title=" Fixed border size" %}

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-11d12eae3025b327f27a98cb88ed058d9a10c00d%2Fsheet-size-wizard-4.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

Using these controls, the user can select a standard sheet size or enter a custom sheet size.

These settings determine only how the sheet is displayed in HYPERSIM and do not automatically select a corresponding paper size for the default printer. Printer settings must be configured separately using the **Print Setup** command. The list of standard sheet sizes is defined in the **hyperworks.ini** initialization file and can be customized as needed.

After selecting the desired sheet size, click **Next**.

The next step of the wizard lets the user specify how the page should be handled during printing. When the **Fixed Size** option is selected, HYPERSIM must determine how to print the sheet if its dimensions do not exactly match the printable area of the selected paper size.

<table><thead><tr><th width="180.111083984375">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>Scale to fit printed page</strong></td><td>In this case, HYPERSIM will scale the drawing to fit into the available printed area for the selected printer. The controls can be used to specify that the drawing should be stretched onto multiple pieces of paper.</td></tr><tr><td><strong>Fixed scale factor</strong></td><td>With this setting active, the program will scale the drawing by a fixed amount (default 100%) for printing. This guarantees that the drawing will be a known size on paper, but may require that it be broken into multiple printed pages, depending on the settings.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## **Use the Border Wizard to custom sheet borders** <a href="#custom-sheet-size-using-sheet-size-wizard" id="custom-sheet-size-using-sheet-size-wizard"></a>

The **Border Wizard** command allows you to configure:

* The size and visibility of the drawing border.
* The layout of the reference grid, including the letters and numbers used to locate items on the sheet.
* The size and visibility of the background grid.

These settings control the appearance and organization of the drawing workspace.

### Select the border design

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-647df66b271666b02e648b539fc5e80845792a00%2Fborder-wizard-1.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

<table><thead><tr><th width="199.77783203125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Border Orientation</strong></td><td>Determine the usage of letters and numbers for sheet grid references.<br>This setting affects the position displayed on Page Connectors, in the Pin List box and in report output.</td></tr><tr><td><strong>Show default border on screen</strong></td><td>Determines whether the default sheet border is drawn around the drawing area on the screen.</td></tr><tr><td><strong>Print default border</strong></td><td>Determines whether the default sheet border is drawn in printed or PICT file output.</td></tr><tr><td><strong>Border Font</strong></td><td>Displays the standard text style dialog box allowing the user to select the text style for the default border. This has no effect if both Print Default Border and Draw Default Border are off.</td></tr><tr><td><strong>Border Width</strong></td><td>Allows the user to specify an exact width for the border or have it calculated automatically based on the text size setting.</td></tr></tbody></table>

### Select the drawing grid options

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-fe1dbeb47733e2f62b79cc50875efc7e3b7a28c7%2Fborder-wizard-2.png?alt=media" alt="" width="437"><figcaption></figcaption></figure>

<table><thead><tr><th width="199.77777099609375">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>Specify the number of grid sections</strong></td><td>Allows the user to specify exactly how many grid sections are displayed with the controls.<br>The size of the grid sections will be adjusted automatically to match any changes in sheet size.</td></tr><tr><td><strong>Specify the size of the grid sections</strong></td><td>Forces the grid sections to be a fixed size, regardless of changes in overall sheet size. In this case, the grid section width may not exactly divide into the sheet width, so the user must also specify how to handle any leftover space.</td></tr><tr><td><strong>Show background grid on screen</strong></td><td>If this switch is on, the background grid determined by the previous settings is drawn on the screen.</td></tr><tr><td><strong>Print background grid</strong></td><td>Determines whether the background grid is included in printed or graphics file output.</td></tr><tr><td><strong>Number of minor grids per major grid</strong></td><td>Determines how many minor grid divisions are drawn per major division. The default value is 3, entering 1 in effect disables minor grid lines.</td></tr></tbody></table>

{% hint style="danger" %}
Even when the **drawing grid is hidden**, these settings still determine how the sheet's letter/number reference grid is generated. This reference information is used by various commands and reports to identify and locate items on the sheet.
{% endhint %}

### Create custom sheet border graphics

Any text or graphic object can be designated as part of the sheet border.

To add an object to the sheet border:

1. Select the object.
2. Open the **Properties** dialog (**Ctrl+I** or **Properties** from the right-click menu).
3. Enable the **Make Background** and **Make Border** options.
4. Click **OK**.

The object is now treated as a border item and becomes part of the sheet layout. For more information on creating and managing border and background objects, see **Background Objects and Border Objects**.

## Create multipage templates

HYPERSIM supports multi-page circuits, allowing logical connections to be maintained across multiple schematic pages. New designs are created with a single page by default. Additional pages can be added using the **Pages** command in **Options** ribbon and selecting **New Page**.

For designs that regularly require multiple pages, a multi-page template can be created and reused as the starting point for new projects.

For more information on working with pages, see **Adding, Deleting, and Titling Circuit Pages**.

### Sheet Border Setup for Multi-Page Designs

When a new page is added, HYPERSIM automatically copies the sheet settings and all border text and graphic objects from the previous (last) page. Therefore, it is generally best to configure the border layout on the first page before adding additional pages.

If border settings need to be changed later, they can be updated on all pages using the **Import Sheet Info** command.


---

# 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/model-and-simulation/edit-a-model-schematic/design-templates.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.
