Qt Graphs Manejo de datos con 3D
Series
Una serie combina un conjunto de elementos de datos conectados lógicamente y propiedades visuales que describen cómo deben representarse dichos elementos, como las mallas y los colores de los elementos. Cada tipo de gráfico 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. Cada serie posee sus propios datos.
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:
QQuickWidget quickWidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickWidget);
QBar3DSeries series;
QLinearGradient barGradient(0, 0, 1, 100);
barGradient.setColorAt(1.0, Qt::white);
barGradient.setColorAt(0.0, Qt::black);
series.setBaseGradient(barGradient);
series.setColorStyle(QGraphsTheme::ColorStyle::ObjectGradient);
series.setMesh(QAbstract3DSeries::Mesh::Cylinder);
graph.addSeries(&series);Proxies de datos
Los datos que los usuarios desean visualizar se presentan en muchos formatos, y no todos ellos pueden ser compatibles directamente. Por ello, Qt Graphs implementa proxies de datos, en los que el usuario puede introducir sus datos en un formato conocido. Cada gráfico tiene un tipo de proxy básico en sus series, que acepta datos en un formato adecuado para ese gráfico. Dada la relación entre el proxy y las series, y dado que los datos se almacenan en series, es importante mencionar algunos puntos. En primer lugar, con esta implementación, los usuarios pueden acceder a los datos a través de las series. Si un usuario desea realizar operaciones con estos datos, como añadir o eliminar, puede seguir llevando a cabo estas operaciones a través del proxy. Sin embargo, para realizar estas operaciones, es necesario crear una serie asociada a este proxy.
Por ejemplo, el proxy básico para QBar3DSeries es QBarDataProxy, que se utiliza para añadir datos a la serie como objetos ` QBarDataItem `. Cada objeto ` QBarDataItem ` contiene un único valor de barra. Se proporcionan definiciones de tipo adicionales para los contenedores ` QBarDataArray ` y ` QBarDataRow `.
Este fragmento de código muestra cómo utilizar un proxy básico cuando los datos se almacenan en un objeto hipotético de tipo ` myData `, que devuelve los datos como ` QBarDataItems`:
QQuickWidget quickWidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickWidget);
QBar3DSeries series;
for (int i = 0; i < 10; ++i) {
QBarDataRow dataRow;
for (int j = 0; j < 5; ++j)
dataRow.append(myData->getValue(i, j));
series.dataProxy()->addRow(dataRow);
}
graph.addSeries(&series);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 la serie mediante un proxy cada vez que necesites cambiar.
Modelos de elementos y mapeo de datos
Para los casos de uso más habituales, Qt Graphs 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 del grafo ofrece una clase 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 especificar las reglas sobre cómo asignar los datos a un formato que el proxy básico pueda procesar.
La asignación funciona con los roles del modelo de elementos. Cada elemento de datos del modelo puede tener valores diferentes para distintos roles. Por ejemplo, con QItemModelBarDataProxy, 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 una única función 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 deben implementar un mecanismo de coincidencia y sustitución de patrones. También se puede utilizar este mecanismo para reformatear datos incluso en casos de asignación uno a uno.
Dependiendo del tipo de gráfico, los proxies también pueden admitir otras funcionalidades, como QItemModelBarDataProxy la asignación opcional de filas y columnas de QAbstractItemModel directamente a 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 altitud. Consulte la documentación de QHeightMapSurfaceDataProxy para obtener más información.
El ejemplo «Graph Gallery», en la pestaña Bar Graph, muestra cómo se puede crear un proxy personalizado. 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, utilice siempre QList::reserve() y QList::resize() siempre que sea posible para evitar reasignaciones innecesarias al construir la matriz que se va a proporcionar al proxy.
Si necesitas:
- modificar todo el conjunto de datos para cada fotograma, en la mayoría de los casos es mejor reutilizar el array existente, especialmente si las dimensiones del array no cambian.
- 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 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()`.
Bars3D 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 a la serie mediante el proxy.
Debido a que los datos 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 elemento son similares a los datos dispersos, ya están asignados a filas y columnas. Por lo tanto, el renderizador de superficies puede optimizar el dibujo 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.