How to build your own reader¶
Your current data is not supported yet? Don't worry, the following how-to will guide you how to write a reader your own data.
pynxtools-xps supports your format, but some groups and fields are different¶
Good! The basic functionality to read your data is already in place. Before you start writing your own reader, consider two options: 1) You can modify the default config files. 2) Consider opening a pull request on the GitHub repository modifying the existing reader.
You have a completely new data format¶
You will have to write a new sub-reader inside pynxtools-xps. There are multiple steps to get started:
Development install¶
You should start with an devlopment install of the package with its dependencies:
git clone https://github.com/FAIRmat-NFDI/pynxtools-xps.git \\
--branch main \\
--recursive pynxtools_xps
cd pynxtools_xps
python -m pip install --upgrade pip
python -m pip install -e .
python -m pip install -e ".[dev,consistency_with_pynxtools]"
There is also a pre-commit hook available which formats the code and checks the linting before actually commiting. It can be installed with
from the root of this repository.Design strategy¶
The development process is modular so that new parsers can be added. The design logic is the following:
1. First, XpsDataFileParser
selects the proper parser based on the file extensions of the provided files. It then calls a sub-parser that can read files with such extensions and calls the parse_file
function of that reader. In addition, it selects a proper config file from
the config
subfolder.
2. Afterwards, the NXmpes NXDL template is filled with the data in XpsDataFileParser
using the config
file. Data that is not in the given main files can be added through the ELN file (and must be added for required fields in NXmpes).
Write your reader¶
TODO!
Test the software¶
There exists a basic test framework written in pytest which can be used as follows:
You should add test data and add your reader to thetest_params
in the test_reader.py
script.