Initializing help system before first use

QuadTermMap

  • public final class QuadTermMap
extends QuadExpression
    A quadratic expression. This class implements a quadratic expression as a map from variables to values.
    Since:
    43.00

    • Constructor Detail

      • QuadTermMap

        public QuadTermMap()
        Create a new empty expression.
        Since:
        43.00

      • QuadTermMap

        public QuadTermMap​(double constant)
        Create an expression with a constant term.
        Parameters:
        constant - Constant term in new expression.
        Since:
        43.00

    • Method Detail

      • deepCopy

        public QuadExpression deepCopy()
        Get a deep copy of this expression.
        Specified by:
        deepCopy in class  QuadExpression
        Returns:
        A deep copy of this expression.
        Since:
        43.00

      • deepCopy

        public QuadExpression deepCopy​(double factor)
        Get a deep copy of this expression multiplied by a constant
        Specified by:
        deepCopy in class  QuadExpression
        Parameters:
        factor - Factor to scale this with.
        Returns:
        A deep copy of this expression multiplied by factor.
        Since:
        43.00

      • reset

        public QuadExpression reset()
        Clear this expression. Removes all terms and sets the constant to 0.
        Specified by:
        reset in class  QuadExpression
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(java.util.Collection<Variable> variables,
                               java.util.Collection<java.lang.Double> coefficients)
        Add multiple linear terms to this expression. Adds the scalar product defined by the two parallel collections to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables - Variables.
        coefficients - Coefficients.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(java.util.Collection<Variable> variables1,
                               java.util.Collection<Variable> variables2,
                               java.util.Collection<java.lang.Double> coefficients)
        Add multiple quadratic terms to this expression. Adds the scalar product defined by the three parallel collections to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables1 - First variables.
        variables2 - Second variables.
        coefficients - Coefficients.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(Variable[] variables,
                               double[] coefficients)
        Add multiple terms to this expression. Adds the scalar product defined by the two parallel arrays to this expression. This function is equivalent to 
          for (int i = 0; i < variables.length; ++i) addTerm(variables[i], coefficients[i]);
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables - Variables
        coefficients - Coefficients
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(Variable[] variables1,
                               Variable[] variables2,
                               double[] coefficients)
        Add multiple terms to this expression. Adds the scalar product defined by the three parallel arrays to this expression. This function is equivalent to 
          for (int i = 0; i < variables.length; ++i) addTerm(variables1[i], variables2[i], coefficients[i]);
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables1 - First variables
        variables2 - Second variables
        coefficients - Coefficients
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(Variable[] variables,
                               double[] coefficients,
                               int offset,
                               int count)
        Add multiple terms to this expression. Adds the scalar product defined by the two parallel arrays to this expression. The function only uses the slice of the two arrays that is indicated by offset and length. This function is equivalent to 
          for (int i = 0, j = offset; i < count; ++i, ++j) addTerm(variables[j], coefficients[j]);
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables - Variables
        coefficients - Coefficients
        offset - Offset into arrays.
        count - Number of elements to use from each array.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(Variable[] variables1,
                               Variable[] variables2,
                               double[] coefficients,
                               int offset,
                               int count)
        Add multiple terms to this expression. Adds the scalar product defined by the three parallel arrays to this expression. The function only uses the slice of the two arrays that is indicated by offset and length. This function is equivalent to 
          for (int i = 0, j = offset; i < count; ++i, ++j) addTerm(variables1[j], variables2[j], coefficients[j]);
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        variables1 - First variables
        variables2 - Second variables
        coefficients - Coefficients
        offset - Offset into arrays.
        count - Number of elements to use from each array.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(Variable variable,
                              double coefficient)
        Add a term to this expression. If the expression already has a coefficient for variable then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        variable - Variable.
        coefficient - Coefficient to add for variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(double coefficient,
                              Variable variable)
        Add a term to this expression. If the expression already has a coefficient for variable then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        coefficient - Coefficient to add for variable.
        variable - Variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(Variable x)
        Add term 1.0*x to this expression. If the expression already has a coefficient for x then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        x - Variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(Variable variable1,
                              Variable variable2,
                              double coefficient)
        Add a term to this expression. If the expression already has a coefficient for variable1*variable2 then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        variable1 - First variable.
        variable2 - Second variable.
        coefficient - Coefficient to add for variable1*variable2.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(double coefficient,
                              Variable variable1,
                              Variable variable2)
        Add a term to this expression. If the expression already has a coefficient for variable1*variable2 then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        coefficient - Coefficient to add for variable1*variable2.
        variable1 - First variable.
        variable2 - Second variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerm

        public QuadExpression addTerm​(Variable x1,
                              Variable x2)
        Add term 1.0*x1*x2 to this expression. If the expression already has a coefficient for x then the old and the new coefficients will be added.
        Specified by:
        addTerm in class  QuadExpression
        Parameters:
        x1 - First variable.
        x2 - Second variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(LinExpression expr)
        Add another linear expression to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        expr - The expression to add
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(QuadExpression expr)
        Add another quadratic expression to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        expr - The expression to add
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(LinExpression expr,
                               double factor)
        Add another linear expression to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        expr - The expression to add.
        factor - Factor by which to multiply elements in expr before adding.
        Returns:
        Always returns this.
        Since:
        43.00

      • addTerms

        public QuadExpression addTerms​(QuadExpression expr,
                               double factor)
        Add another quadratic expression to this expression.
        Specified by:
        addTerms in class  QuadExpression
        Parameters:
        expr - The expression to add.
        factor - Factor by which to multiply elements in expr before adding.
        Returns:
        Always returns this.
        Since:
        43.00

      • setCoefficient

        public QuadTermMap setCoefficient​(Variable variable,
                                  double coefficient)
        Set the coefficient for a variable in this expression. Any existing coefficient will be overwritten.
        Parameters:
        variable - objects.Variable index.
        coefficient - New coefficient for variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • setCoefficient

        public QuadTermMap setCoefficient​(Variable variable1,
                                  Variable variable2,
                                  double coefficient)
        Set the coefficient for a variable product in this expression. Any existing coefficient will be overwritten.
        Parameters:
        variable1 - First variable index.
        variable2 - Second variable index.
        coefficient - New coefficient for variable.
        Returns:
        Always returns this.
        Since:
        43.00

      • getCoefficient

        public double getCoefficient​(Variable variable)
        Get the coefficient for a variable.
        Parameters:
        variable - objects.Variable to query.
        Returns:
        The coefficient for variable in this expression.
        Since:
        43.00

      • getCoefficient

        public double getCoefficient​(Variable variable1,
                             Variable variable2)
        Get the coefficient for a variable product.
        Parameters:
        variable1 - First variable to query.
        variable2 - Second variable to query.
        Returns:
        The coefficient for variable in this expression.
        Since:
        43.00

      • addConstant

        public QuadExpression addConstant​(double constant)
        Add a value to the constant term of this expression.
        Specified by:
        addConstant in class  QuadExpression
        Parameters:
        constant - The constant to add.
        Returns:
        Always returns this.
        Since:
        43.00

      • setConstant

        public QuadExpression setConstant​(double constant)
        Set the constant term in this expression. Any existing constant term will be overwritten.
        Specified by:
        setConstant in class  QuadExpression
        Parameters:
        constant - New constant term for this expression
        Returns:
        Always returns this.
        Since:
        43.00

      • getConstant

        public double getConstant()
        Get the constant value in this expression.
        Specified by:
        getConstant in class  QuadExpression
        Returns:
        The constant value in this expression.
        Since:
        43.00

      • extract

        public boolean extract​(double factor,
                       XPRSprob.RowCreator creator)
        Extract this expression into a row. This is for internal use only, you should never have to call this function explicitly.
        Specified by:
        extract in class  Expression
        Parameters:
        factor - Factor by which to multiply the expression during extraction.
        creator - The creator to which this expression should be extracted.
        Returns:
        true if the low-level representation does requires normalization (sorting, removal of dups, ...). In some special cases we know that this is not required and can return false to save the overhead.
        Since:
        43.00

      • extract

        public void extract​(double factor,
                    PostfixExtractor extractor)
        Extract this expression into postfix notation.
        Specified by:
        extract in class  Expression
        Parameters:
        factor - Factor by which to multiply the expression during extraction.
        extractor - The extractor to which the expression is extract.
        Since:
        43.00

      • evaluate

        public double evaluate​(double[] solution)
        Compute the value of this expression with respect to the given solution vector (which is not required to be feasible).
        Specified by:
        evaluate in class  Expression
        Parameters:
        solution - Solution values for which the expression is evaluated.
        Since:
        43.00
Parent Topic Class Summary

© 2001-2024 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.