Revision control
++ // Copyright (C) 2025 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
++
++ /*!
++ \title Graphs with CSV Data
++ \examplecategory {Data Visualization}
++ \ingroup qtquickdemos
++ \ingroup qtgraphs_qmlexamples
++ \example demos/graphs_csv
++ \brief How to visualize data from a CSV file in Qt Graphs.
++ \meta {tag} {demo,quick,graphs}
++ \meta {docdependencies} {QtGraphs}
++
++ \image qtquick-demo-graphs-csv.png
++ {2D bar chart visualizing data loaded from a CSV file}
++
++ The \b {Graphs with CSV Data} example shows how to display data from a CSV file in
++ a 2D bar chart. The application reads the CSV file using a third-party CSV parser.
++ The data is inserted into a custom model that inherits from
++ the \l QAbstractTableModel. After the data is inserted into the model, the leftmost
++ column contains the vertical header data, while the top row contains the horizontal
++ header data.
++
++ The selected third-party library knows nothing about \l{The Qt Resource System}{Qt Resource System},
++ so it cannot load the CSV file from the file path. Therefore, the source's contents
++ must be loaded before passing it to the library. The CSV library in this example accepts
++ the file as either file path, \c {std::fstream}, or \c {std::stringstream}. Since
++ the CSV file is in Qt resources, the library doesn't know how to load it, and
++ \l QFile doesn't support \c {std::fstream}; the only option left is to use
++ \c {std::stringstream}. The whole file can be read into a string via
++ \l QFile::readAll(), and then that string is opened into
++ a \c {std::stringstream}.
++
++ In the application window, a table view presents the data from the model.
++ From the table view, a user can select a subsection of data that is
++ then displayed in the bar graph.
++
++ As the bar series doesn't modify category axis labels, updating the series doesn't
++ update the axis labels. That is handled in JavaScript by extracting label names
++ from the model's leftmost column. The extracted label names are then set to
++ the category axis's labels property.
++
++ \quotefromfile demos/graphs_csv/components/CustomTableView.qml
++ \skipto extractBarSetGategories
++ \printuntil }
++
++ \include examples-run.qdocinc
++
++ \sa {QML Applications}
++ */