> For the complete documentation index, see [llms.txt](https://help.pesipiuma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pesipiuma.app/en/using-pesipiuma/using-the-importers/dxf.md). # DXF and RUL The DXF importer is the main Pesipiuma v3 workflow for creating a project directly from CAD geometry. It reads the pattern pieces from a **.dxf** file, detects the padded sections, creates the size and piece structure in the editor, and generates the report from the processed geometry. If the model is graded, you can also upload a **.rul** file. The RUL file is optional: when it is not provided, Pesipiuma processes the DXF without grading. {% hint style="info" %} The active importers in the workspace are the ones included in the subscribed plan. If you need to add the **DXF** import method, contact support; for Business or Enterprise plans, contact your system administrator. {% endhint %} {% hint style="warning" %} **DXF piece orientation** Before exporting or importing the DXF, check the grainline for each padded piece. Pesipiuma uses the grainline to orient SVG previews and the PDF report: pieces are placed with the grainline vertical. If you need a different placement in the report, set the grainline direction accordingly in CAD before exporting the DXF. {% endhint %} ## Files required To import a DXF project you need: * A **.dxf** file containing the model geometry. * Optionally, a **.rul** file containing the grading rules for the model sizes. {% hint style="warning" %} Each project can use one import method. After a project has been imported with DXF, it cannot be switched to Excel import. Create a new project if you need to use a different import method. {% endhint %} ## Start a DXF project 1. Create or open a project from the Dashboard. 2. If the project is empty, choose **Start with DXF**. 3. If the project already uses DXF, click **Import DXF** or **Replace DXF** in the editor toolbar. 4. In the **Import DXF File** window, drag the files into the upload area or click it to select them. 5. Add the required **.dxf** file and, if available, the optional **.rul** file. 6. Click **Upload files**. After the upload finishes, Pesipiuma opens the **DXF Preview** before replacing the editor data. ## Review the DXF Preview The DXF Preview lets you check the detected geometry before saving it to the project. At the top of the preview you can adjust: * **DXF processor**: use **Auto** by default, or choose a specific processor profile when the CAD source requires it. * **Area threshold**: the minimum area, in cm², used to ignore very small detected sections. * **Default coeff.**: the coefficient assigned to imported pieces before manual editing. * **Text Annotations**: keep this enabled to import supported DXF text annotations; disable it when imported texts are not useful for the report. * **Avoid overlap**: enable it when section numbers are very close and need to be separated slightly in the preview and report. The preview shows one card for each detected piece. Each card contains the piece drawing and the list of detected sections. Each piece card also lets you refine that single piece: * Piece **Area threshold**: changes the threshold only for that piece. It can apply to all sizes or only to the selected size. * **Qty** and **Coeff**: set the starting quantity and coefficient for the piece before confirmation. * **Avoid overlap**: applies close-label handling only to that piece. {% hint style="info" %} If the project has multiple sizes, use the size tabs to inspect them. The base size remains the main size for including or excluding sections and for setting quantities and coefficients. On other sizes you can check the grading result, adjust the piece area threshold, and correct size-specific merges when needed. {% endhint %} ## Select and merge sections In the base-size preview you can refine the detected sections before confirming the import: * Click a section to include or exclude it. * Hold **Shift** and click sections to merge them into one group. * Hold **Alt** + **Shift** and click to start a new merge group. Excluded sections are shown with a red style. Merged groups are shown with matching colors in the drawing and in the section list. Enable the **Stitching** checkbox on a merged group when the sections must count as one area but still show their shared separator as a dashed stitching line in previews and reports. When a merged group is created on the base size, Pesipiuma tries to apply it to the graded sizes too. If one graded size needs a different correction, use **Shift** on that size to create or edit a merge that applies only to that size. {% hint style="warning" %} If a non-base size shows a section-count warning, check that size carefully before confirming. The button beside the size tabs helps you find these cases: a green check means there are no warnings, while an orange icon means there are pieces to review. Click it to temporarily show only the pieces with warnings. {% endhint %} ## Confirm the import When the preview is correct, return to the base size and click **Confirm**. Pesipiuma saves the imported data to the project: * Sizes are created from the DXF/RUL processing result. * Pieces are created from the detected pattern pieces. * Sections are created from the detected padded areas. * Piece SVG previews are generated automatically. * The project is marked as a DXF project. After confirmation you can edit piece names, quantities, coefficients, section coefficients, section notes, and other project data directly in the editor. ## Target weight After importing a DXF project, you can enable **Target Weight** from the size toolbar. When target weight is enabled: * Enter the target weight in grams for the base size. * Pesipiuma uses that value to calculate report weights relative to the base size. * Coefficients are shown as percentages because they represent the scaling used to reach the target weight. Turning the switch off disables target-weight scaling for the project. ## Recalculate pieces Use **Recalculate pieces** when you need to reread the uploaded DXF/RUL files and rebuild the project geometry. Before the recalculation starts, Pesipiuma asks for confirmation. The original files are processed again, while the current area threshold, piece or size thresholds, ignored sections, merged sections, stitching options, coefficients, notes, quantities, **Avoid overlap** settings, annotations, and manual label positions are reapplied when possible. {% hint style="warning" %} Recalculation replaces the saved sizes, pieces, and sections with the newly processed geometry. Review the preview carefully before confirming. {% endhint %} ## Open the report Click **Open Report** to generate a fresh PDF report from the latest saved editor data. For DXF projects, the report is generated from the processed geometry, the saved piece and section data, the current target-weight setting, and the latest report-ready edits. Section labels are calculated from the piece geometry. Pesipiuma tries to keep them centered and aligned; when **Avoid overlap** is enabled, it may move only the labels that are too close to each other. Manual label positions set in the editor are used in the PDF too. ## Download or delete the source files When a DXF file has been uploaded, the file actions menu next to **Replace DXF** lets you: * **Download DXF+RUL**: download a ZIP archive containing the saved DXF file and the RUL file, if one was uploaded. * **Reset project data**: delete editor data, preview settings, reports, and generated artifacts while keeping only the uploaded DXF/RUL files so the project can be processed again from zero. * **Delete DXF** or **Delete DXF+RUL**: remove the uploaded source files from the project. {% hint style="info" %} Deleting the uploaded DXF/RUL files does not delete the editor data that has already been saved. To recalculate the geometry, import a new DXF file; report opening also requires a saved geometry snapshot. {% endhint %} --- # 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 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/using-the-importers/dxf.md?ask= ``` 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.