Using the PEC Module

PEC in smile2 is implemented as two plug-ins:

Performs the calculation of the dose map.

Performs fracturing. Depends on the map_pec plug-in. Is actually only needed if you do not want to use (or cannot use) etp2.


The shape_pec plug-in is not yet ported to the new API introduced in smile2 2.0.1 and therefore not included in smile2 version 2.0.1. It will be re-added in a future update.


Both modules do not calculate absolute dose maps but dose scale maps, containing scale factors that are multiplied to the absolute dose (or dell times).

Preparing smile2

Before enabling PEC in a document, make sure the plug-in(s) are loaded. How a plug-in is loaded in smile2, is described in the Plug-In Manager section.

If one or both plug-ins are loaded, the PEC menu in the main menu (visible in the edit and write mode) is not empty.

The menu entries in edit mode are intended for pre-calculation, and management of map caches.

The menu entries in write mode, are intended for applying or removing PEC from structure elements.

Enabling PEC in a structure

smile2 offers pre-calculated version, and one where the correction map is calculated just before the exposure starts.


The commands Calculate Map PEC Cache (calcMapPecCache) and recalcMapPecCache can be used to pre-calculate map cache. They are accessible form the PEC main menu entry in edit mode.

A document can contain an arbitrary number of map caches (a (PEC) map cache is a node, holding the map data, and information about the region).


Use the Data map cache list utility to edit and review existing map caches.

In contrast to older versions of smile2, a pec map cache, can be calculated also for a (sub-)region of the structure and is independent (and still valid if one of these changed) of

  • the write field size
  • the hardware settings
  • any kind of alignment matrix


Once you calculated the map, you should not modify the geometry covered by the map in the structure. If modification are necessary, the doc:/commands/recalcMapPecCache can be used to recalculate the cache(es).

On-the-fly calculated

In contrast to the pre-calculated method, the calculation for this method is performed “just before exposure”.


Proximity effect correction can be enabled per exposure task element in write mode.

To enable PEC, using a pre-calculated map,

  • select the corresponding exposure task element
  • From the main menu: Choose PEC -> Attach Map Pec Cache.
  • Choose the map you want to use (of cause you should have at least one pre-calculated map in your structure), and press Execute & Close.

To enable PEC, using on-the-fly calculation,


The parameters for the on-the-fly calculation, can be found in the settings sheet (in the attribute editor) of the structure element as an additional tab, and can be changed any time before exposure.

Both, the Attach Map Pec Cache and the Setup Map Pec command create a node (either a ImageMapPECCache or a ImageMapPECGen node) and sets it to the streamBundleFilter plug of the exposure task element. If such a node is present for a exposure task element, a “filter” icon is displayed in a corner of this exposure task element in the document view. Additionally, the properties of the filter node can be found as an additional tab in the exposure task element settings sheet.


If stitching is enabled, the cached and the on-the-fly calculated one behave different:

  • For the cached version, the map (still on map for all stitching fields) is to all stitching fields.
  • The on-the-fly calculated node performs the calculation separately for each stitch field.

We recommend, do avoid stitching and PEC together. Create a more flexible array arrangement instead of one exposure task element with stitching enabled.