Drishti

https://drishti-io.readthedocs.io/en/latest/
Admin
Drishti is a framework that integrates visualization and analysis tools for Darshan and Recorder...
Tokens:19,370
Snippets:60
Trust Score:8.3
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Drishti I/O using pip

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Installs the Drishti I/O command-line tool using pip. This is the primary method for getting the tool onto your system.

```bash
pip install drishti-io
```

--------------------------------

### Install Drishti Dependencies

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Installs required Python libraries for the Drishti framework by installing from a requirements.txt file.

```bash
pip install -r requirements.txt
```

--------------------------------

### Install Drishti I/O from source

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Installs Drishti I/O from its source code, requiring Python 3 and installation of dependencies from a requirements file.

```bash
pip install -r requirements.txt
pip install .
```

--------------------------------

### Install Drishti Framework

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Installs the Drishti framework itself after its dependencies have been met. This command is typically run from the root directory of the cloned repository.

```bash
pip install .
```

--------------------------------

### Install Drishti via Git (Summit/OLCF)

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Installs Drishti framework from a git repository on Summit (OLCF). Involves loading Python, creating and activating a conda environment, installing specific versions of arrow-cpp and pyarrow, cloning the repository, and installing the framework with pip.

```bash
module load python

conda create -n py310-dxt python=3.10
source activate py310-dxt
conda install arrow-cpp=10.0.1 pyarrow=10.0.1

git clone https://github.com/hpc-io/dxt-explorer
cd dxt-explorer

pip install .

dxt-explorer samples/YOUR-DARSHAN-FILE.darshan

conda deactivate
```

--------------------------------

### Install Drishti I/O with Pip

Source: https://drishti-io.readthedocs.io/en/latest/insights

Installs Drishti I/O using pip. Ensure Python 3 is installed and dependencies are met before running this command.

```bash
pip install drishti
```

--------------------------------

### Run DXT Explorer with DARSHAN file

Source: https://drishti-io.readthedocs.io/en/latest/_sources/exploring

This command executes the DXT Explorer tool, taking a DARSHAN file as input. Ensure DXT Explorer and its dependencies are installed before running.

```bash
dxt-explorer DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### Install Drishti via Git (Perlmutter/NERSC)

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Installs Drishti framework from a git repository on Perlmutter (NERSC). Requires loading Python and Darshan modules, cloning the repository, and installing dependencies using pip.

```bash
module load python
```

```bash
module load darshan
```

--------------------------------

### Install Drishti via Git (Summit OLCF)

Source: https://drishti-io.readthedocs.io/en/latest/building

Installs Drishti and its Python dependencies on the Summit cluster at OLCF. It includes loading necessary modules and installing required libraries.

```bash
python=3.10
source=10.0.1
pyarrow=10.0.1

git
cd
```

```bash
pip install -r requirements.txt
```

```bash
pip install .
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/exploring

This example shows the typical console output when running DXT Explorer. It includes log messages indicating the progress of data processing and the successful creation of interactive HTML files for exploration.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive operation for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created Operation.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created Index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/unbalanced-ranks

This provides an example of the expected console output when running the DXT Explorer, useful for verifying successful execution.

```bash
dxt-explorer --operation-plot --output operation.html
Processing complete. Plot saved to operation.html
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/rank-zero-workload

Provides an example of the expected console output when running the DXT Explorer, which is crucial for understanding the tool's execution and potential issues.

```text
INFO: Processing operation log: <path_to_operation_log>
INFO: Generating operation.html plot...
INFO: Plot generated successfully at <output_directory>/operation.html
INFO: DXT Explorer finished.
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/ost-usage-operation

This is an example of the console output when running the DXT Explorer command to generate the OST Usage Operation Plot. It shows the progress from data frame generation to the successful creation of HTML files for interactive exploration.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive OST usage operation plot for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created operation.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/transfer

This is an example of the console output when running DXT Explorer, indicating the progress of data processing and the successful creation of HTML files for interactive exploration of application traces.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive transfer for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created transfer.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/spatiality

This is an example of the expected console output when calling DXT Explorer. It typically indicates the successful generation of plots or provides information about the analysis process.

```text
dxt_explorer --trace <trace_file> --output <output_directory>
Processing trace file...
Generating spatiality.html...
Analysis complete.
```

--------------------------------

### Cite Drishti: Guiding End-Users (BibTeX)

Source: https://drishti-io.readthedocs.io/en/latest/_sources/citation

This BibTeX entry provides citation details for the paper 'Drishti: Guiding End-Users in the I/O Optimization Journey'. It highlights Drishti's role in assisting users with I/O optimization and includes publication venue, year, and DOI.

```bash
@INPROCEEDINGS {
      author = {Bez, Jean Luca and Ather, Hammad and Byna, Suren},
      booktitle = {2022 IEEE/ACM International Parallel Data Systems Workshop (PDSW)},
      title = {{Drishti: Guiding End-Users in the I/O Optimization Journey}},
      year = {2022},
      volume = {},
      issn = {},
      pages = {1-6},
      doi = {10.1109/PDSW56643.2022.00006},
      publisher = {IEEE Computer Society},
      address = {Los Alamitos, CA, USA},
      month = {nov}
   }
```

--------------------------------

### Generate OST Usage Operation Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/ost-usage-operation

This command initiates the generation of the OST Usage Operation Plot using the DXT Explorer. Ensure that DXT Explorer and its dependencies are installed prior to execution. The output is an HTML file visualizing OST server usage.

```bash
dxt-explorer -oo DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/iophase

This snippet displays the expected console output when running the DXT Explorer command. It includes timestamps, log levels, and messages indicating the progress of plot generation, file processing, and success notifications.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive I/O phase plot for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created spatiality.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### Generate I/O Phase Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/iophase

This snippet shows the command to generate an I/O phase plot using DXT Explorer. Ensure DXT Explorer and its dependencies are installed before execution. The command takes a DARshan file as input and produces an HTML plot visualizing I/O phases.

```bash
dxt-explorer -i DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/spatiality

This is an example of the console output generated by the DXT Explorer tool when processing a DARshan file. It indicates the progress of data frame generation and the successful creation of the spatiality.html and index.html files, which can be opened in a browser for interactive exploration.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive spatiality for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created spatiality.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/ost-usage-transfer

This snippet displays the expected console output when running the DXT Explorer command. It includes timestamps, log levels, and messages indicating the progress of data processing, plot generation, and the final success messages with paths to the created HTML files.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive OST usage transfer plot for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created operation.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file instragglers your browser to interactively explore all plots
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/rank-zero-workload

This is an example of the console output generated by DXT Explorer when processing a DARshan file. It indicates the stages of data processing, including file identification, dataframe generation, and the successful creation of HTML output files for interactive exploration.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive operation for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created operation.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### Generate I/O Phase Plot

Source: https://drishti-io.readthedocs.io/en/latest/iophase

This command generates the base `io-phase.html` plot after installing dependencies and DXT Explorer. The plot visualizes different I/O phases, including information on MPIIO and POSIX interfaces and the threshold value used for merging phases. Hovering over a phase provides contextual information.

```bash
dxt explorer --plot io-phase
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/stragglers

This shows the typical console output when running DXT Explorer. It includes information about file processing, data frame generation, spatiality creation, and success messages indicating the location of generated HTML files.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive spatiality for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created spatiality.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### Generate OST Usage Transfer Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/ost-usage-transfer

This snippet shows the command to execute DXT Explorer for generating the OST Usage Transfer Plot. It requires prior installation of dependencies and DXT Explorer itself. The command takes a Darshan file as input and produces an HTML plot visualizing OST server data transfer.

```bash
dxt-explorer -ot DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### Generate Rank Zero Heavy Workload Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/rank-zero-workload

This command initiates the process of generating an operation.html plot using DXT Explorer. Ensure DXT Explorer and its dependencies are installed before execution. The output plot can be further analyzed to identify rank zero heavy workload bottlenecks.

```bash
dxt-explorer -r DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### Run Drishti with Docker

Source: https://drishti-io.readthedocs.io/en/latest/building

Runs the Drishti framework using a pre-configured Docker image. It demonstrates how to mount the current directory into the container for input/output access and ensures the container is removed after use.

```bash
docker run -it --rm \
    -v type=bind,source="$(pwd)",target="/dxt-explorer" \
    dxt-explorer
```

--------------------------------

### Run Drishti I/O Command-Line Tool

Source: https://drishti-io.readthedocs.io/en/latest/insights

Executes the Drishti I/O command-line tool with various options. The tool analyzes I/O performance and provides recommendations.

```bash
drishti [-h][--issues][--html][--svg][--verbose][--code]helpexit
```

--------------------------------

### Run Drishti Docker Image

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Runs the Drishti framework using a pre-configured Docker image. It mounts the current directory into the container for file access and specifies the Darshan file to process.

```bash
docker pull hpcio/drishti-framework

docker run --rm --mount \
    type=bind,source="$(pwd)",target="/dxt-explorer" \
    dxt-explorer darshan/<FILE>.darshan
```

--------------------------------

### Use Drishti I/O Docker Image

Source: https://drishti-io.readthedocs.io/en/latest/insights

Demonstrates how to use the Drishti I/O Docker image. This involves mounting the current directory to the container and passing arguments to the Drishti tool.

```bash
docker run -it --rm -v $(pwd):/drishti drishti
```

```bash
type=bind,source="$(PWD)",target=/drishti
```

```bash
\
type=bind,source="$(PWD)",target="/drishti"\

```

--------------------------------

### Enable DXT Tracing

Source: https://drishti-io.readthedocs.io/en/latest/building

Enables Darshan's DXT tracing globally by setting the DXT_ENABLE_IO_TRACE environment variable. This is necessary for visualizing Darshan logs with tracing data.

```bash
export DXT_ENABLE_IO_TRACE=1
```

--------------------------------

### Generate Stragglers Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/stragglers

This command generates the base operation.html plot using DXT Explorer. After installation, this command initiates the data processing and visualization for identifying performance bottlenecks.

```bash
dxt-explorer -st DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```

--------------------------------

### DXT Explorer Usage and Arguments

Source: https://drishti-io.readthedocs.io/en/latest/_sources/exploring

This details the command-line interface for DXT Explorer, outlining positional and optional arguments. These arguments control the type of analysis and output generated, such as interactive data transfer or spatiality explorers.

```text
usage: dxt-explorer [-h] [-o OUTPUT] [-p PREFIX] [-t] [-s] [-i] [-oo] [-ot] [-r] [-u] [-st] [-d] [-l] [--start START] [--end END] [--from START_RANK] [--to END_RANK] [--browser] [-csv] [-v] darshan

DXT Explorer:

positional arguments:
  darshan               Input .darshan file

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        Output directory
  -p PREFIX, --prefix PREFIX
                        Output directory
  -t, --transfer        Generate an interactive data transfer explorer
  -s, --spatiality      Generate an interactive spatiality explorer
  -i, --io_phase        Generate an interactive I/O phase explorer
  -oo, --ost_usage_operation
                        Generate an interactive OST usage operation explorer
  -ot, --ost_usage_transfer
                        Generate an interactive OST usage data transfer size explorer
  -r, --rank_zero_workload
                        Determine if rank 0 is doing more I/O than the rest of the workload
  -u, --unbalanced_workload
                        Determine which ranks have unbalanced workload
  -st, --stragglers     Determine the 5 percent slowest operations in the time distribution
  -d, --debug           Enable debug mode
  -l, --list            List all the files with trace
  --start START         Report starts from X seconds (e.g., 3.7) from beginning of the job
  --end END             Report ends at X seconds (e.g., 3.9) from beginning of the job
  --from START_RANK     Report start from rank N
  --to END_RANK         Report up to rank M
  --browser             Open the browser with the generated plot
  -csv, --csv           Save the parsed DXT trace data into a csv
  -v, --version         show program's version number and exit
```

--------------------------------

### Generate Transfer Plot

Source: https://drishti-io.readthedocs.io/en/latest/transfer

This command generates the 'transfer.html' plot after the necessary dependencies and DXT Explorer have been installed. The plot visualizes the amount of data transferred by read and write requests for each rank during the application's runtime.

```bash
dxt-explorer --trace <trace_file> --output transfer.html
```

--------------------------------

### Generate Spatiality Plot

Source: https://drishti-io.readthedocs.io/en/latest/spatiality

This command generates the base `spatiality.html` plot after installing dependencies and DXT Explorer. Spatiality refers to the file offsets between consecutive I/O accesses, illustrating patterns like contiguous, strided, or random access.

```bash
dxt_explorer --trace <trace_file> --output <output_directory>
```

--------------------------------

### Enable Darshan DXT Tracing

Source: https://drishti-io.readthedocs.io/en/latest/_sources/building

Enables Darshan's DXT tracing globally by setting the DXT_ENABLE_IO_TRACE environment variable. This is a prerequisite for capturing tracing data in Darshan logs.

```bash
export DXT_ENABLE_IO_TRACE=1
```

--------------------------------

### Pull Drishti Docker image

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Pulls the pre-configured Drishti Docker image from Docker Hub, which includes all necessary dependencies for running the tool.

```bash
docker pull hpcio/drishti
```

--------------------------------

### DXT Explorer Console Output Example

Source: https://drishti-io.readthedocs.io/en/latest/_sources/unbalanced-ranks

This is the typical console output when running DXT Explorer to generate dataframes and interactive plots from a DARshan file. It indicates the progress of data processing, plot generation, and the final success message with paths to the created HTML files.

```text
2022-11-02 12:58:22,979 dxt - INFO - FILE: <Filename> (ID <File ID>)
2022-11-02 12:58:22,979 dxt - INFO - generating dataframes
2022-11-02 12:58:26,681 dxt - INFO - generating interactive operation for: <Filename>
2022-11-02 12:58:30,826 dxt - INFO - SUCCESS: <Path to the newly created operation.html>
2022-11-02 12:58:30,834 dxt - INFO - SUCCESS: <Path to the newly created index.html>
2022-11-02 12:58:30,834 dxt - INFO - You can open the index.html file in your browser to interactively explore all plots
```

--------------------------------

### List Drishti I/O Issues

Source: https://drishti-io.readthedocs.io/en/latest/insights

Runs Drishti I/O with the --issues flag to only display detected performance issues without recommendations.

```bash
drishti --issues
```

--------------------------------

### Run Drishti Docker with mounted directory

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Runs the Drishti Docker container, ensuring the current directory is mounted to `/drishti` for access to Darshan log files. The container is removed after use.

```bash
docker run --rm --mount \
    type=bind,source="$(PWD)",target="/drishti" \
    drishti <FILE>.darshan
```

--------------------------------

### Cite I/O Bottleneck Detection and Tuning (BibTeX)

Source: https://drishti-io.readthedocs.io/en/latest/_sources/citation

This BibTeX entry is for citing the publication 'I/O Bottleneck Detection and Tuning: Connecting the Dots using Interactive Log Analysis'. It focuses on Drishti's capabilities in identifying and resolving I/O bottlenecks through log analysis, with details on authors, venue, and year.

```bash
@INPROCEEDINGS{
      title = {{I/O Bottleneck Detection and Tuning: Connecting the Dots using Interactive Log Analysis}},
      author = {Bez, Jean Luca and Tang, Houjun and Xie, Bing and Williams-Young, David and Latham, Rob and Ross, Rob and Oral, Sarp and Byna, Suren},
      booktitle = {2021 IEEE/ACM Sixth International Parallel Data Systems Workshop (PDSW)},
      year = {2021},
      volume = {},
      number = {},
      pages = {15-22},
      doi = {10.1109/PDSW54622.2021.00008}
   }
```

--------------------------------

### Enable Verbose Mode in Drishti I/O

Source: https://drishti-io.readthedocs.io/en/latest/insights

Executes Drishti I/O in verbose mode using the --verbose flag, which provides detailed output and visualizes solution snippets.

```bash
drishti --verbose
```

--------------------------------

### Run Drishti I/O with a Darshan file

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Executes the Drishti I/O tool with a specified Darshan log file. This command analyzes the provided file and outputs insights.

```bash
usage: drishti.py [-h] [--issues] [--html] [--svg] [--verbose] [--code] darshan

Drishti:

positional arguments:
  darshan     Input .darshan file

optional arguments:
  -h, --help  show this help message and exit
  --issues    Only displays the detected issues and hides the recommendations
  --html      Export the report as an HTML page
  --svg       Export the report as an SVG image
  --verbose   Display extended details for the recommendations
  --code      Display insights identification code
```

--------------------------------

### Cite Illuminating the I/O Optimization Path (BibTeX)

Source: https://drishti-io.readthedocs.io/en/latest/_sources/citation

This BibTeX entry is for citing the publication 'Illuminating the I/O Optimization Path of Scientific Applications', a key paper detailing Drishti's contributions to understanding I/O optimization in scientific applications. It includes author, title, booktitle, year, publisher, and page information.

```bash
@INPROCEEDINGS{
      author = {Ather, Hammad and Bez, Jean Luca and Norris, Boyana and Byna, Suren},
      editor = {Bhatele, Abhinav and Hammond, Jeff and Baboulin, Marc and Kruse, Carola},
      title = {{Illuminating the I/O Optimization Path of Scientific Applications}},
      booktitle = {High Performance Computing},
      year = {2023},
      publisher = {Springer Nature Switzerland},
      address = {Cham},
      pages = {22--41},
      isbn = {978-3-031-32041-5}
   }
```

--------------------------------

### DXT Explorer Console Output

Source: https://drishti-io.readthedocs.io/en/latest/exploring

This snippet shows the expected console output when running the DXT Explorer. It is a command-line interface output that indicates the successful generation of exploration files.

```bash
dxt_explorer --help
usage: dxt_explorer [-h] [--version] [--output OUTPUT]
                      [--trace TRACE] [--json JSON]
                      [--profile PROFILE] [--profile_json PROFILE_JSON]
                      [--profile_csv PROFILE_CSV]
                      [--profile_html PROFILE_HTML]
                      [--profile_png PROFILE_PNG]
                      [--profile_svg PROFILE_SVG]
                      [--profile_pdf PROFILE_PDF]
                      [--profile_eps PROFILE_EPS]
                      [--profile_json_only]
                      [--profile_csv_only]
                      [--profile_html_only]
                      [--profile_png_only]
                      [--profile_svg_only]
                      [--profile_pdf_only]
                      [--profile_eps_only]
                      [--profile_no_output]
                      [--profile_no_plot]
                      [--profile_no_json]
                      [--profile_no_csv]
                      [--profile_no_html]
                      [--profile_no_png]
                      [--profile_no_svg]
                      [--profile_no_pdf]
                      [--profile_no_eps]

DXT Explorer

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --output OUTPUT       Output directory for the generated files.
  --trace TRACE         Path to the trace file.
  --json JSON           Path to the JSON file.
  --profile PROFILE   Path to the profile file.
  --profile_json PROFILE_JSON
                        Path to the profile JSON file.
  --profile_csv PROFILE_CSV
                        Path to the profile CSV file.
  --profile_html PROFILE_HTML
                        Path to the profile HTML file.
  --profile_png PROFILE_PNG
                        Path to the profile PNG file.
  --profile_svg PROFILE_SVG
                        Path to the profile SVG file.
  --profile_pdf PROFILE_PDF
                        Path to the profile PDF file.
  --profile_eps PROFILE_EPS
                        Path to the profile EPS file.
  --profile_json_only
                        Only generate profile JSON file.
  --profile_csv_only  Only generate profile CSV file.
  --profile_html_only
                        Only generate profile HTML file.
  --profile_png_only  Only generate profile PNG file.
  --profile_svg_only  Only generate profile SVG file.
  --profile_pdf_only  Only generate profile PDF file.
  --profile_eps_only  Only generate profile EPS file.
  --profile_no_output
                        Do not generate profile files.
  --profile_no_plot   Do not generate profile plots.
  --profile_no_json   Do not generate profile JSON file.
  --profile_no_csv    Do not generate profile CSV file.
  --profile_no_html   Do not generate profile HTML file.
  --profile_no_png    Do not generate profile PNG file.
  --profile_no_svg    Do not generate profile SVG file.
  --profile_no_pdf    Do not generate profile PDF file.
  --profile_no_eps    Do not generate profile EPS file.
```

--------------------------------

### Run Drishti I/O using Docker

Source: https://drishti-io.readthedocs.io/en/latest/_sources/insights

Executes Drishti I/O within a Docker container, mounting the current directory to access Darshan log files. The container is removed after execution.

```bash
docker run --rm --mount type=bind,source="$(PWD)",target=/drishti drishti sample/jlbez_8a_benchmark_write_parallel_id1321662_8-21-5892-15802854900629188750_106.darshan
```

--------------------------------

### Generate Operation Plot with DXT Explorer

Source: https://drishti-io.readthedocs.io/en/latest/_sources/operation

This command initiates the DXT Explorer to process a DARshan file and generate an operation plot. The plot visualizes read/write operations per rank over the application's runtime. Hovering over elements reveals details like Rank, Operation, Duration, Size, and Offset.

```bash
dxt-explorer DARSHAN_FILE_COLLECTED_WITH_DXT_ENABLE.darshan
```
Tokens:
Raw