Ecuaciones matemáticas
Visualización de ecuaciones matemáticas.
La sección«Ecuaciones matemáticas » muestra cómo visualizar ecuaciones matemáticas en QML con todos los tipos de gráficos disponibles. También explica cómo integrar una escena de « QtQuick3D » en un gráfico y cómo ajustar el aspecto del gráfico utilizando « ExtendedSceneEnvironment ».

Para obtener más información sobre las funciones básicas de las aplicaciones QML, consulta «Gráfico de dispersión sencillo».
Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Configuración
Los datos de todos los tipos de gráficos se pueden almacenar en un ListModel común:
ListModel {
id: dataModel
}El modelo se configura para cada tipo de gráfico en la serie del gráfico:
Surface3DSeries {
id: surfaceSeries
itemLabelFormat: "(@xLabel, @zLabel): @yLabel"
ItemModelSurfaceDataProxy {
itemModel: dataModel
columnRole: "xPos"
yPosRole: "yPos"
rowRole: "zPos"
}
}
...
Bar3DSeries {
id: barSeries
itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"
ItemModelBarDataProxy {
itemModel: dataModel
columnRole: "xPos"
valueRole: "yPos"
rowRole: "zPos"
}
}
...
Scatter3DSeries {
id: scatterSeries
itemLabelFormat: "(@xLabel, @zLabel): @yLabel"
mesh: Abstract3DSeries.Mesh.Point
ItemModelScatterDataProxy {
itemModel: dataModel
xPosRole: "xPos"
yPosRole: "yPos"
zPosRole: "zPos"
}
}La configuración de las funciones permite asignar automáticamente los datos del modelo a los ejes correspondientes.
Análisis de la ecuación
La ecuación se puede escribir en el campo de texto utilizando los siguientes operadores y funciones matemáticas, así como los caracteres necesarios para utilizar dichas funciones:
| Operadores | Funciones | Caracteres |
|---|---|---|
| + - * / % ^ | sin cos tan log exp sqrt | ( ), |
Se admiten los formatos « x » y « y » como parámetros, ya que los datos que se manejan tienen dos ejes y un valor. La ecuación puede contener espacios alrededor de los operadores, por lo que ambos estilos siguientes son válidos:
- x^2+y^2
- x ^ 2 + y ^ 2
La ecuación se analiza mediante un analizador de ecuaciones y una calculadora de JavaScript, que se importan a QML:
import "calculator.js" as CalcLa calculadora fue publicada en Stack Overflow por tanguy_k en TypeScript, y se ha convertido a JavaScript para poder utilizarla desde QML.
Los parámetros de la ecuación se rellenan cada vez que cambia la ecuación o se actualiza el número de columnas o filas.
Iteración por las filas y columnas:
for (i = xValues.first.value; i <= xValues.second.value; ++i) {
for (j = zValues.first.value; j <= zValues.second.value; ++j)
addDataPoint(i, j)
}Rellenar los valores de x y y:
function addDataPoint(i, j) {
var filledEquation = equation.text.replace("x", i)
filledEquation = filledEquation.replace("y", j)
...A continuación, la ecuación se pasa a la calculadora de JavaScript para obtener el resultado, que luego se añade al modelo de datos insertándolo en los roles definidos:
try {
var result = Calc.calculate(filledEquation)
dataModel.append({"xPos": i, "yPos": result, "zPos": j})
}En caso de que haya un error o un operador o una función matemática desconocidos en la ecuación, se detecta el error generado por la calculadora y se muestra un cuadro de diálogo de error:
MessageDialog {
id : messageDialog
title: qsTr("Error")
text: qsTr("Undefined behavior")
...Visualización del mensaje de error de la calculadora:
catch(msg) {
messageDialog.informativeText = msg.toString()
messageDialog.open()
}Gráficos
Se utiliza el mismo modelo de datos para los tres tipos de gráficos. Sin embargo, existen algunas diferencias a la hora de configurar los gráficos.
Superficie
El gráfico de superficie se utiliza para mostrar los datos sin modificaciones específicas. Representa la ecuación en cada fila y columna con el resultado del cálculo.
Los únicos cambios que se realizan son la configuración del número de segmentos de los ejes:
axisX.segmentCount: 10
axisZ.segmentCount: 10
axisY.segmentCount: 10Se establece un degradado de rango en el tema para resaltar los valores máximos y mínimos:
theme : GraphsTheme {
id: surfaceTheme
colorStyle: GraphsTheme.ColorStyle.RangeGradient
baseGradients: [ gradient1 ]
plotAreaBackgroundVisible: false
}El degradado en sí se define en otro lugar para que puedan utilizarlo otros temas.
Barras
En el caso de las barras, también se utiliza un degradado de rango. El degradado emplea una ligera transparencia para facilitar la visualización de los valores sin necesidad de girar demasiado el gráfico. Se ha añadido un control deslizante para ajustar el nivel de transparencia.
Gráficos de dispersión
En el caso de los gráficos de dispersión, el tema se ha ajustado un poco más para prepararlo para las integraciones con QtQuick3D.
En primer lugar, utilizará un degradado diferente al de los otros dos. A continuación, se aplica una combinación de colores oscuros, a diferencia de los otros dos, que utilizan la configuración del sistema. Por último, el fondo del área del gráfico, las etiquetas y la cuadrícula se ocultan estableciendo su visibilidad en «false».
El gráfico de dispersión es ideal para mostrar un gran número de puntos de datos, por lo que se añaden tres puntos de datos por cada «fila» y «columna». El gráfico de dispersión no tiene el concepto de filas y columnas, por lo que se puede hacer lo siguiente:
for (var i = xValues.first.value; i <= xValues.second.value; i += 0.333) {
for (var j = zValues.first.value; j <= zValues.second.value; j += 0.333)
addDataPoint(i, j)
}Dado que el gráfico de dispersión tiene muchos más puntos de datos que los otros dos gráficos, es mejor utilizar el color más claro disponible mesh type para los puntos:
mesh: Abstract3DSeries.Mesh.PointIntegración de una escena QtQuick3D
Para que los tipos de « QtQuick3D » estén disponibles, hay que importarlos al QML:
import QtQuick3DUna escena de « QtQuick3D » se puede importar al gráfico utilizando la propiedad « importScene ». La escena puede ser una combinación de «Models», « Lights», « reflection probes » y otros « Nodes» contenidos en un « Node » raíz. En este ejemplo, solo se añade un rectángulo con un mapa de opacidad:
importScene: Node {
Model {
scale: Qt.vector3d(0.1, 0.1, 0.1)
source: "#Rectangle"
y: -2
eulerRotation.x: -90
materials: [
PrincipledMaterial {
baseColor: "#373F26"
opacityMap: Texture {
source: "qrc:/images/opacitymap.png"
}
}
]
}
}Cambiar la apariencia con QtQuick3D
Para poder acceder a la clase ` ExtendedSceneEnvironment `, es necesario realizar la siguiente importación:
import QtQuick3D.HelpersPara anular el entorno de escena predeterminado del gráfico, se añade la propiedad « environment » con un « ExtendedSceneEnvironment ». En este caso, se establecen « backgroundMode », « clearColor » y « tonemapMode ». Además, se habilita « glow ». Para añadir efectos de posprocesamiento como el resplandor, es necesario establecer el modo de mapa de tonos en « TonemapModeNone ».
environment: ExtendedSceneEnvironment {
backgroundMode: ExtendedSceneEnvironment.Color
clearColor: scatterTheme.backgroundColor
tonemapMode: ExtendedSceneEnvironment.TonemapModeNone
glowEnabled: true
...Para que el resplandor sea intenso, se configuran otras propiedades relacionadas.
© 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.