//  Copyright (C) 2009-2013 EDF R&D
//
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Lesser General Public
//  License as published by the Free Software Foundation; either
//  version 2.1 of the License.
//
//  This library is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//  Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public
//  License along with this library; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
//  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
//  $Id$
//

#ifndef __DEVIATION_GEN__
#define __DEVIATION_GEN__

#include "SALOME_Component.idl"
#include "SALOMEDS.idl"
#include "SALOME_Exception.idl"
#include "SALOME_Parametric.idl"

module GENERICSOLVER_ORB
{
  interface DEVIATION_Gen : Engines::EngineComponent, SALOMEDS::Driver
  {

    /**
     * @brief Initialize the component with the deterministic variables and the lists of
     *        probabilistic variables.
     *
     * The Init method prepares the component for a series of computation with
     * the method Exec. It extracts the deterministic data from Salome study and
     * stores this data along with the lists of input and output variables to
     * identify them in future calls to Exec.
     *
     * @param studyID        the identifier of the study containing the deterministic data
     * @param detCaseEntry   the identifier of the deterministic case within the study
     */
    void Init(in long studyID, in SALOMEDS::ID detCaseEntry)
      raises (SALOME::SALOME_Exception);

    /**
     * @brief Execute a computation with a given sample of variables.
     *
     * The Exec method realizes the computation with the probabilistic variables
     * described in paramInput and the deterministic variables set previously with
     * the Init method. The result is put in paramOutput in the order specified by
     * paramInput.outputVarList.
     *
     * @param paramInput   a structure describing the probabilistic variables and the order
     *                     of the output variables.
     * @param paramOutput  a structure containing the result of the computation
     */
    void Exec(in SALOME_TYPES::ParametricInput paramInput,
              out SALOME_TYPES::ParametricOutput paramOutput)
      raises (SALOME::SALOME_Exception);

    /**
     * @brief Cleanup everything that was previously set
     *
     * The Finalize method is in charge of cleaning everything that what set hitherto.
     * It may be empty.
     */
    void Finalize()
      raises (SALOME::SALOME_Exception);

    /**
     * @brief Return the files and directories that must be transferred
     *        from / to the computation resource
     *
     * This method is used to specify which files and directories must be
     * transferred to the computation resource for the calculation code, and
     * which resulting files and directories must be transferred from the
     * computation resource to the local computer.
     *
     * @param studyID      the identifier of the study containing the
     *                     deterministic data
     * @param detCaseEntry the identifier of the deterministic case within the
     *                     study
     * @param inputFiles   the list of input files and directories to transfer
     *                     from the local computer to the computation resource
     *                     (absolute paths on the local computer)
     * @param outputFiles  the list of output files and directories that must
     *                     be transferred from the computation resource to the
     *                     local computer after the computation (paths
     *                     relative to the working directory on the
     *                     computation resource)
     */
    void GetFilesToTransfer(in long studyID, in SALOMEDS::ID detCaseEntry,
                            out SALOMEDS::ListOfStrings inputFiles,
                            out SALOMEDS::ListOfStrings outputFiles)
      raises (SALOME::SALOME_Exception);

  };
};

#endif