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

$ 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