Skip to main content

Dbux Data Analysis

Dbux provides several tools for manual data analysis. However, this page explains how to use advanced data analysis tools and techniques.

  1. You probably want to start by exporting the data, using the "Dbux: Export Application Data" command1.
  2. โ€‹@dbux/data is our main data processing JavaScript package. We use it to preprocess and manage all runtime data. Dbux VSCode Extension uses @dbux/data's preprocessed data for visualization and user interactions.
  3. โ€‹analysis contains a few Python functions and example notebooks that use extracted data for testing and development purposes. NOTE: This package is not matured and, unlike @dbux/data, has almost no Dbux-specific data processing utilities. More details below.

Make sure to give it a good try, and feel free to complain or otherwise report back to us on the Dbux DISCORD.

Exporting + Importing Trace Logs

You can export and import application data using corresponding commands.

Specifically:

  • Dbux: Export Application Data and
  • Dbux: Import Application Data

Cross-platform imports are supported, but there is an open bug that should soon be resolved.

Python Experiments

In the analyze/ folder, you find several example notebooks that allow you to analyze the data that dbux generates. Here is how you set that up:

  1. Run some program with Dbux enabled (e.g. samples/[...]/oop1.js)
  2. Use the "Export Application Data" command.
  3. Make sure you have Python + Jupyter setup
    • Windows
      1. Install Anaconda with chocolatey
      2. Set your %PYTHONPATH% in system config to your Anaconda Lib + DLLs folders (e.g. C:\tools\Anaconda3\Lib;C:\tools\Anaconda3\DLLs;)
      3. Done!
    • TODO: Other OS'es
  4. Run one of the notebooks, load the file, and analyze.

NOTE: this is not currently well maintained. Make sure to reach out, if things go wrong.

PS: If you want more/better support for automatic data analysis, please let us know on Discord and also feel free to up-vote this issue.