This page contains a description of the version of StackMaps included in XMapTools via the add-on system. Additional information about the standalone version of StackMaps can be found here.

StackMap 1.0 by Julien Reynes

How to add StackMaps to XMapTools?

StackMaps can be downloaded directly via the XMapTools interface using the Extension manager:

  1. Open MATLAB©, set the working directory and open XMapTools
  2. In menu, select File > Add-Ons > Manage Extensions
  3. Find StackMaps in the Extension manager
  4. Press the button Download (or Delete & Download to update the add-on)
  5. XMapTools downloads and install the add-on

Requirements & Opening StackMaps

You need to have the reference maps (e.g. X-ray maps) already imported in XMapTools before to use StakMaps.

  1. Import your maps in XMapTools and save your project
  2. Go to the workspace X-ray
  3. Select StackMaps in the add-on menu and click APPLY
  4. StackMaps extension opens and load the maps available in the workspace X-ray. Those should be used as reference images in stack map (left image)


  1. Select the map to be used as reference in the top left menu
  2. Press the button (1) Add Map to import the map to be transformed; note that only text files can be opened in StackMap (see the XMapTools user-guide for a description of compatible files)
  3. (Optional) use the rotate button Rot to adjust the orientation of the map in the central panel and select a color palette in the menu
  4. Set references points in the reference image (left) by pressing the button (2) Set reference points. Set the size of the zoom window (default 50 px) and left-click on the image first to zoom in and then to select a point. At least three points are required. Left-clicking validate the selection.
  5. Select the same reference points in the central image (to be scaled) using the button (3) Set reference points
  6. Click (4) Save transformation to save the geo-transformation data and select a file name. Transformation files are saved in a subdirectory (/Transformations/…)
  7. In the transformation panel below, select the reference image and the map to be adjusted (deformed image), the transformation file and press (5) Apply transformation
  8. The transformed image is displayed in the right display panel
  9. Select (6) Save image (as matrix) to generate the map to be imported in XMapTools
  10. Close StackMap and import the save file in XMapTools