Import Geant4 5.0.0 source tree
This commit is contained in:
Gabriele Cosmo
@@ -0,0 +1,191 @@
|
||||
//
|
||||
// ********************************************************************
|
||||
// * DISCLAIMER *
|
||||
// * *
|
||||
// * The following disclaimer summarizes all the specific disclaimers *
|
||||
// * of contributors to this software. The specific disclaimers,which *
|
||||
// * govern, are listed with their locations in: *
|
||||
// * http://cern.ch/geant4/license *
|
||||
// * *
|
||||
// * Neither the authors of this software system, nor their employing *
|
||||
// * institutes,nor the agencies providing financial support for this *
|
||||
// * work make any representation or warranty, express or implied, *
|
||||
// * regarding this software system or assume any liability for its *
|
||||
// * use. *
|
||||
// * *
|
||||
// * This code implementation is the intellectual property of the *
|
||||
// * GEANT4 collaboration. *
|
||||
// * By copying, distributing or modifying the Program (or any work *
|
||||
// * based on the Program) you indicate your acceptance of this *
|
||||
// * statement, and all its terms. *
|
||||
// ********************************************************************
|
||||
//
|
||||
// -*- C++ -*-
|
||||
// AID-GENERATED
|
||||
// =========================================================================
|
||||
// This class was generated by AID - Abstract Interface Definition
|
||||
// DO NOT MODIFY, but use the org.freehep.aid.Aid utility to regenerate it.
|
||||
// =========================================================================
|
||||
#ifndef AIDA_IFUNCTION_H
|
||||
#define AIDA_IFUNCTION_H 1
|
||||
|
||||
// This file is part of the AIDA library
|
||||
// Copyright (C) 2002 by the AIDA team. All rights reserved.
|
||||
// This library is free software and under the terms of the
|
||||
// GNU Library General Public License described in the LGPL.txt
|
||||
|
||||
#include <string>
|
||||
#include <vector>
|
||||
|
||||
namespace AIDA {
|
||||
|
||||
class IAnnotation;
|
||||
|
||||
/** @interface IFunction
|
||||
*
|
||||
* Principal user-level function interface. Function is a self
|
||||
* contained object, which remembers the current value of its parameters
|
||||
* which are simple doubles. IFunction may be directly plotted or fitted.
|
||||
*
|
||||
* The standard convention of referring to variables by name:
|
||||
* "x[0]" corresponds to variable number 0 etc.
|
||||
*
|
||||
* @author The AIDA team (http://aida.freehep.org/)
|
||||
*
|
||||
*/
|
||||
|
||||
class IFunction {
|
||||
|
||||
public:
|
||||
/// Destructor.
|
||||
virtual ~IFunction() { /* nop */; }
|
||||
|
||||
/**
|
||||
* Scalar value of the function.
|
||||
*/
|
||||
virtual double value(const std::vector<double> & x) const = 0;
|
||||
|
||||
/**
|
||||
* Dimensionality of the domain space.
|
||||
*/
|
||||
virtual int dimension() const = 0;
|
||||
|
||||
/**
|
||||
* Compare if functions are the same.
|
||||
* PENDING: define exactly what it means ;)
|
||||
*/
|
||||
virtual bool isEqual(const IFunction * f) const = 0;
|
||||
|
||||
/**
|
||||
* Gradient of the function.
|
||||
* The result is valid only if providesGradient()==true.
|
||||
* Otherwise the result is some default (empty) vector.
|
||||
*/
|
||||
virtual const std::vector<double> & gradient(const std::vector<double> & x) const = 0;
|
||||
|
||||
/**
|
||||
* Determine whether function is able to compute gradient.
|
||||
*/
|
||||
virtual bool providesGradient() const = 0;
|
||||
|
||||
/**
|
||||
* Get the symbolic name of i-th variable.
|
||||
*/
|
||||
virtual std::string variableName(int i) const = 0;
|
||||
|
||||
/**
|
||||
* Get all the names in a vector.
|
||||
*/
|
||||
virtual const std::vector<std::string> & variableNames() const = 0;
|
||||
|
||||
/**
|
||||
* Set new vector of parameters.
|
||||
*/
|
||||
virtual void setParameters(const std::vector<double> & params) = 0;
|
||||
|
||||
/**
|
||||
* Retrieve current vector of parameters.
|
||||
*/
|
||||
virtual const std::vector<double> & parameters() const = 0;
|
||||
|
||||
/**
|
||||
* Number of parameters.
|
||||
*/
|
||||
virtual int numberOfParameters() const = 0;
|
||||
|
||||
/**
|
||||
* Names of paramaters.
|
||||
* Names should be unique. Case-insensitive for comparison.
|
||||
* Case-sensitive for storage and output.
|
||||
* All or several names may be left blank "" if the implementation
|
||||
* does not want to provide them.
|
||||
*/
|
||||
virtual const std::vector<std::string> & parameterNames() const = 0;
|
||||
|
||||
/**
|
||||
* Set parameter's value by name.
|
||||
* @param name The name of the parameter.
|
||||
* @param x The new value of the parameter.
|
||||
* @return false If name does not correspond to a parameter.
|
||||
*
|
||||
*/
|
||||
virtual bool setParameter(std::string name, double x) = 0;
|
||||
|
||||
virtual double parameter(std::string name) const = 0;
|
||||
|
||||
/**
|
||||
* Return -1 if parameter not found (name undefined).
|
||||
* Leave it because there are use cases - some users prefer to use numbers.
|
||||
*/
|
||||
virtual int indexOfParameter(std::string name) const = 0;
|
||||
|
||||
virtual IAnnotation & annotation() = 0;
|
||||
|
||||
virtual const IAnnotation & annotation() const = 0;
|
||||
|
||||
/**
|
||||
* String describing the metatype and implementation of the function.
|
||||
*
|
||||
* Generic format of the string:
|
||||
*
|
||||
* codelet:TYPE:LOCATION
|
||||
*
|
||||
* TYPE part contains only a 'typename' string
|
||||
* which is a metatype identifier (used in plugins and catalogues)
|
||||
*
|
||||
* LOCATION may be: 'file', 'verbatim', or 'catalogue'
|
||||
*
|
||||
* Detailed description:
|
||||
*
|
||||
* codelet:typename - no location specified (using 'catalogue')
|
||||
*
|
||||
* codelet:typename:file:/filename.cpp - a c++ source file
|
||||
* codelet:typename:file:/filename.py - a python source file
|
||||
* codelet:typename:file:/filename.so - a shared library
|
||||
*
|
||||
* codelet:typename:catalogue - entry in a catalogue repository
|
||||
*
|
||||
* codelet:typename:verbatim:cpp \n - c++ source file included verbatim
|
||||
* after \n
|
||||
*
|
||||
* codelet:typename:verbatim:py \n - python source file included
|
||||
* verbatim aftern \n
|
||||
*
|
||||
*
|
||||
* Comments:
|
||||
*
|
||||
* file:/filename is a relative path to $AIDA_FUNCTION_DEFAULT_DIR
|
||||
* file://filename is an absolute path
|
||||
*
|
||||
* Examples:
|
||||
*
|
||||
* codelet:G:catalogue
|
||||
* codelet:userSinus:verbatim:cpp \n { return sin(x); }
|
||||
*/
|
||||
virtual std::string codeletString() const = 0;
|
||||
|
||||
/** @link aggregation */
|
||||
/*# IAnnotation lnkIAnnotation; */
|
||||
}; // class
|
||||
}; // namespace AIDA
|
||||
#endif /* ifndef AIDA_IFUNCTION_H */
|
||||
Reference in New Issue
Block a user