En esta página

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 ».

Superficie en 3D que muestra una ecuación matemática con efecto de resplandor y controles

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:

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:

OperadoresFuncionesCaracteres
+ - * / % ^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 Calc

La 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: 10

Se 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.Point

Integración de una escena QtQuick3D

Para que los tipos de « QtQuick3D » estén disponibles, hay que importarlos al QML:

import QtQuick3D

Una 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.Helpers

Para 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.

Proyecto de ejemplo en @code.qt.io

© 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.