mna_graph.h

Go to the documentation of this file.

//=============================================================================================================
 
#ifndef MNA_GRAPH_H
#define MNA_GRAPH_H
 
//=============================================================================================================
// INCLUDES
//=============================================================================================================
 
#include "mna_global.h"
#include "mna_node.h"
#include "mna_port.h"
#include "mna_param_tree.h"
 
//=============================================================================================================
// QT INCLUDES
//=============================================================================================================
 
#include <QString>
#include <QStringList>
#include <QList>
#include <QJsonObject>
#include <QCborMap>
 
//=============================================================================================================
// DEFINE NAMESPACE MNALIB
//=============================================================================================================
 
namespace MNALIB
{
 
//=============================================================================================================
class MNASHARED_EXPORT MnaGraph
{
public:
    MnaGraph();
 
    //=========================================================================================================
    // Node management
    //=========================================================================================================
 
    void addNode(const MnaNode& node);
    void removeNode(const QString& nodeId);
    MnaNode& node(const QString& nodeId);
    const MnaNode& node(const QString& nodeId) const;
    QList<MnaNode>& nodes();
    const QList<MnaNode>& nodes() const;
    bool hasNode(const QString& nodeId) const;
 
    //=========================================================================================================
    // Graph-level ports
    //=========================================================================================================
 
    QList<MnaPort> graphInputs;     
    QList<MnaPort> graphOutputs;    
 
    //=========================================================================================================
    // Parameter tree
    //=========================================================================================================
 
    MnaParamTree paramTree;         
 
    //=========================================================================================================
    // Connection helper
    //=========================================================================================================

    bool connect(const QString& srcNodeId, const QString& srcPortName,
                 const QString& dstNodeId, const QString& dstPortName);
 
    //=========================================================================================================
    // Validation
    //=========================================================================================================

    bool validate(QStringList* errors = nullptr) const;
 
    //=========================================================================================================
    // Topological sort
    //=========================================================================================================
 
    QStringList topologicalSort() const;
 
    //=========================================================================================================
    // Dependency queries
    //=========================================================================================================
 
    QStringList upstreamNodes(const QString& nodeId) const;
    QStringList downstreamNodes(const QString& nodeId) const;
    QStringList dirtyNodes() const;
 
    //=========================================================================================================
    // Serialization
    //=========================================================================================================
 
    QJsonObject toJson() const;
    static MnaGraph fromJson(const QJsonObject& json);
    QCborMap toCbor() const;
    static MnaGraph fromCbor(const QCborMap& cbor);
 
private:
    QList<MnaNode> m_nodes;
};
 
} // namespace MNALIB
 
#endif // MNA_GRAPH_H