XDS Von Hamos Preview Tool

© Copyright CNPEM 2015

Centro Nacional de Pesquisa em Energia e Materiais

https://cnpem.br

Author: Rafael J. P. dos Santos

Video tutorials (in Portuguese)

• Video 1 - Installation
• Video 2 - Usage
• Video 3 - Input data format

App features

RXES

Intensity vs. Incoming energy vs. Emitted Energy

XES

Intensity vs. Emitted Energy, for a fixed incoming energy

HERFD

Total intensity (summed within the full range of detectable emission energy) vs. Incoming Energy

Experimental data grid

Main screen displaying experimental data

Installation

Last tested in 19 February 2021, using Debian Linux operating system.

It should be possible (although not tested) to run in Windows using third-party software.

Running on Linux

Option 1 - Run from Docker repository

This option is the easiest for trying out the software as it is.

1. Install docker (https://docs.docker.com/get-docker/)

2. Run the following command in the terminal, inside your experimental data directory:

docker run -v $(pwd)/:/var/app/data -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY rpagliuca/xds_vonhamos_preview_tool

3. Optional: store the command above in a new file called /usr/local/bin/von-hamos
   • Grant execution permission by running the command sudo chmod a+x /usr/local/bin/von-hamos
   • This way, you can open the software by simplying calling von-hamos from within your experimental data directory

Option 2 - Download source code and run

This is the best option if you want to download the source code and customize the software.

1. Install docker (https://docs.docker.com/get-docker/)

2. Install docker-compose (https://docs.docker.com/compose/install/)

3. Install git

4. Clone this git repository (https://docs.github.com/github/creating-cloning-and-archiving-repositories/cloning-a-repository)

5. Customize the file docker-compose.yaml with your own volumes of experimental data

6. Run the following in the terminal, inside the cloned repository directory:

docker-compose up --build

Running on Windows (not tested)

You could give this a try (not tested nor endorsed!):

https://dev.to/darksmile92/run-gui-app-in-linux-docker-container-on-windows-host-4kde