i2PEPICO Analysis + PIMP - package 3.41, 20 October 2026

Start i2PEPICO_Analysis_3.41.exe. This is analysis only: it cannot take measurements.
Keep script.dat and i2PEPICO_Analysis_3.41.ini beside it. Its channel table is
embedded; channels.dat is optional. The ini starts the program with the image,
TOF, coincidence and script windows open and the coincidence set to
electron (Im1, TOF start, image 1) -> ion (Im2, TOF stop 0-20 us, image 2),
so the Load button shows both images and the TOF spectrum of the selected file.
The program saves its settings to this ini on exit; delete the ini to return
to the program defaults.
i2PEPICO Analysis and ScriptImport are Windows programs. PIMP (pim.py) also runs
on macOS and Linux.

New in 3.41
Export2D and Export2DSlices can count only the ions that hit a region of the
ion image: set UseIonROI := 1 and IonROI (for example a ROICircle, or
CurrROI[Im2] for the ROI drawn on the ion image) before the call. With
UseIonROI 0 or unset, the whole ion image is used and the export is identical
to 3.4; with an ion ROI, the index records it in an IonROI: line, which PIMP
ignores. The Imports no longer fill result images (they save TOF spectra only),
which saves memory. ScriptImport prints its version and bundle label on every
run. See "Export2D: export for PIMP" in Manoscript_3.41.pdf.

Export for PIMP
The bundled script.dat already has the four analysis Imports and
Process > Examples > Export2DExample. Select your raw input folder, check the
example's ROI and file pattern, then run it as a Process script.
UseSLS1 := 0 selects SLS2; use 1 for historical SLS1, including the bundled
HomogeneousIllumination.i2d (2014). Results go into Export2D_example below the
input folder. Rerunning replaces that export. To count only the ions in a region
of the ion image, uncomment and adapt the example's UseIonROI and IonROI lines.
Examples\Export2DSlicesExample.scr exports one raw file as time slices into its
own, empty folder, optionally only a time window of it at a finer width.
Open such a folder in PIMP when the export has finished, as the only loaded
folder; its y-axis is the slice time (or delay after the trigger) in ms.

Use the Imports in your own script.dat
ScriptImport.exe contains the necessary Imports for data analysis
(Export2D, Export2DSLS1, Export2DSLS2, Export2DSlices). Do not replace your own
script.dat with the bundled database. Close the i2PEPICO that uses that script.dat
(the one started from the same folder), then either
  - copy ScriptImport.exe beside your script.dat and double-click it, or
  - drag your script.dat (or its folder) onto ScriptImport.exe.
It prints its version and bundle label, shows what it added, replaced or
renamed, and waits for Enter.
If an i2PEPICO started from that folder is still running, it asks before
writing: that program would overwrite the update when it saves or exits.
ScriptImport adds missing Imports and updates matching ones, preserving all
other folders/scripts and making a backup beside the target database.
To preview without writing, run from a terminal:
  .\ScriptImport.exe --dry-run "C:\MyAnalysis\script.dat"
Export2DExample.scr is in Examples: paste it into your Process folder,
not Imports. No measurement scripts or Export2DMeas are needed for analysis.
The standalone examples save the executed script with SaveMyself in each export
folder (rebuild saves beside the raw files). Those folders must be writable.

Start PIMP
Install Python 3.10 or newer with Tkinter (the python.org installers include
it). From a terminal in this package folder:
  python -m pip install -r requirements.txt
  python pim.py
On macOS and Linux, use python3 instead of python.
Use + to add the exported folder containing 2D_TPES_index.txt.
PIMP autosaves its workspace as pim.autosave.pepico.json beside pim.py.
Requirements install NumPy, Matplotlib and pygame-ce. If upgrading an environment
with the original pygame installed, uninstall pygame before installing these
requirements. Both distributions provide the same pygame module.

Version history
3.41 (October 2026): optional ion ROI for the Export2D and Export2DSlices
    exports (UseIonROI, IonROI); ScriptImport version header.
3.4 (October 2026): time slicing of one raw file (Export2DSlices), the bundled
    electron -> ion settings, a rewritten scripting manual.
3.3 (October 2026): Imports in ManoScript and export folders for PIMP
    (Export2D), ScriptImport.
3.2 (August 2026): SLS 2.0 support (SLS2 beamline channels, i2d version 4).
Details are in the version history at the end of Manoscript_3.41.pdf.

Manuals
pim.pdf: current PIMP export, matrix, Peaks, breakdown, 3D and workspace guide.
Manoscript_3.41.pdf: i2PEPICO scripting reference, including the shipped Imports.
