Welcome to nxstools's documentation!

Authors: Jan Kotanski

Introduction

Configuration tools for NeXDaTaS Tango Servers consists of the following command-line scripts:

• nxscollect uploads external images into the NeXus/HDF5 file
• nxsconfig reads NeXus Configuration Server settings
• nxscreate creates NeXus Configuration components
• nxsdata runs NeXus Data Writer
• nxsfileinfo shows metadata of the NeXus/HDF5 file
• nxsetup setups NeXDaTaS Tango Server environment

as well as the nxstools package which allows perform these operations directly from a python code.

Source code: https://github.com/nexdatas/nxstools

Web page: https://nexdatas.github.io/nxstools

NexDaTaS Web page: https://nexdatas.github.io

Installation

Install the dependencies:

pninexus or h5py, numpy, tango, sphinx

From sources

Download the latest NXS Tools version from

https://github.com/nexdatas/nxstools

Extract sources and run

$ python3 setup.py install

Debian packages

Debian bookworm, bullseye, buster or Ubuntu oracluar, noble, jammy packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ curl -s http://repos.pni-hdri.de/debian_repo.pub.gpg | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/debian-hdri-repo.gpg --import
$ chmod 644 /etc/apt/trusted.gpg.d/debian-hdri-repo.gpg

and then download the corresponding source list

$ cd /etc/apt/sources.list.d
$ wget http://repos.pni-hdri.de/bookworm-pni-hdri.list

To install nxstools scripts

$ apt-get update
$ apt-get install nxstools

or

$ apt-get update
$ apt-get install nxstools3

for older python3 releases.

To install only the python3 package

$ apt-get update
$ apt-get install python3-nxstools

and for python2

$ apt-get update
$ apt-get install python-nxstools

if exists.

From pip

To install it from pip you can

$ python3 -m venv myvenv
$ . myvenv/bin/activate

$ pip install nxstools

Moreover it is also good to install

$ pip install pytango