En esta página

Panel de control de la turbina eólica

Un panel de control de un aerogenerador con gráficos en 2D y 3D.

El ejemplo «Cuadro de mando de una turbina eólica» muestra cómo utilizar gráficos tanto en 2D como en 3D en una aplicación simulada del mundo real.

Cuadro de mando de un aerogenerador con panel de estado, gráficos de potencia y energía, y visualizaciones en 3D

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Descripción general de la aplicación

El ejemplo muestra un panel de control de aerogeneradores, denominado «Aerospace Hub», que muestra datos simulados de un parque eólico imaginario. Se emplean diversos tipos de gráficos para visualizar diferentes clases de datos. Por ejemplo, un gráfico 2D con una serie de splines ilustra la potencia generada por hora, mientras que una serie de área adjunta representa la potencia acumulada durante el mismo periodo. Hay disponibles múltiples vistas de datos, lo que permite a los usuarios explorar y analizar la información desde diferentes perspectivas.

La interfaz principal cuenta con una barra de herramientas de configuración a la izquierda. Dependiendo del modo seleccionado, el diseño puede incluir un panel de estado, un panel de control con gráficos más pequeños, un gráfico principal de gran tamaño o un panel de configuración detallado, ya sea de forma individual o combinada. Este diseño flexible permite a los usuarios personalizar su vista y centrarse en los datos más relevantes para su análisis actual.

Vista de panel de control

La vista de panel de control presenta el estado actual del sistema junto con un panel desplazable que muestra vistas previas en miniatura de los distintos gráficos. Se muestran hasta cuatro gráficos simultáneamente, lo que permite a los usuarios navegar cómodamente por las seis visualizaciones disponibles y evaluar rápidamente las métricas clave de rendimiento de un solo vistazo.

Vista del panel de control con el estado de la turbina y cuatro vistas previas de gráficos

Vista detallada

La vista detallada, a la que se accede seleccionando un gráfico en miniatura del panel de control, permite a los usuarios examinar la visualización elegida con mayor profundidad y a mayor escala. Dependiendo del tipo de gráfico, los usuarios pueden ampliar, desplazar o rotar la vista para explorar los datos de forma interactiva. Además, al pasar el cursor por encima de puntos de datos individuales o hacer clic en ellos, se muestra información más detallada sobre el elemento específico de interés.

Vista detallada con el estado de la turbina y el gráfico de área de potencia generada

Vista de configuración

La vista de configuración, a la que se accede haciendo clic en el botón de configuración de la barra de herramientas o en un gráfico en miniatura, permite a los usuarios ajustar el tema visual de los gráficos y modificar los ajustes específicos de cada tipo de gráfico. Algunas configuraciones se mantienen tras salir de la vista de configuración, mientras que otras solo se aplican dentro de la vista actual, lo que ofrece flexibilidad tanto para ajustes temporales como permanentes.

Vista de configuración con gráfico de barras y controles de personalización del gráfico

Simulación de datos

Todos los datos de los gráficos se generan mediante una jerarquía de clases de simulador implementadas en C++. La clase base, ` DataSimulator`, genera valores aleatorios dentro de un rango configurable de ` min ` a ` max `. La propiedad ` order ` controla si la secuencia es ` Ascending`, ` Descending` o ` NotSorted`, y la propiedad ` deviation ` limita en qué medida cada valor puede diferir del anterior. Cuando « live » se establece en « true », los datos se actualizan automáticamente en el intervalo especificado por « updatePeriod ». Las actualizaciones se ejecutan en un hilo de fondo dedicado, simulando una fuente de datos real.

Cada subclase es un elemento QML destinado a un tipo de serie específico:

  • LineSimulator — rellena QSplineSeries con los valores generados.
  • BarSimulator — rellena QBarSeries, agrupando los valores en conjuntos de barras según la propiedad numberOfCategory.
  • PieSimulator — rellena QPieSeries, creando una sección por cada valor generado.
  • Data3DSimulator — alimenta un ` SimulatedDataModel ` (`QAbstractListModel`) utilizado por los tipos de gráficos 3D. Las propiedades ` numberOfRows ` y ` numberOfColumns ` definen las dimensiones de la cuadrícula de los datos.

Detalles de implementación

Todo en la aplicación se ha diseñado de forma modular. La vista principal, que es el archivo « Main.qml », es un « ApplicationWindow », que instancia los simuladores de datos para cada gráfico, así como el « Item » raíz que contiene todos los elementos de la interfaz de usuario.

El FontLoader se utiliza para aplicar una fuente global a toda la interfaz de usuario.

ApplicationWindow {
    ...

    FontLoader { ... }
    font.family: interFont.name

    // Data simulators
    PieSimulator {
        id: piesim
        ...
    }

    BarSimulator {
        id: barsim
        ...
    }

    LineSimulator {
        id: linesim
        ...
    }

    Data3DSimulator {
        id: barDataSimulator
        ...
    }

    Data3DSimulator {
        id: scatterDataSimulator
        ...
    }

    Data3DSimulator {
        id: surfaceDataSimulator
        ...
    }

    // Root item
    Item {...}
}

El elemento raíz contiene los gráficos de fondo y un « Layout » que se encarga de la colocación de cada elemento de la interfaz de usuario en la vista:

// Background image
Image {
    anchors.fill: parent
    source: root.state === "ShowSettings" ? "images/settings-bg.png"
                                          : "images/dashboard-bg.png"
    fillMode: Image.PreserveAspectCrop
}

// Everything except background image
ColumnLayout {
    anchors.fill: parent
    ...

La mayoría de los elementos se han extraído del propio archivo « Main.qml » y se han trasladado a sus propios componentes QML para utilizarlos en los diseños, como el « ToolBarItem » del fragmento de código siguiente:

// Vertical toolbar
ToolBarItem {
    Layout.preferredWidth: GlobalSettings.toolbarwidth
    Layout.fillHeight: true
}

// Everything except vertical toolbar, header, and background image
ColumnLayout {
    id: maincontentview
    Layout.fillWidth: true
    Layout.fillHeight: true
    ...

Las transiciones entre las diferentes vistas se gestionan mediante states y transitions:

states: [
    State {
        name: "ShowDashboard"
    },
    State {
        name: "ShowSettings"
        PropertyChanges {
            maincontent.opacity: 0
            settingscontent.opacity: 1
        }
        PropertyChanges {
            viewtextdesc.text: "/  Settings"
        }
    },
    ...
// Use transitions to bring the selected view to the front
transitions: [
    Transition {
        NumberAnimation {
            properties: "opacity"
            easing.type: Easing.InOutCubic
            duration: 1000
        }
    }
]
Panel de control

El panel de control forma parte del contenido principal; se trata de otro RowLayout dentro de la jerarquía de Layout:

// Main content
RowLayout {
    id: maincontent
    Layout.fillWidth: true
    Layout.fillHeight: true
    ...

Está compuesto por un panel de estado y un panel de control:

// Status area; turbine image, notification, status texts, and turbine name
StatusPane {
    id: statuspane
    Layout.preferredWidth: GlobalSettings.statusimagewidth
    Layout.fillHeight: true
}

// Scrollable dashboard graph area, shown when in ShowDashboard state
DashboardPane {
    id: dashboardpane
    contentheight: statuspane.height * 1.5
    Layout.preferredWidth: GlobalSettings.dashboardwidth
    Layout.fillHeight: true
}
Panel de estado

El panel de estado también se compone de elementos más pequeños, implementados en sus propios componentes QML:

// Masking the turbine image of the background image
ImageItem {
    anchors.fill: parent
}

// Notification
NotificationItem {
    anchors.top: turbineimage.top
    anchors.horizontalCenter: turbineimage.horizontalCenter
    anchors.topMargin: GlobalSettings.doublespacing
    width: turbineimage.width / 1.25
}

// Status
StatusItem {
    anchors.centerIn: turbineimage
    width: turbineimage.width / 1.5
    height: turbineimage.width / 1.75
}

// Turbine name
Label {
    ...

La implementación de estos no es relevante, por lo que se omitirá esa parte.

Panel del panel de control

El panel de control es el elemento que contiene las seis pequeñas vistas previas de gráficos. Solo cuatro de ellas son visibles a la vez, por lo que deben añadirse dentro de un elemento que permita el desplazamiento. En este caso, se hace mediante un « Flickable », que contiene un « GridLayout »:

Flickable {
    property alias contentheight: content.height

    clip: true

    contentHeight: contentheight

    boundsBehavior: Flickable.StopAtBounds
    interactive: true
    visible: opacity > 0.5

    Item {
        id: content
        width: parent.width

        GridLayout {
            id: grid
            columns: 2
    ...

Las vistas previas de los gráficos se añaden dentro del diseño de cuadrícula y, al igual que la mayoría de los demás elementos, se han implementado dentro de sus propios elementos:

// Graph 1: Power output over time
SmallGraphItem {
    Layout.fillWidth: true
    Layout.fillHeight: true
    state: "Area2D"
    linesimulator: linesim
}

// Graph 2: Energy production x Turbine
SmallGraphItem {
    Layout.fillWidth: true
    Layout.fillHeight: true
    state: "Bar2D"
    barsimulator: barsim
}
...

El elemento ` SmallGraphItem ` es genérico y contiene en su interior todos los tipos de gráficos diferentes; el tipo requerido se le indica mediante un ` state`.

SmallGraphItem tiene:

  • Un elemento de encabezado
  • Una instancia de cada tipo de gráfico, cuya visibilidad está establecida en «false» por defecto mediante un activador de opacidad
  • Un rectángulo para oscurecer la vista previa
  • Un área de ratón para gestionar el desplazamiento del cursor y los clics del ratón sobre la vista previa
Pie2DGraph {
    id: pie2d
    anchors.topMargin: header.height + GlobalSettings.defaultspacing
    anchors.rightMargin: GlobalSettings.defaultspacing
    anchors.fill: parent
    opacity: 0
    piesimulator: smallgraph.piesimulator
}

Bar3DGraph {
    id: bar3d
    anchors.topMargin: header.height + GlobalSettings.defaultspacing
    anchors.bottomMargin: GlobalSettings.defaultspacing
    anchors.fill: parent
    opacity: 0
    cameraZoomLevel: GlobalSettings.defaultzoom
    cameraPreset: GlobalSettings.defaultpreset
}
...

Las opacidades se utilizan para las animaciones de transición, por lo que se han establecido en 0 de forma predeterminada en las vistas previas. Cuando la opacidad se anima por encima de 0,5, el propio gráfico de la vista previa se muestra visible:

Bars3D {
    id: graph
    visible: opacity > 0.5
    ...
Detalles

«Detalles» también forma parte del contenido principal y utiliza el mismo « RowLayout » dentro de la jerarquía « Layout ». Se compone del mismo panel de estado que el «Dashboard» y de un panel de detalles:

// Details graph, shown when in correct state
BigGraphItem {
    id: detailspane
    Layout.preferredWidth: GlobalSettings.dashboardwidth
    Layout.fillHeight: true
    state: root.state
    radius: GlobalSettings.defaultradius
    piesimulator: piesim
    barsimulator: barsim
    linesimulator: linesim
    detailsview: true
}

El panel de detalles, BigGraphItem, es similar a SmallGraphItem en el sentido de que también contiene una instancia de cada gráfico, además de otros elementos:

// Graphs
Area2DGraph {
    id: area2dbig
    Layout.fillWidth: true
    Layout.fillHeight: true
    Layout.margins: GlobalSettings.defaultmargin
    opacity: 0
    panStyle: GraphsView.PanStyle.Drag
    zoomStyle: GraphsView.ZoomStyle.Center
    linesimulator: biggraph.linesimulator
    onVisibleChanged: {
        if (visible)
            biggraph.activegraph = area2dbig
    }
}

Bar2DGraph {
    id: bar2dbig
    Layout.fillWidth: true
    Layout.fillHeight: true
    Layout.margins: GlobalSettings.defaultmargin
    opacity: 0
    panStyle: GraphsView.PanStyle.Drag
    zoomStyle: GraphsView.ZoomStyle.Center
    barsimulator: biggraph.barsimulator
    onVisibleChanged: {
        if (visible)
            biggraph.activegraph = bar2dbig
    }
}
...

Otros elementos incluidos son un cuadro combinado desplegable para seleccionar el tipo de gráfico, botones de control para girar, desplazar y ampliar o reducir —dependiendo del tipo de gráfico— y una descripción emergente para los botones. Al igual que SmallGraphItem, el tipo de gráfico que se muestra se determina en función del estado.

Configuración

La configuración se ha situado fuera del contenido principal Layout, ya que no utiliza ninguna parte de las vistas «Dashboard » ni «Details »:

// Settings
SettingsItem {
    id: settingscontent
    anchors.fill: parent
    ...

La vista «Configuración» contiene otro BigGraphItem para mostrar el gráfico y un panel de configuración para ajustar las propiedades de GraphsTheme o algunas propiedades específicas del tipo de gráfico seleccionado.

// Graph detail
BigGraphItem {
    id: settingsgraph
    width: GlobalSettings.settingsgraphwidth
    anchors.top: parent.top
    anchors.bottom: parent.bottom
    anchors.topMargin: GlobalSettings.graphdetailmargin
    radius: GlobalSettings.defaultradius
    opacity: parent.opacity
    piesimulator: settingsitem.piesimulator
    barsimulator: settingsitem.barsimulator
    linesimulator: settingsitem.linesimulator
}

// Settings pane
Loader {
    active: settingsitem.visible
    asynchronous: true
    anchors.left: settingsgraph.right
    anchors.right: parent.right
    anchors.top: parent.top
    anchors.bottom: parent.bottom
    anchors.leftMargin: GlobalSettings.doublespacing

    sourceComponent: Item {
        StackLayout {
            id: settingspane
            anchors.fill: parent
    ...
Tema global

La configuración de la pestaña « General Settings » afecta a todos los gráficos de la aplicación. Se ha implementado un GraphsTheme global como un Singleton en GlobalSettings.qml:

pragma Singleton
...
QtObject {
    id: global
    ...
// Common graph theme
property var theme: GraphsTheme {
    plotAreaBackgroundVisible: false
    backgroundVisible: false
    colorScheme: GraphsTheme.ColorScheme.Dark
    theme: GraphsTheme.Theme.BlueSeries
    labelTextColor: "#AEAEAE"
    labelBackgroundVisible: true
    labelFont.pointSize: global.fontsize28px
    grid.mainColor: "#AEAEAE"
    grid.mainWidth: 1
    baseGradients: [ global.customgradient ]
}

Este tema global compartido se establece en cada gráfico como tema:

theme: GlobalSettings.theme

Al tratarse de un singleton, el GlobalSettings.qml también debe etiquetarse como tal en el CMakeLists.txt para que pueda utilizarse en la aplicación:

set_source_files_properties(qml/GlobalSettings.qml
    PROPERTIES QT_QML_SINGLETON_TYPE TRUE)
Configuración del gráfico

Los ajustes de la pestaña « Graph Settings » (Ajustes del gráfico) solo afectan al gráfico seleccionado actualmente. Estos ajustes no modifican el tema global, sino únicamente las series del gráfico activo.

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.