xrit2pic

Contents:

Downloads and installation Linux
Downloads and installation Windows
New in last release
Short manual and examples

Download for Linux 64-bits

Version Program Download Linux 64 bits Compiled using Comment
2025.3b xrit2pic xrit2pic64_2025_3b.tgz Ubuntu 20.04.1 See release notes.
xrit2pic_cmd xrit2pic_cmd64_2025_3b.tgz Ubuntu 20.04.1
2024 HDF5 libs libhdf5_decompr.tgz
Needed from xrit2pic version 2023 on (5 libs)
Contains installation script with guide.
2006.09/
2021.01 JPEG and wvt
decompression libs decompr64.tgz

2.0 Needed gtk-libs sudo apt-get install libgtk2.0-dev

Version	Program	Download Linux 64 bits	Compiled using	Comment
2025.3b	xrit2pic	xrit2pic64_2025_3b.tgz	Ubuntu 20.04.1	See release notes.
xrit2pic_cmd	xrit2pic_cmd64_2025_3b.tgz	Ubuntu 20.04.1
2024	HDF5 libs	libhdf5_decompr.tgz		Needed from xrit2pic version 2023 on (5 libs) Contains installation script with guide.
2006.09/ 2021.01	JPEG and wvt decompression libs	decompr64.tgz
2.0	Needed gtk-libs	sudo apt-get install libgtk2.0-dev

Installation Linux

GUI version: (needs gtk2, option -nogui works as xrit2pic_cmd)
- tar -zxf xrit2pic64_<release>.tgz
  -> gives executable xrit2pic, put it in your ~/bin
Command version:
- tar -zxf xrit2pic_cmd64_<release>.tgz
  -> gives executable xrit2pic_cmd, put it in your ~/bin
both versions:
- tar -zxf decompr64.tgz
  -> gives jpeg812.so, libwvt.so; put them besides the program or in /usr/lib
- tar -zxf libhdf5_decompr.tgz
  -> follow guide 'instal_mtglibs.sh'

Download for Windows 64-bits

Version Program Download Windows 64-bits Comment
2025.3b xrit2pic setup_xrit2pic32_2025_3b.exe See release notes.
xrit2pic_cmd setup_xrit2pic_cmd64_2025_3b.exe
2023 all needed libs setup_xrit2pic_libs64.exe See below.

Version	Program	Download Windows 64-bits	Comment
2025.3b	xrit2pic	setup_xrit2pic32_2025_3b.exe	See release notes.
xrit2pic_cmd	setup_xrit2pic_cmd64_2025_3b.exe
2023	all needed libs	setup_xrit2pic_libs64.exe	See below.

Installation Windows

Command version: download and run:
- setup_xrit2pic_cmd64_<release>.exe
- setup_xrit2pic_libs64.exe
for GUI download and run:
- setup_xrit2pic32_<release>.exe
- setup_xrit2pic_libs64.exe

what	install program	Default location	comments
program	setup_xrit2pic_cmd64_<release>.exe	\tools\alblas
libs	setup_xrit2pic_libs64.exe	\tools\alblas
plugin	setup_xrit2pic_libs64.exe	\ProgramData\hdf5\lib\plugin
program gui +extra libs	setup_xrit2pic32_<release>.exe	\tools\alblas	Only needed for gui! See gui comments

Result installed Windows

type	exe/dll	contains	Install location
executable	xrit2pic_cmd.exe	The program	\tools\alblas
Libs	jpeg812_64.dll	jpeg 8/12-bits	\tools\alblas
	wvt_64.dll	Wavelet decompression
	libstdc++-6.dll	needed for wvt.dll
	libwinpthread-1.dll
	libgcc_s_seh-1.dll
	hdf5.dll	hdf5, suitable for fcdi decompression
	zlib.dll	hdf5, suitable for fcdi decompression
plugins	H5Zjpegls.dll	MTI decompression	\ProgramData/hdf5/lib/plugin/
plugins	charls-2-x64.dll	MTI decompression	\ProgramData/hdf5/lib/plugin/
gui exec	xrit2pic.exe	xrit2pic gui, 32-bits	\tools\alblas
gui exec	mtg_hdf_ext.exe	external jpegls decompr, 64 bits (executed by xrit2pic)	\tools\alblas
libs 32-bit	jpeg812.dll	jpeg 8/12 bits, 32-bits	\tools\alblas
	wvt.dll	wavelet decompr, 32-bits

Note if different installation locations are desired:

Best/easiest is to put program and all libs in the same location.
plugins: HDF5_PLUGIN_PATH variable has to be set:
- Powershell:
  $env:HDF5_PLUGIN_PATH="<location>"
- Check:
  echo $Env:HDF5_PLUGIN_PATH

Info gui

Unfortunately the combination 'gui' and 'mtg decompression' gives some problems in my environment. As a temporary(?) work-around the gui/basic processsing is split into 2 programs:

xrit2pic.exe: 32-bits gui, works on windows 64-bits
mtg_hdf_ext.exe: 64-bits, for decompression

The only program to deal with is the gui. If decompression of MTG-data is needed then the gui will execute mtg_hdf_ext, and the decompressed data will be read into the gui.

There are a few drawbacks:

Especially MTI HRFI is slow
Memory problems:
- Full resolution with composite MTI, FDHSI
- highest resolution of HRFI (vis_06_hr, nir_22_hr)

This is a bit strange; no more than 1,3G is needed, but program crashes with 1G, where for 32-bits OS more than 2G should be possible. A "solution" is to lower the generated resolution:

in Preferences, tab Generation, subtab HDF:
- for HRFI: set max. picture size to 12000 (lower than 22272)
- for FDHSI, composite: set max. picture size to 6000 (lower than 11136)

New (2025.3a,b)

MTG: Mixed FDHSI (16 channels) and HRFI (4 channels) possible, for composites. With -src2 option you can define a second source directory, e.g.:

xrit2pic_cmd -src E3H-MTG-1 -src2 E3H-MTG-3

Or: in Linux you can easily link all files in 2 directories to one third directory:

mkdir E3H-MTG-1-3; cd -MTG-1-3

ln -s ../E3H-MTG-1 .

ln -s ../E3H-MTG-3 .

NOTE:

With hdf5 it is possible to lower the resolution (this is a feature in hdf5). But overlays will not all work.
If an overlay doesn't work then check:

gui: menu Edit->Preferences, tab Generation, subtab HDF:
set 'Max. picture size' to 0
Or, also if no gui available:
- determine place of xrit2pic.ini: xrit2pic_cmd -v
- Edit this xrit2pic.ini, search for:
  hdf.image_maxsize=<some number>
  Change to:
  hdf.image_maxsize=0

If no xrit2pic.ini is available then everything is default and hdf.image_maxsize=0 already.

Step by step usage xrit2pic in command shell

Help

Show all options:

xrit2pic_cmd -h

Show some example commands:

xrit2pic_cmd -e

Prepare

Define location of your files:
- xrit2pic_cmd -src <location1> -test
Store this location and destination location in xrit2pic.ini:
- xrit2pic_cmd -src <location1> -dest <location2> -gen_ini

Note: You can still add the -src/-dest options, e.g. in a batch file, they will override the saved settings.

Generate single channel file

If no filters are added xrit2pic will translate all present files. The -test option shows what would be generated, without actual generation.

xrit2pic_cmd -test

Using preferences '/home/ralblas/xrit2pic.ini'...
====================================================
112 items (files) found.
----------------------------------------------------
[25-04-14 19:24] Nr. channels selected which may be used for generation: 4
[25-04-14 19:24] Test: would translate vis_06_hr to <location2>MTI1_vis_06_hr_250409_0750.pgm
[25-04-14 19:24] Test: would translate nir_22_hr to <location2>MTI1_nir_22_hr_250409_0750.pgm
[25-04-14 19:24] Test: would translate ir_38_hr to <location2>MTI1_ir_38_hr_250409_0750.pgm
....

Add channel filter, e.g.:

xrit2pic_cmd -chan vis_06_hr -test

Using preferences '/home/ralblas/xrit2pic.ini'...
====================================================
112 items (files) found.
----------------------------------------------------
[25-04-14 19:26] Nr. channels selected which may be used for generation: 1
[25-04-14 19:26] Test: would translate vis_06_hr to <location2>/MTI1_vis_06_hr_250409_0750.pgm
[25-04-14 19:26] Test: would translate vis_06_hr to <location2>/MTI1_vis_06_hr_250409_0800.pgm
...

You may use wildcards, e.g.:

xrit2pic_cmd -chan ir* -test

Add time/date filter, e.g.:

xrit2pic_cmd -chan vis_06_hr -date 25-04-09 -time 08:00 -test

Using preferences '/home/ralblas/xrit2pic.ini'...
====================================================
112 items (files) found.
----------------------------------------------------
[25-04-14 19:29] Nr. channels selected which may be used for generation: 1
[25-04-14 19:29] Test: would translate vis_06_hr to <location2>/MTI1_vis_06_hr_250409_0800.pgm
====================================================

You may use wildcards, e.g.:

xrit2pic_cmd -date 25-04-* -time 08:* -test

Now start generation, just remove the -test option:

xrit2pic_cmd -chan vis_06_hr -date 25-04-09 -time 08:00

Using preferences '/home/ralblas/xrit2pic.ini'...
====================================================
112 items (files) found.
----------------------------------------------------
[25-04-14 19:30] Nr. channels selected which may be used for generation: 1
[25-04-14 19:30] Translated vis_06_hr to <location2>MTI1_vis_06_hr_250409_0800.pgm
====================================================

You can add option -jpg to generate a jpeg file.