BIFXMLIDReader_tpl.h

Go to the documentation of this file.

/****************************************************************************
 *   This file is part of the aGrUM/pyAgrum library.                        *
 *                                                                          *
 *   Copyright (c) 2005-2026 by                                             *
 *       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 *
 *       - Christophe GONZALES(_at_AMU)                                     *
 *                                                                          *
 *   The aGrUM/pyAgrum library is free software; you can redistribute it    *
 *   and/or modify it under the terms of either :                           *
 *                                                                          *
 *    - the GNU Lesser General Public License as published by               *
 *      the Free Software Foundation, either version 3 of the License,      *
 *      or (at your option) any later version,                              *
 *    - the MIT license (MIT),                                              *
 *    - or both in dual license, as here.                                   *
 *                                                                          *
 *   (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html)    *
 *                                                                          *
 *   This aGrUM/pyAgrum library is distributed in the hope that it will be  *
 *   useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,          *
 *   INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS *
 *   FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT. IN NO EVENT SHALL THE   *
 *   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER *
 *   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,        *
 *   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  *
 *   OTHER DEALINGS IN THE SOFTWARE.                                        *
 *                                                                          *
 *   See LICENCES for more details.                                         *
 *                                                                          *
 *   SPDX-FileCopyrightText: Copyright 2005-2026                            *
 *       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 *
 *       - Christophe GONZALES(_at_AMU)                                     *
 *   SPDX-License-Identifier: LGPL-3.0-or-later OR MIT                      *
 *                                                                          *
 *   Contact  : info_at_agrum_dot_org                                       *
 *   homepage : http://agrum.gitlab.io                                      *
 *   gitlab   : https://gitlab.com/agrumery/agrum                           *
 *                                                                          *
 ****************************************************************************/
 
#pragma once
 
 
#include <agrum/ID/io/BIFXML/BIFXMLIDReader.h>   // to ease IDE parser
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
#  include <fstream>
#  include <iostream>
#  include <sstream>
 
#  include <agrum/ID/io/BIFXML/BIFXMLIDReader.h>
 
#  include <agrum/base/core/utils_string.h>
 
namespace gum {
  /*
   * Constructor
   * A reader is created to reading a defined file.
   * Note that an ID as to be created before and given in parameter.
   */
  template < GUM_Numeric GUM_SCALAR >
  BIFXMLIDReader< GUM_SCALAR >::BIFXMLIDReader(InfluenceDiagram< GUM_SCALAR >* infdiag,
                                               std::string_view                filePath) :
      IDReader< GUM_SCALAR >(infdiag, filePath) {
    GUM_CONSTRUCTOR(BIFXMLIDReader);
    _infdiag_  = infdiag;
    _filePath_ = filePath;
  }
 
  /*
   * Default destructor.
   */
  template < GUM_Numeric GUM_SCALAR >
  BIFXMLIDReader< GUM_SCALAR >::~BIFXMLIDReader() {
    GUM_DESTRUCTOR(BIFXMLIDReader);
  }
 
  /*
   * Reads the influence diagram from the file referenced by filePath  given at
   * the
   * creation of class
   * @return Returns the number of error during the parsing (0 if none).
   */
  template < GUM_Numeric GUM_SCALAR >
  Size BIFXMLIDReader< GUM_SCALAR >::proceed() {
    try {
      // Loading file
      std::string status = "Loading File ...";
      GUM_EMIT2(onProceed, 0, status);
 
      XmlDocument xmlDoc(_filePath_);
      xmlDoc.loadFile();
 
      if (xmlDoc.noChildren()) {
        GUM_ERROR(IOError, ": Loading fail, please check the file for any syntax error.")
      }
 
      // Finding BIF element
      status = "File loaded. Now looking for BIF element ...";
      GUM_EMIT2(onProceed, 4, status);
 
      XmlElement bifElement = xmlDoc.firstChildElement("BIF");
 
      // Finding network element
      status = "BIF Element reached. Now searching network ...";
      GUM_EMIT2(onProceed, 7, status);
 
      XmlElement networkElement = bifElement.firstChildElement("NETWORK");
 
      // Finding id variables
      status = "Network found. Now proceeding variables instanciation...";
      GUM_EMIT2(onProceed, 10, status);
 
      _parsingVariables_(networkElement);
 
      // Filling diagram
      status = "All variables have been instancied. Now filling up diagram...";
      GUM_EMIT2(onProceed, 55, status);
 
      _fillingDiagram_(networkElement);
 
      status = "Instanciation of network completed";
      GUM_EMIT2(onProceed, 100, status);
    } catch (XmlException& xmlException) { GUM_ERROR(IOError, xmlException.what()) }
    return 0;
  }
 
  template < GUM_Numeric GUM_SCALAR >
  void BIFXMLIDReader< GUM_SCALAR >::_parsingVariables_(XmlElement parentNetwork) {
    // Counting the number of variable for the signal
    int nbVar = 0;
    for (const auto& _: parentNetwork.children("VARIABLE")) {
      nbVar++;
    }
 
    // Iterating on variable element
    int nbIte = 0;
 
    for (const auto& currentVar: parentNetwork.children("VARIABLE")) {
      // Getting variable name
      XmlElement  varNameElement = currentVar.firstChildElement("NAME");
      std::string varName        = varNameElement.textOrDefault("");
 
      std::string description = "";
      std::string fast        = "";
 
      // Getting variable description and/or fast syntax
      for (const auto& property: currentVar.children("PROPERTY")) {
        const auto pair = gum::split(property.textOrDefault(""), "=");
        if (pair.size() == 2) {
          const auto propertyName = gum::toLower(gum::trim_copy(pair[0]));
          const auto value        = gum::trim_copy(pair[1]);
          // check for descritpion and fast
          if (propertyName == "description") {
            description = value;
          } else if (propertyName == "fast") {
            fast = value;
          }
        }
      }
      // Getting variable type
      const auto nodeType = currentVar.attribute("TYPE");
      if (fast == "") {
        // if no fast syntax, we create a variable with the default}
        // Instanciation de la variable
        auto newVar = new LabelizedVariable(varName, description, 0);
 
        // Getting variable outcomes
        for (const auto& outcome: currentVar.children("OUTCOME")) {
          newVar->addLabel(outcome.textOrDefault(""));
        }
 
        // Add the variable to the id
        if (nodeType == "decision") _infdiag_->addDecisionNode(*newVar);
        else if (nodeType == "utility") _infdiag_->addUtilityNode(*newVar);
        else _infdiag_->addChanceNode(*newVar);
        delete newVar;
      } else {
        auto newVar = gum::fastVariable(fast, (nodeType == "utility") ? 1 : 2);
        newVar->setDescription(description);
        // we could check if varName is OK
        if (newVar->name() != varName) {
          GUM_ERROR(IOError,
                    "Variable name (" << varName << ") and fast syntax (" << fast
                                      << ") are not compatible. Please check the syntax.")
        }
 
        // Add the variable to the id
        if (nodeType == "decision") _infdiag_->addDecisionNode(*newVar);
        else if (nodeType == "utility") _infdiag_->addUtilityNode(*newVar);
        else _infdiag_->addChanceNode(*newVar);
        ;
      }
 
      // Emitting progress.
      std::string status   = "Network found. Now proceedind variables instanciation...";
      int         progress = (int)((float)nbIte / (float)nbVar * 45) + 10;
      GUM_EMIT2(onProceed, progress, status);
      nbIte++;
    }
  }
 
  template < GUM_Numeric GUM_SCALAR >
  void BIFXMLIDReader< GUM_SCALAR >::_fillingDiagram_(XmlElement parentNetwork) {
    // Counting the number of variable for the signal
    int nbDef = 0;
    for (const auto& _: parentNetwork.children("DEFINITION")) {
      nbDef++;
    }
 
    // Iterating on definition nodes
    int nbIte = 0;
 
    for (const auto& currentVar: parentNetwork.children("DEFINITION")) {
      // Considered Node
      std::string currentVarName = currentVar.firstChildElement("FOR").textOrDefault("");
      NodeId      currentVarId   = _infdiag_->idFromName(currentVarName);
 
      // Get Node's parents
      List< NodeId > parentList;
 
      for (const auto& given: currentVar.children("GIVEN")) {
        std::string parentNode = given.textOrDefault("");
        NodeId      parentId   = _infdiag_->idFromName(parentNode);
        parentList.pushBack(parentId);
      }
 
      for (List< NodeId >::iterator_safe parentListIte = parentList.rbeginSafe();
           parentListIte != parentList.rendSafe();
           --parentListIte)
        _infdiag_->addArc(*parentListIte, currentVarId);
 
      // Recuperating tables values
      if (!_infdiag_->isDecisionNode(currentVarId)) {
        XmlElement              tableElement = currentVar.firstChildElement("TABLE");
        std::istringstream      issTableString(tableElement.textOrDefault(""));
        std::list< GUM_SCALAR > tablelist;
        GUM_SCALAR              value;
 
        while (!issTableString.eof()) {
          issTableString >> value;
          tablelist.push_back(value);
        }
 
        std::vector< GUM_SCALAR > tablevector(tablelist.begin(), tablelist.end());
 
        // Filling tables
        if (_infdiag_->isChanceNode(currentVarId)) {
          const Tensor< GUM_SCALAR >* table = &_infdiag_->cpt(currentVarId);
          table->populate(tablevector);
        } else if (_infdiag_->isUtilityNode(currentVarId)) {
          const Tensor< GUM_SCALAR >* table = &_infdiag_->utility(currentVarId);
          table->populate(tablevector);
        }
      }
 
      // Emitting progress.
      std::string status   = "All variables have been instancied. Now filling up diagram...";
      int         progress = (int)((float)nbIte / (float)nbDef * 45) + 55;
      GUM_EMIT2(onProceed, progress, status);
      nbIte++;
    }
  }
} /* namespace gum */
 
#endif   // DOXYGEN_SHOULD_SKIP_THIS