# Editor Interface

The **Editor** is the project workspace where you import source files, review the generated pieces, adjust piece and section data, and open the PDF report.

The available controls depend on your workspace role and on the import method used by the project. Users with read-only access can inspect saved data and open existing reports, while users with edit permissions can import files, recalculate geometry, edit values, and regenerate reports.

{% hint style="info" %}
An empty project first asks you to choose an import method. After the first import, the project remains linked to that method: **DXF** projects keep the DXF/RUL workflow, while **Excel** projects keep the Excel workflow.
{% endhint %}

## Top toolbar

The top toolbar contains the main project actions:

* **Dashboard**: return to the project dashboard.
* **Project name**: click the project name to rename it, if you have edit permissions.
* **Import DXF** or **Replace DXF**: upload the DXF file and optional RUL file for a DXF project.
* **Import Excel** or **Replace Excel**: upload Excel source files for an Excel project.
* **Download DXF+RUL** or **Download Excel**: download the saved source files from the file actions menu.
* **Delete DXF**, **Delete DXF+RUL**, or **Delete Excel**: remove uploaded source files without deleting the saved editor data.
* **Add Image** or **Replace Image**: add or replace the report image used by Excel projects.
* **Recalculate pieces**: reread the uploaded DXF/RUL files and rebuild the project geometry after reviewing the preview.
* **Open Report**: generate, refresh, or open the PDF report.

{% hint style="warning" %}
Deleting uploaded DXF/RUL files does not delete the editor data already saved in the project, but report generation and recalculation stay unavailable until a new DXF file is imported. Deleting Excel source files keeps the saved editor data and report image.
{% endhint %}

## Size toolbar

The size toolbar appears below the main toolbar. It lets you move between the sizes available in the project.

The base size is marked in the size list. For DXF projects, the base size is defined by the processing result. For Excel projects, users with edit permissions can set the base size from the size toolbar.

When source data is available, users with edit permissions can also enable **Target Weight** from this toolbar. Target weight is entered in grams for the base size. When it is active, coefficients are shown as percentages because they represent the scaling used to reach the target weight.

{% content-ref url="/pages/VZOnN27oVB0DVbN0JGZo" %}
[Set a Target Weight](/en/using-pesipiuma/preliminary-operations/set-a-total-weight.md)
{% endcontent-ref %}

## Main work area

The main work area is organized around the selected size and piece.

### Pieces list

The left side shows the **Pieces List** for the selected size. Select a piece to inspect it in the center of the editor and show its sections on the right.

Pieces are sorted by their display name. When you switch size, the editor tries to keep the same piece selected in the new size.

### Piece preview

The center of the editor shows either:

* A grid of all pieces for the selected size, when no single piece is selected.
* The selected piece preview, when a piece is selected.

For DXF projects, the preview is generated from the processed piece SVG. For Excel projects, the editor uses the uploaded report image and saved label positions.

In the all-pieces grid or the **Pieces List**, users with edit permissions can Shift-click pieces and open **Edit details** to update coefficient, quantity, rounding, and DXF section label overlap handling in bulk. If one piece is already open, Shift-clicking another piece includes the open piece in the selection. Bulk edits are applied to the matching graded pieces across sizes.

### Piece details

When a piece is selected, click **Edit Piece** to update:

* Piece name.
* Coefficient.
* Quantity.
* Weight rounding.
* Section label overlap handling.

You can also choose whether the piece coefficient should update all section coefficients for that piece. When **Avoid section label overlap** is enabled, Pesipiuma may move close section numbers slightly apart in the preview and report.

### Sections

The right side shows the section list for the selected piece. For each section you can review or edit:

* Area.
* Coefficient.
* Notes.

Selecting a section highlights the matching area in the piece preview. Section notes and custom section coefficients are shown in the report output.

{% hint style="info" %}
For DXF projects, removing a section excludes it from the editor and from generated reports. If the piece exists across multiple sizes, you can choose whether to remove the matching section from all sizes.
{% endhint %}

## Import previews

When importing or replacing source files, Pesipiuma shows a preview before saving the new data to the project.

For DXF imports, the **DXF Preview** lets you review detected pieces and sections, adjust the area threshold, include or exclude sections, merge sections, choose section-label overlap handling globally or per piece, and confirm the result.

{% content-ref url="/pages/un3Ry3PJm5UmW5pDuzEx" %}
[DXF and RUL](/en/using-pesipiuma/using-the-importers/dxf.md)
{% endcontent-ref %}

For Excel imports, the **Excel Preview** lets you check the source data and select the base size before confirming the import.

## Read-only access

Users with read-only access can open projects, inspect sizes, pieces, sections, SVG previews, Excel images, and saved reports. Editing actions such as import, replacement, recalculation, piece edits, section edits, label moves, and report regeneration are hidden or disabled.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pesipiuma.app/en/using-pesipiuma/introduction/editor-interface.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
