Qt Data Visualization Tratamiento de datos
Series
Una serie es una combinación de un conjunto de elementos de datos conectados lógicamente (gestionados por un proxy de datos) y propiedades visuales que describen cómo deben representarse dichos elementos, como las mallas y los colores de los elementos. Cada tipo de visualización tiene su propio tipo de serie. Por ejemplo, los gráficos de barras utilizan QBar3DSeries. A todos los gráficos se les pueden añadir varias series simultáneamente.
Este fragmento de código muestra cómo utilizar QBar3DSeries para representar las barras como cilindros y con un degradado en lugar de un color uniforme:
Q3DBars graph;
QBar3DSeries *series = new QBar3DSeries;
QLinearGradient barGradient(0, 0, 1, 100);
barGradient.setColorAt(1.0, Qt::white);
barGradient.setColorAt(0.0, Qt::black);
series->setBaseGradient(barGradient);
series->setColorStyle(Q3DTheme::ColorStyleObjectGradient);
series->setMesh(QAbstract3DSeries::MeshCylinder);
graph->addSeries(series);Proxies de datos
Los datos que los usuarios desean visualizar se presentan en muchos formatos, y es obvio que no todos pueden ser compatibles directamente. Por lo tanto, Qt Data Visualization implementa proxies de datos en los que el usuario puede introducir sus datos en un formato conocido. Cada tipo de visualización tiene un tipo de proxy básico, que admite datos en un formato adecuado para dicha visualización. Por ejemplo, el proxy básico para `QBar3DSeries` es `QBarDataProxy`, que almacena filas de objetos `QBarDataItem`. Cada `QBarDataItem` almacena el valor de una sola barra. Se proporcionan definiciones de tipo adicionales para los contenedores ` QBarDataArray ` y ` QBarDataRow `.
Este fragmento de código muestra cómo utilizar el proxy básico cuando los datos se almacenan en un objeto hipotético de tipo ` myData `:
Q3DBars graph;
QBarDataProxy *newProxy = new QBarDataProxy;
QBarDataArray *dataArray = new QBarDataArray;
dataArray->reserve(10);
for (int i = 0; i < 10; i++) {
QBarDataRow *dataRow = new QBarDataRow(5);
for (int j = 0; j < 5; j++)
(*dataRow)[j].setValue(myData->getValue(i, j));
dataArray->append(dataRow);
}
newProxy->resetArray(dataArray);
graph->addSeries(new QBar3DSeries(newProxy));Nota: Los objetosde serie solo pueden tener un único proxy a la vez. El proxy existente se elimina cuando se establece otro en la serie. No obstante, los gráficos pueden contener varias series. Si necesitas alternar entre dos conjuntos de datos diferentes, suele ser más eficiente almacenar cada conjunto en una serie distinta y simplemente cambiar de serie, en lugar de restablecer los datos de un único proxy cada vez que necesites cambiar.
Modelos de elementos y mapeo de datos
Para los casos de uso habituales, Qt Data Visualization ofrece proxies especializados. Uno de estos casos es tener datos en un modelo de elemento (subclase deQAbstractItemModel ), que es una forma habitual de almacenar datos en aplicaciones Qt. Cada uno de los tipos de visualización ofrece una clase de proxy especial para este fin; por ejemplo, `QItemModelBarDataProxy` para `QBar3DSeries`. Estos proxies son fáciles de usar: basta con proporcionarles un puntero al modelo de elementos que contiene los datos y las reglas sobre cómo asignar los datos a un formato que el proxy básico pueda procesar.
La asignación funciona mediante los roles del modelo de elementos. Cada elemento de datos del modelo puede tener valores diferentes para distintos roles. Por ejemplo, con QItemModelBarDataProxy se puede especificar qué rol se utiliza para determinar a qué fila pertenece el elemento, qué rol hace lo mismo para las columnas y qué rol especifica el valor del elemento. Cuando el proxy resuelve los datos del modelo, utiliza estas asignaciones para generar las filas y columnas del gráfico de barras.
A menudo, los modelos de elementos tendrán un único rol que contenga información que se desee asignar a varios valores. Un ejemplo típico de esto es un campo de marca de tiempo al generar un gráfico de barras con dos ejes relacionados con el tiempo, por ejemplo, años y meses. Para permitir la asignación de un único rol de modelo de elemento a más de un campo de datos, los proxies de modelos de elementos proporcionan un mecanismo de coincidencia de patrones y sustitución. También se puede utilizar este mecanismo para reformatear datos, incluso en casos de asignación uno a uno.
Dependiendo del tipo de visualización, los proxies pueden admitir también otras funcionalidades, como QItemModelBarDataProxy, que asigna opcionalmente las filas y columnas de un QAbstractItemModel o directamente a las filas y columnas del gráfico de barras.
Consulte las clases de proxy individuales para obtener más información y ejemplos sobre cómo utilizarlas: QItemModelBarDataProxy, QItemModelScatterDataProxy y QItemModelSurfaceDataProxy.
Otros proxies personalizados
QHeightMapSurfaceDataProxy es un proxy especializado para generar un gráfico de superficie a partir de una imagen de mapa de alturas. Consulta la documentación de QHeightMapSurfaceDataProxy para obtener más información.
El ejemplo «Graph Gallery » muestra cómo se puede crear un proxy personalizado, en la pestaña « Bar Graph ». Define un conjunto de datos personalizado basado en listas de variantes y una extensión del proxy básico para resolver esos datos con un mapeador asociado.
Gestión de datos en tiempo real
Cuando se dispone de un conjunto de datos que se actualiza rápidamente, es importante gestionar los datos adecuadamente para garantizar un buen rendimiento. Dado que la asignación de memoria es una operación costosa, utiliza siempre QList::reserve() y QList::resize() siempre que sea posible para evitar reasignaciones innecesarias al construir la matriz que se va a entregar al proxy. Si necesitas modificar todo el conjunto de datos en cada fotograma, en la mayoría de los casos es mejor reutilizar el array existente, especialmente si las dimensiones del array no cambian. Si necesitas añadir, insertar, eliminar o modificar varias filas o elementos en cada fotograma, siempre es más eficiente hacerlo con una sola llamada al método, en lugar de realizar varias llamadas que afecten a una sola fila o elemento cada una. Por ejemplo, añadir diez filas con una sola llamada a ` QBarDataProxy::addRows()` es mucho más eficiente que diez llamadas separadas a ` QBarDataProxy::addRow()`.
El renderizador de barras está optimizado para acceder únicamente a los datos que se encuentran dentro de la ventana de datos y, por lo tanto, no debería sufrir una ralentización apreciable, incluso si se añaden continuamente más datos al proxy.
Debido a que los datos de los gráficos de dispersión no están ordenados, cualquier cambio en los rangos de la ventana de datos requiere comprobar la visibilidad de todos los puntos de datos, lo que puede provocar una ralentización creciente si se añaden datos continuamente al proxy. Para obtener el mejor rendimiento con los gráficos de dispersión, mantén en el proxy solo los datos que necesites.
Los datos de superficie, aunque a nivel de elementos son similares a los datos dispersos, ya están asignados a filas y columnas, por lo que el renderizador de superficies puede optimizar el trazado partiendo de la hipótesis de que los datos de las filas y columnas están ordenados a lo largo de sus respectivos ejes. No es tan eficiente como en el caso de las barras, pero casi.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.