Skip to content

TMF8829 Tools and logfile converter to html for interactive viewing in browser

License

Notifications You must be signed in to change notification settings

ams-OSRAM/tmf8829_json_logfile_viewer

Repository files navigation

TMF8829 JSON Logfile HTML converter

This tool enables the easy conversion of JSON logfile outputs to html for interactive viewing of

  • Distance information in physical distance and x/y/z
  • Noise, crosstalk (xtalk), SNR and signal amplitude of each pixel
  • Histogram data for the pixels (MP) and reference (Ref)

inside a browser.

A typical output is shown below: video

Additional tools

split_json

Split JSON files into smaller files.

json_to_csv

JSON to csv converter - e.g. for using with excel.

Howto use

JSON logfiles can be created using the ams-OSRAM evaluation software downloaded from https://ams-osram.com/tmf8829 - see the user guide for the EVM howto create these files.

Alternatively JSON logfiles can be created with tmf8829_zeromq_client.py or the exe program inside TMF8829_Driver_ZMQ_Server_Client_EXE_v-latest-version.zip from https://ams-osram.com/tmf8829 website.

On PC

Clone or download repository to PC with installed Python environment and execute below command in a shell; replace 'tmf8829_log_1770799073' with your actual logfile.

# JSON to HTML conversion
python json_to_html.py -i tmf8829_log_1770799073.json.gz

# split JSON file into smaller files with 10 measurements
python split_json.py -i tmf8829_log_1770799073.json.gz -n 10

# JSON to CSV conversion
python json_to_csv.py tmf8829_log_1770799073.json.gz tmf8829_log_1770799073.csv

and open the created html file tmf8829_log_1770799073._viewer.html with a browser.

Online

GitHub Codespaces

Log into your GitHub account, open repository on GitHub tmf8829_json_logfile_viewer and create Codespace using Code->Create Codespace on main.

image

Copy the JSON logfile into the explorer view of the Codespace and execute the command for conversion in the terminal:

# JSON to HTML conversion
./json_to_html.py -i tmf8829_log_1770799073.json.gz

# split JSON file into smaller files with 10 measurements
./split_json.py -i tmf8829_log_1770799073.json.gz -n 10

# JSON to CSV conversion
./json_to_csv.py tmf8829_log_1770799073.json.gz tmf8829_log_1770799073.csv

Download the created html file (right mouse click on file in Codespace explorer) and view it with the browser.

Binder - Jupyterlab

Open https://mybinder.org/v2/gh/ams-OSRAM/tmf8829_json_logfile_viewer/HEAD and proceed similar as shown for GitHub Codespaces. Html files can be directly shown inside the Jupyterlab environment by allowing 'Trust HTML':

image

About

TMF8829 Tools and logfile converter to html for interactive viewing in browser

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages