PDZ-Tool is a Python library for reading PDZ files and converting them into CSV or JSON formats. PDZ files are commonly used to store data from X-ray fluorescence (XRF) instruments, and this tool allows easy extraction and transformation of the data for analysis.

• Read PDZ files in version 24 and 25 formats.
• Parse and extract important information from the PDZ file into JSON format.
• Convert the parsed data to CSV format for further analysis.
• Save the parsed data to a JSON file.
• CLI tool for parsing and converting PDZ files.
• Demo script to help you get started.
• Verbose and debug modes to help troubleshoot issues during parsing.

You can install pdz-tool via pip.

pip install pdz-tool

#### 1. Importing and Initializing PDZTool
from pdz_tool import PDZTool

# Initialize a PDZTool object
pdz_tool = PDZTool('path/to/pdz_file.pdz')

#### 2. Parsing a PDZ File
parsed_data = pdz_tool.parse()

#### 3. Accessing Parsed Data as a Dictionary
record_names = pdz_tool.record_names  # Record names found on the pdz file
for record_name in record_names:
    print(f"Record Name: {record_name}")
    print(parsed_data[record_name])
    
#### 4. Converting Parsed Data to JSON
json_data = pdz_tool.to_json()
print(json_data)

#### 5. Saving Parsed Data to JSON File
pdz_tool.to_json('output.json')

#### 6. Saving Parsed Data to CSV
pdz_tool.to_csv('output.csv')

pdz-tool path/to/pdz_file.pdz

see pdz-tool --help for more options.

Demo folder is included in the project, containing example PDZ files to help you get started. You can run the demo script to test the functionality of the PDZ-Tool:

python demo/demo_script.py

If you wish to modify or extend the tool, clone the repository:

git clone [email protected]:bducraux/pdz-tool.git
cd pdz-tool

This project uses Poetry for dependency management. If you don't have Poetry installed, you can install it by running:

pip install poetry

To install the dependencies, run:

poetry install

Contributions are welcome! If you find any bugs or have suggestions for new features, feel free to open an issue or submit a pull request.

This project is licensed under the MIT License. See the LICENSE file for details.

For any inquiries or support, please reach out at [email protected].

Thank you for using PDZ-Tool! 🎉😊