MathStructure Class Reference

A structure representing a mathematical value/expression/result. More...

`#include <MathStructure.h>`

## Public Member Functions

Constructors
| MathStructure ()
| MathStructure (const MathStructure &o)
| MathStructure (int num, int den=1, int exp10=0)
| MathStructure (long int num, long int den, long int exp10=0L)
| MathStructure (std::string sym, bool force_symbol=false)
| MathStructure (const QalculateDateTime &o_dt)
| MathStructure (double float_value)
| MathStructure (const MathStructure *o,...)
| MathStructure (MathFunction *o,...)
| MathStructure (Unit *u, Prefix *p=NULL)
| MathStructure (Variable *o)
| MathStructure (const Number &o)
Functions/operators for setting type and content
void | set (const MathStructure &o, bool merge_precision=false)
void | set_nocopy (MathStructure &o, bool merge_precision=false)
void | set (int num, int den=1, int exp10=0, bool preserve_precision=false)
void | set (long int num, long int den, long int exp10=0L, bool preserve_precision=false)
void | set (std::string sym, bool preserve_precision=false, bool force_symbol=false)
void | set (const QalculateDateTime &o_dt, bool preserve_precision=false)
void | set (double float_value, bool preserve_precision=false)
void | setVector (const MathStructure *o,...)
void | set (MathFunction *o,...)
void | set (Unit *u, Prefix *p=NULL, bool preserve_precision=false)
void | set (Variable *o, bool preserve_precision=false)
void | set (const Number &o, bool preserve_precision=false)
void | setUndefined (bool preserve_precision=false)
void | setAborted (bool preserve_precision=false)
void | clear (bool preserve_precision=false)
void | clearVector (bool preserve_precision=false)
void | clearMatrix (bool preserve_precision=false)
void | setType (StructureType mtype)
void | operator= (const MathStructure &o)
void | operator= (const Number &o)
void | operator= (int i)
void | operator= (Unit *u)
void | operator= (Variable *v)
void | operator= (std::string sym)
Functions to keep track of referrers
void | ref ()
void | unref ()
size_t | refcount () const
Functions for numbers
const Number & | number () const
Number & | number ()
void | numberUpdated ()
Functions for symbols
const std::string & | symbol () const
Functions for date and time
const QalculateDateTime * | datetime () const
QalculateDateTime * | datetime ()
Functions for units
Unit * | unit () const
Unit * | unit_exp_unit () const
Prefix * | prefix () const
Prefix * | unit_exp_prefix () const
void | setPrefix (Prefix *p)
bool | isPlural () const
void | setPlural (bool is_plural)
void | setUnit (Unit *u)
Functions for mathematical functions
void | setFunction (MathFunction *f)
void | setFunctionId (int id)
MathFunction * | function () const
const MathStructure * | functionValue () const
Functions for variables
void | setVariable (Variable *v)
Variable * | variable () const
Functions for nested structures (power, muliplication, addition, vector, etc)
void | childUpdated (size_t index, bool recursive=false)
void | childrenUpdated (bool recursive=false)
MathStructure & | operator[] (size_t index)
const MathStructure & | operator[] (size_t index) const
MathStructure & | last ()
const MathStructure | last () const
void | setToChild (size_t index, bool merge_precision=false, MathStructure *mparent=NULL, size_t index_this=1)
void | swapChildren (size_t index1, size_t index2)
void | childToFront (size_t index)
void | addChild (const MathStructure &o)
void | addChild_nocopy (MathStructure *o)
void | delChild (size_t index, bool check_size=false)
void | insertChild (const MathStructure &o, size_t index)
void | insertChild_nocopy (MathStructure *o, size_t index)
void | setChild (const MathStructure &o, size_t index=1, bool merge_precision=false)
void | setChild_nocopy (MathStructure *o, size_t index=1, bool merge_precision=false)
const MathStructure * | getChild (size_t index) const
MathStructure * | getChild (size_t index)
size_t | countChildren () const
size_t | countTotalChildren (bool count_function_as_one=true) const
size_t | size () const
Functions for power
const MathStructure * | base () const
const MathStructure * | exponent () const
MathStructure * | base ()
MathStructure * | exponent ()
Functions for comparisons
ComparisonType | comparisonType () const
void | setComparisonType (ComparisonType comparison_type)
Functions checking type and value
StructureType | type () const
bool | isAddition () const
bool | isMultiplication () const
bool | isPower () const
bool | isSymbolic () const
bool | isDateTime () const
bool | isAborted () const
bool | isEmptySymbol () const
bool | isVector () const
bool | isMatrix () const
bool | isFunction () const
bool | isUnit () const
bool | isUnit_exp () const
bool | isUnknown () const
bool | isUnknown_exp () const
bool | isNumber_exp () const
bool | isVariable () const
bool | isComparison () const
bool | isBitwiseAnd () const
bool | isBitwiseOr () const
bool | isBitwiseXor () const
bool | isBitwiseNot () const
bool | isLogicalAnd () const
bool | isLogicalOr () const
bool | isLogicalXor () const
bool | isLogicalNot () const
bool | isInverse () const
bool | isDivision () const
bool | isNegate () const
bool | isInfinity () const
bool | isUndefined () const
bool | isInteger () const
bool | isInfinite (bool ignore_imag=true) const
bool | isNumber () const
bool | isZero () const
bool | isApproximatelyZero () const
bool | isOne () const
bool | isMinusOne () const
bool | hasNegativeSign () const
bool | representsBoolean () const
bool | representsPositive (bool allow_units=false) const
bool | representsNegative (bool allow_units=false) const
bool | representsNonNegative (bool allow_units=false) const
bool | representsNonPositive (bool allow_units=false) const
bool | representsInteger (bool allow_units=false) const
bool | representsNonInteger (bool allow_units=false) const
bool | representsNumber (bool allow_units=false) const
bool | representsRational (bool allow_units=false) const
bool | representsFraction (bool allow_units=false) const
bool | representsReal (bool allow_units=false) const
bool | representsNonComplex (bool allow_units=false) const
bool | representsComplex (bool allow_units=false) const
bool | representsNonZero (bool allow_units=false) const
bool | representsZero (bool allow_units=false) const
bool | representsApproximatelyZero (bool allow_units=false) const
bool | representsEven (bool allow_units=false) const
bool | representsOdd (bool allow_units=false) const
bool | representsUndefined (bool include_children=false, bool include_infinite=false, bool be_strict=false) const
bool | representsNonMatrix () const
bool | representsScalar () const
Functions for precision
void | setApproximate (bool is_approx=true, bool recursive=false)
bool | isApproximate () const
void | setPrecision (int prec, bool recursive=false)
int | precision () const
void | mergePrecision (const MathStructure &o)
void | mergePrecision (bool approx, int prec)
Operators for structural transformations and additions
These operators transforms or adds to the structure without doing any calculations
MathStructure | operator- () const
MathStructure | operator* (const MathStructure &o) const
MathStructure | operator/ (const MathStructure &o) const
MathStructure | operator+ (const MathStructure &o) const
MathStructure | operator- (const MathStructure &o) const
MathStructure | operator^ (const MathStructure &o) const
MathStructure | operator&& (const MathStructure &o) const
MathStructure | operator|| (const MathStructure &o) const
MathStructure | operator! () const
void | operator*= (const MathStructure &o)
void | operator/= (const MathStructure &o)
void | operator+= (const MathStructure &o)
void | operator-= (const MathStructure &o)
void | operator^= (const MathStructure &o)
void | operator*= (const Number &o)
void | operator/= (const Number &o)
void | operator+= (const Number &o)
void | operator-= (const Number &o)
void | operator^= (const Number &o)
void | operator*= (int i)
void | operator/= (int i)
void | operator+= (int i)
void | operator-= (int i)
void | operator^= (int i)
void | operator*= (Unit *u)
void | operator/= (Unit *u)
void | operator+= (Unit *u)
void | operator-= (Unit *u)
void | operator^= (Unit *u)
void | operator*= (Variable *v)
void | operator/= (Variable *v)
void | operator+= (Variable *v)
void | operator-= (Variable *v)
void | operator^= (Variable *v)
void | operator*= (std::string sym)
void | operator/= (std::string sym)
void | operator+= (std::string sym)
void | operator-= (std::string sym)
void | operator^= (std::string sym)
Functions for structural transformations and additions
These functions transforms or adds to the structure without doing any calculations
void | add (const MathStructure &o, MathOperation op, bool append=false)
void | add (const MathStructure &o, bool append=false)
void | subtract (const MathStructure &o, bool append=false)
void | multiply (const MathStructure &o, bool append=false)
void | divide (const MathStructure &o, bool append=false)
void | raise (const MathStructure &o)
void | add (const Number &o, bool append=false)
void | subtract (const Number &o, bool append=false)
void | multiply (const Number &o, bool append=false)
void | divide (const Number &o, bool append=false)
void | raise (const Number &o)
void | add (int i, bool append=false)
void | subtract (int i, bool append=false)
void | multiply (int i, bool append=false)
void | divide (int i, bool append=false)
void | raise (int i)
void | add (Variable *v, bool append=false)
void | subtract (Variable *v, bool append=false)
void | multiply (Variable *v, bool append=false)
void | divide (Variable *v, bool append=false)
void | raise (Variable *v)
void | add (Unit *u, bool append=false)
void | subtract (Unit *u, bool append=false)
void | multiply (Unit *u, bool append=false)
void | divide (Unit *u, bool append=false)
void | raise (Unit *u)
void | add (std::string sym, bool append=false)
void | subtract (std::string sym, bool append=false)
void | multiply (std::string sym, bool append=false)
void | divide (std::string sym, bool append=false)
void | raise (std::string sym)
void | add_nocopy (MathStructure *o, MathOperation op, bool append=false)
void | add_nocopy (MathStructure *o, bool append=false)
void | subtract_nocopy (MathStructure *o, bool append=false)
void | multiply_nocopy (MathStructure *o, bool append=false)
void | divide_nocopy (MathStructure *o, bool append=false)
void | raise_nocopy (MathStructure *o)
void | inverse ()
void | negate ()
void | setLogicalNot ()
void | setBitwiseNot ()
void | transform (StructureType mtype, const MathStructure &o)
void | transform (StructureType mtype, const Number &o)
void | transform (StructureType mtype, int i)
void | transform (StructureType mtype, Unit *u)
void | transform (StructureType mtype, Variable *v)
void | transform (StructureType mtype, std::string sym)
void | transform_nocopy (StructureType mtype, MathStructure *o)
void | transform (StructureType mtype)
void | transform (MathFunction *o)
void | transformById (int id)
void | transform (ComparisonType ctype, const MathStructure &o)
Functions/operators for comparisons
bool | equals (const MathStructure &o, bool allow_interval=false, bool allow_infinity=false) const
bool | equals (const Number &o, bool allow_interval=false, bool allow_infinity=false) const
bool | equals (int i) const
bool | equals (Unit *u) const
bool | equals (Variable *v) const
bool | equals (std::string sym) const
ComparisonResult | compare (const MathStructure &o) const
ComparisonResult | compareApproximately (const MathStructure &o, const EvaluationOptions &eo=default_evaluation_options) const
bool | mergeInterval (const MathStructure &o, bool set_to_overlap=false)
bool | operator== (const MathStructure &o) const
bool | operator== (const Number &o) const
bool | operator== (int i) const
bool | operator== (Unit *u) const
bool | operator== (Variable *v) const
bool | operator== (std::string sym) const
bool | operator!= (const MathStructure &o) const
Functions for calculation/evaluation
MathStructure & | eval (const EvaluationOptions &eo=default_evaluation_options)
bool | calculateMergeIndex (size_t index, const EvaluationOptions &eo, const EvaluationOptions &feo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalOrLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalOrIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalOr (const MathStructure &mor, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalXorLast (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalXor (const MathStructure &mxor, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalAndLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalAndIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalAnd (const MathStructure &mand, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateLogicalNot (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseNot (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateInverse (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateNegate (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateRaiseExponent (const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateRaise (const MathStructure &mexp, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseOrLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseOrIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseOr (const MathStructure &mor, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseXorLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseXorIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseXor (const MathStructure &mxor, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseAndLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseAndIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateBitwiseAnd (const MathStructure &mand, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateMultiplyLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateMultiplyIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateMultiply (const MathStructure &mmul, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateDivide (const MathStructure &mdiv, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateAddLast (const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateAddIndex (size_t index, const EvaluationOptions &eo, bool check_size=true, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateAdd (const MathStructure &madd, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateSubtract (const MathStructure &msub, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1)
bool | calculateFunctions (const EvaluationOptions &eo, bool recursive=true, bool do_unformat=true)
int | merge_addition (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_multiplication (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false, bool do_append=true)
int | merge_power (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_logical_and (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_logical_or (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_logical_xor (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_bitwise_and (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_bitwise_or (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
int | merge_bitwise_xor (MathStructure &mstruct, const EvaluationOptions &eo, MathStructure *mparent=NULL, size_t index_this=1, size_t index_that=2, bool reversed=false)
bool | calculatesub (const EvaluationOptions &eo, const EvaluationOptions &feo, bool recursive=true, MathStructure *mparent=NULL, size_t index_this=1)
void | evalSort (bool recursive=false, bool absolute=false)
bool | integerFactorize ()
Functions for protection from changes when evaluating
void | setProtected (bool do_protect=true)
bool | isProtected () const
Functions for format and display
void | sort (const PrintOptions &po=default_print_options, bool recursive=true)
bool | improve_division_multipliers (const PrintOptions &po=default_print_options, MathStructure *parent=NULL)
void | setPrefixes (const PrintOptions &po=default_print_options, MathStructure *parent=NULL, size_t pindex=0)
void | prefixCurrencies (const PrintOptions &po=default_print_options)
void | format (const PrintOptions &po=default_print_options)
void | formatsub (const PrintOptions &po=default_print_options, MathStructure *parent=NULL, size_t pindex=0, bool recursive=true, MathStructure *top_parent=NULL)
void | postFormatUnits (const PrintOptions &po=default_print_options, MathStructure *parent=NULL, size_t pindex=0)
bool | factorizeUnits ()
void | unformat (const EvaluationOptions &eo=default_evaluation_options)
bool | needsParenthesis (const PrintOptions &po, const InternalPrintStruct &ips, const MathStructure &parent, size_t index, bool flat_division=true, bool flat_power=true) const
bool | removeDefaultAngleUnit (const EvaluationOptions &eo=default_evaluation_options)
int | neededMultiplicationSign (const PrintOptions &po, const InternalPrintStruct &ips, const MathStructure &parent, size_t index, bool par, bool par_prev, bool flat_division=true, bool flat_power=true) const
std::string | print (const PrintOptions &po=default_print_options, const InternalPrintStruct &ips=top_ips) const
std::string | print (const PrintOptions &po, bool format, int colorize=0, int tagtype=TAG_TYPE_HTML, const InternalPrintStruct &ips=top_ips) const
Functions for vectors
MathStructure & | flattenVector (MathStructure &mstruct) const
bool | rankVector (bool ascending=true)
bool | sortVector (bool ascending=true)
MathStructure & | getRange (int start, int end, MathStructure &mstruct) const
void | resizeVector (size_t i, const MathStructure &mfill)
Functions for matrices
size_t | rows () const
size_t | columns () const
const MathStructure * | getElement (size_t row, size_t column) const
MathStructure * | getElement (size_t row, size_t column)
MathStructure & | getArea (size_t r1, size_t c1, size_t r2, size_t c2, MathStructure &mstruct) const
MathStructure & | rowToVector (size_t r, MathStructure &mstruct) const
MathStructure & | columnToVector (size_t c, MathStructure &mstruct) const
MathStructure & | matrixToVector (MathStructure &mstruct) const
void | setElement (const MathStructure &mstruct, size_t row, size_t column)
void | addRows (size_t r, const MathStructure &mfill)
void | addColumns (size_t c, const MathStructure &mfill)
void | addRow (const MathStructure &mfill)
void | addColumn (const MathStructure &mfill)
void | resizeMatrix (size_t r, size_t c, const MathStructure &mfill)
bool | matrixIsSquare () const
bool | isNumericMatrix () const
int | pivot (size_t ro, size_t co, bool symbolic=true)
int | gaussianElimination (const EvaluationOptions &eo=default_evaluation_options, bool det=false)
MathStructure & | determinant (MathStructure &mstruct, const EvaluationOptions &eo) const
MathStructure & | permanent (MathStructure &mstruct, const EvaluationOptions &eo) const
void | setToIdentityMatrix (size_t n)
MathStructure & | getIdentityMatrix (MathStructure &mstruct) const
bool | invertMatrix (const EvaluationOptions &eo)
bool | adjointMatrix (const EvaluationOptions &eo)
bool | transposeMatrix ()
MathStructure & | cofactor (size_t r, size_t c, MathStructure &mstruct, const EvaluationOptions &eo) const
Functions for unit conversion
int | isUnitCompatible (const MathStructure &mstruct) const
bool | syncUnits (bool sync_nonlinear_relations=false, bool *found_nonlinear_relations=NULL, bool calculate_new_functions=false, const EvaluationOptions &feo=default_evaluation_options)
bool | testDissolveCompositeUnit (Unit *u)
bool | testCompositeUnit (Unit *u)
bool | dissolveAllCompositeUnits ()
bool | setPrefixForUnit (Unit *u, Prefix *new_prefix)
bool | convertToBaseUnits (bool convert_nonlinear_relations=false, bool *found_nonlinear_relations=NULL, bool calculate_new_functions=false, const EvaluationOptions &feo=default_evaluation_options, bool avoid_approximate_variables=false)
bool | convert (Unit *u, bool convert_nonlinear_relations=false, bool *found_nonlinear_relations=NULL, bool calculate_new_functions=false, const EvaluationOptions &feo=default_evaluation_options, Prefix *new_prefix=NULL)
bool | convert (const MathStructure unit_mstruct, bool convert_nonlinear_relations=false, bool *found_nonlinear_relations=NULL, bool calculate_new_functions=false, const EvaluationOptions &feo=default_evaluation_options)
Functions for recursive search and replace
int | contains (const MathStructure &mstruct, bool structural_only=true, bool check_variables=false, bool check_functions=false, bool loose_equals=false) const
size_t | countOccurrences (const MathStructure &mstruct) const
size_t | countOccurrences (const MathStructure &mstruct, bool check_variables) const
int | containsRepresentativeOf (const MathStructure &mstruct, bool check_variables=false, bool check_functions=false) const
int | containsType (StructureType mtype, bool structural_only=true, bool check_variables=false, bool check_functions=false) const
int | containsRepresentativeOfType (StructureType mtype, bool check_variables=false, bool check_functions=false) const
int | containsFunction (MathFunction *f, bool structural_only=true, bool check_variables=false, bool check_functions=false) const
int | containsFunctionId (int id, bool structural_only=true, bool check_variables=false, bool check_functions=false) const
int | containsInterval (bool structural_only=true, bool check_variables=false, bool check_functions=false, int ignore_high_precision_interval=0, bool include_interval_function=false) const
int | containsInfinity (bool structural_only=true, bool check_variables=false, bool check_functions=false) const
bool | containsOpaqueContents () const
bool | containsAdditionPower () const
bool | containsUnknowns () const
bool | containsDivision () const
size_t | countFunctions (bool count_subfunctions=true) const
void | findAllUnknowns (MathStructure &unknowns_vector)
bool | replace (const MathStructure &mfrom, const MathStructure &mto, bool once_only=false, bool exclude_function_arguments=false)
bool | replace (const MathStructure &mfrom, const MathStructure &mto, bool once_only, bool exclude_function_arguments, bool replace_in_variables)
bool | replace (Variable *v, const MathStructure &mto)
bool | calculateReplace (const MathStructure &mfrom, const MathStructure &mto, const EvaluationOptions &eo, bool exclude_function_arguments=false)
bool | replace (const MathStructure &mfrom1, const MathStructure &mto1, const MathStructure &mfrom2, const MathStructure &mto2)
bool | removeType (StructureType mtype)
Functions to generate vectors for plotting
MathStructure | generateVector (MathStructure x_mstruct, const MathStructure &min, const MathStructure &max, int steps, MathStructure *x_vector=NULL, const EvaluationOptions &eo=default_evaluation_options) const
MathStructure | generateVector (MathStructure x_mstruct, const MathStructure &min, const MathStructure &max, const MathStructure &step, MathStructure *x_vector=NULL, const EvaluationOptions &eo=default_evaluation_options) const
MathStructure | generateVector (MathStructure x_mstruct, const MathStructure &x_vector, const EvaluationOptions &eo=default_evaluation_options) const
Differentiation and integration
bool | differentiate (const MathStructure &x_var, const EvaluationOptions &eo)
bool | integrate (const MathStructure &lower_limit, const MathStructure &upper_limit, const MathStructure &x_var_pre, const EvaluationOptions &eo=default_evaluation_options, bool force_numerical=false, bool simplify_first=true)
int | integrate (const MathStructure &x_var, const EvaluationOptions &eo, bool simplify_first=true, int use_abs=1, bool definite_integral=false, bool try_abs=true, int max_part_depth=5, std::vector< MathStructure * > *parent_parts=NULL)
Functions for polynomials
bool | expand (const EvaluationOptions &eo=default_evaluation_options, bool unfactorize=true)
bool | simplify (const EvaluationOptions &eo=default_evaluation_options, bool unfactorize=true)
bool | factorize (const EvaluationOptions &eo=default_evaluation_options, bool unfactorize=true, int term_combination_levels=0, int max_msecs=1000, bool only_integers=true, int recursive=1, struct timeval *endtime_p=NULL, const MathStructure &force_factorization=m_undefined, bool complete_square=false, bool only_sqrfree=false, int max_degree_factor=-1)
bool | expandPartialFractions (const EvaluationOptions &eo)
bool | structure (StructuringMode structuring, const EvaluationOptions &eo, bool restore_first=true)
bool | isRationalPolynomial (bool allow_non_rational_coefficient=false, bool allow_interval_coefficient=false) const
const Number & | overallCoefficient () const
const Number & | degree (const MathStructure &xvar) const
const Number & | ldegree (const MathStructure &xvar) const
void | lcoefficient (const MathStructure &xvar, MathStructure &mcoeff) const
void | tcoefficient (const MathStructure &xvar, MathStructure &mcoeff) const
void | coefficient (const MathStructure &xvar, const Number &pownr, MathStructure &mcoeff) const
Number | maxCoefficient ()
int | polynomialUnit (const MathStructure &xvar) const
void | polynomialContent (const MathStructure &xvar, MathStructure &mcontent, const EvaluationOptions &eo) const
void | polynomialPrimpart (const MathStructure &xvar, MathStructure &mprim, const EvaluationOptions &eo) const
void | polynomialPrimpart (const MathStructure &xvar, const MathStructure &c, MathStructure &mprim, const EvaluationOptions &eo) const
void | polynomialUnitContentPrimpart (const MathStructure &xvar, int &munit, MathStructure &mcontent, MathStructure &mprim, const EvaluationOptions &eo) const
Functions for equations
const MathStructure & | find_x_var () const
bool | isolate_x (const EvaluationOptions &eo, const MathStructure &x_var=m_undefined, bool check_result=false)
bool | isolate_x (const EvaluationOptions &eo, const EvaluationOptions &feo, const MathStructure &x_var=m_undefined, bool check_result=false)
bool | inParentheses () const
void | setInParentheses (bool b=true)

## Protected Member Functions

bool | isolate_x_sub (const EvaluationOptions &eo, EvaluationOptions &eo2, const MathStructure &x_var, MathStructure *morig=NULL)
void | init ()

## Protected Attributes

size_t | i_ref
StructureType | m_type
bool | b_approx
int | i_precision
std::vector< MathStructure * > | v_subs
std::vector< size_t > | v_order
std::string | s_sym
Number | o_number
Variable * | o_variable
Unit * | o_unit
Prefix * | o_prefix
bool | b_plural
MathFunction * | o_function
MathStructure * | function_value
QalculateDateTime * | o_datetime
ComparisonType | ct_comp
bool | b_protected
bool | b_parentheses

## Functions for conversion of complex numbers

bool | complexToExponentialForm (const EvaluationOptions &eo)
bool | complexToPolarForm (const EvaluationOptions &eo)
bool | complexToCisForm (const EvaluationOptions &eo)
bool | calculateLimit (const MathStructure &x_var, const MathStructure &limit, const EvaluationOptions &eo_pre, int approach_direction=0)
bool | decomposeFractions (const MathStructure &x_var, const EvaluationOptions &eo)
static bool | polynomialDivide (const MathStructure &mnum, const MathStructure &mden, MathStructure &mquotient, const EvaluationOptions &eo, bool check_args=true)
static bool | polynomialQuotient (const MathStructure &mnum, const MathStructure &mden, const MathStructure &xvar, MathStructure &mquotient, const EvaluationOptions &eo, bool check_args=true)
static bool | lcm (const MathStructure &m1, const MathStructure &m2, MathStructure &mlcm, const EvaluationOptions &eo, bool check_args=true)
static bool | gcd (const MathStructure &m1, const MathStructure &m2, MathStructure &mresult, const EvaluationOptions &eo, MathStructure *ca=NULL, MathStructure *cb=NULL, bool check_args=true)

## Detailed Description

A structure representing a mathematical value/expression/result.

A MathStructure can both be container representing an operation with an ordered list of children or simple value representing a number, , variable etc. The children of a container might be of any type, allowing a tree-like nested structure.

These are the most common conatiner/operation types:

- Addition: contains two or more children, representing terms (x+y+...)
- Multiplication: contains two or more children, representing factors (x*y*...)
- Power: contains exactly two children, representing base and exponent (x^y)
- Function: contains a two or more children, representing arguments, and a reference to a MathFunction object ( f(x,y,...) )
- Comparison: an equality or inequality containing exactly two children, represening the expressions right and left of the sign, specified with a ComparisonType (x=y, x!=y, x>y, ...)
- Vector: contains zero or more children, representing elements in a vector ( [x, y, z, ...] )

Also available are containers representing logical and bitwise operations. Subtraction is represented by an addition structure with negated children and division by a multiplication structure with inverted children. Matrices is represented by a vector with vectors as children.

For formatted structures, the following types is also available:

- Negation: contains exactly one child (-x)
- Invertion: contains exactly one child (1/x)
- Division: contains exactly two children representing numerator and denominator (x/y)

The following value types are available:

- Number: has a Number object, representing a rational, floating point, complex or infinite numeric value
- Variable: has a reference to a Variable object, with a known or unknown value
- Symbolic: has an associated text string, with assumptions about the represented value controlled by the default assumptions
- Unit: has a reference to a Unit object, and might in a formatted structure also have a reference to a Prefix object
- Undefined: represents an undefined value

To create a MathStructure, you can either create a simple structure using the constructors and then expanding it with structural operations, or use the parse or calculation functions of the global Calculator object to convert an expression string.

The expression "(5x + 2) * 3" can be turned into a MathStructure either using

MathStructure mstruct = CALCULATOR->parse("(5x + 2) * 3");
MathStructure
A structure representing a mathematical value/expression/result.
Definition MathStructure.h:148

or

MathStructure mstruct(5);
mstruct *= CALCULATOR->v_x;
mstruct += 2;
mstruct *= 3:

The first variant is obviously simpler, but slower and allows less control.

Then, to evaluate/calculate/simplify (whatever) a structure, eval() should normally be used. The EvaluationOptions passed to eval() allows much control over the process and the outcome.

EvaluationOptions eo;
mstruct.eval(eo);
EvaluationOptions
Options for calculation.
Definition includes.h:703

After that, to display the result, you should first format the structure using format() and then display it using print(), passing the PrintOptions to both.

PrintOptions po;
mstruct.format(po);
std::cout << mstruct.print(po) << std::endl;
PrintOptions
Options for formatting and display of mathematical structures/results.
Definition includes.h:430

Most low-level functions expect the structure to be unformatted och require that unformat() is called after an expression string has been parsed or format() has been called.

To access a child structure either the [] operator or the safer getChild() can be used. Note however that the index passed to the operator start at zero and the index argument for getChild() starts at one.

MathStructure mstruct(5);
mstruct += 2;
std::cout << mstruct.print() << std::endl; // output: "5 + 2"
std::cout << mstruct.getChild(1)->print() << std::endl; // output: "5"
std::cout << mstruct[1].print() << std::endl; // output: "2"

MathStructure uses reference count for management of objects allocated with new. Call ref() when starting to use the object and unref() when done. Note that the reference count is initialized to 1 in the constructors, so ref() should not be called after the object creation. This system is used for all child objects, so the following is perfectly legal:

MathStructure *mchild_p = mstruct->getChild(1);
mchild_p->ref(); // mchild_p reference count = 2
mstruct->unref(); //mstruct reference count = 0, mstruct deleted, mchild_p reference count = 1
(...)
mchild_p->unref(); // mchild_p reference count = 0, mchild_p deleted

## Constructor & Destructor Documentation

## MathStructure() [1/11]

MathStructure::MathStructure | ( |  | ) |

Create a new structure, initialized to zero.

## MathStructure() [2/11]

MathStructure::MathStructure | ( | const MathStructure & | o | ) |

Create a copy of a structure. Child structures are copied.

Parameters

  o | The structure to copy.

## MathStructure() [3/11]

MathStructure::MathStructure | ( | int | num,
|  | int | den = `1`,
|  | int | exp10 = `0`
| ) |  |

Create a new numeric structure (value=num/den*10^exp10). Equivalent to MathStructure(Number(num, den, exp10)).

Parameters

  num | The numerator of the numeric value.
  den | The denominator of the numeric value.
  exp10 | The base 10 exponent of the numeric value.

## MathStructure() [4/11]

MathStructure::MathStructure | ( | std::string | sym,
|  | bool | force_symbol = `false`
| ) |  |

Create a new symbolic/text structure.

Parameters

  sym | Symbolic/text value.
  force_symbol | Do not check for undefined or date value.

## MathStructure() [5/11]

MathStructure::MathStructure | ( | const QalculateDateTime & | o_dt | ) |

Create a new date and time structure.

Parameters

  sym | Date and time value.

## MathStructure() [6/11]

MathStructure::MathStructure | ( | double | float_value | ) |

Create a new numeric structure with floating point value. Uses Number::setFloat().

Parameters

  o | Numeric value.

## MathStructure() [7/11]

MathStructure::MathStructure | ( | const MathStructure * | o,
|  |  | ...
| ) |  |

Create a new vector.

Parameters

  o | The first element (copied) in the vector.
  ... | Elements (copied) in the vector. End with NULL.

## MathStructure() [8/11]

MathStructure::MathStructure | ( | MathFunction * | o,
|  |  | ...
| ) |  |

Create a new function structure.

Parameters

  o | Function value.
  ... | Arguments (copied) to the function. End with NULL.

## MathStructure() [9/11]

MathStructure::MathStructure | ( | Unit * | u,
|  | Prefix * | p = `NULL`
| ) |  |

Create a new unit structure.

Parameters

  u | The unit value.
  p | Prefix of the unit.

## MathStructure() [10/11]

MathStructure::MathStructure | ( | Variable * | o | ) |

Create a new variable structure.

Parameters

  o | Variable value.

## MathStructure() [11/11]

MathStructure::MathStructure | ( | const Number & | o | ) |

Create a new numeric structure.

Parameters

  o | Numeric value.

## Member Function Documentation

## childrenUpdated()

void MathStructure::childrenUpdated | ( | bool | recursive = `false` | ) |

Call this function when you have updated children. Updates the precision.

@recursive If true, do the same for each child of the children.

## childUpdated()

void MathStructure::childUpdated | ( | size_t | index,
|  | bool | recursive = `false`
| ) |  |

Call this function when you have updated a child. Updates the precision.

Parameters

  index | Index (starting at 1) of the updated child. @recursive If true, do the same for each child of the child.

## clear()

void MathStructure::clear | ( | bool | preserve_precision = `false` | ) |

Reset the value (to zero) and parameters of the structure.

Parameters

  preserve_precision | Preserve the current precision.

## clearMatrix()

void MathStructure::clearMatrix | ( | bool | preserve_precision = `false` | ) |

Set the structure to an empty matrix.

Parameters

  preserve_precision | Preserve the current precision.

## clearVector()

void MathStructure::clearVector | ( | bool | preserve_precision = `false` | ) |

Set the structure to an empty vector.

Parameters

  preserve_precision | Preserve the current precision.

## isRationalPolynomial()

bool MathStructure::isRationalPolynomial | ( | bool | allow_non_rational_coefficient = `false`,
|  | bool | allow_interval_coefficient = `false`
| ) |  | const

If the structure represents a rational polynomial. This is true for

- rational numbers;
- functions, units, variables and symbols that do not represent a matrix or undefined;
- a power with a positive integer exponent and any of the previous as base;
- a multiplication with the previous as factors; or
- an addition with the previous as terms.

Returns
  true if structure represents a rational polynomial.

## operator[]() [1/2]

MathStructure & MathStructure::operator[] | ( | size_t | index | ) |

Returns a child. Does not check if a child exists at the index.

Parameters

  index | Index (starting at zero).

## operator[]() [2/2]

const MathStructure & MathStructure::operator[] | ( | size_t | index | ) | const

Returns a child. Does not check if a child exists at the index.

Parameters

  index | Index (starting at zero).

## set() [1/9]

void MathStructure::set | ( | const MathStructure & | o,
|  | bool | merge_precision = `false`
| ) |  |

Set the structure to a copy of another structure. Child structures are copied.

Parameters

  o | The structure to copy.
  merge_precision | Preserve the current precision (unless the new value has a lower precision).

## set() [2/9]

void MathStructure::set | ( | const Number & | o,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a number.

Parameters

  o | The new numeric value.
  preserve_precision | Preserve the current precision (unless the new value has a lower precision).

## set() [3/9]

void MathStructure::set | ( | const QalculateDateTime & | o_dt,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a date and time value.

Parameters

  o | The new data and time value.
  preserve_precision | Preserve the current precision.

## set() [4/9]

void MathStructure::set | ( | double | float_value,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a number with a floating point value. Uses Number::setFloat().

Parameters

  o | The new numeric value.
  preserve_precision | Preserve the current precision (unless the new value has a lower precision).

## set() [5/9]

void MathStructure::set | ( | int | num,
|  | int | den = `1`,
|  | int | exp10 = `0`,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a number (num/den*10^exp10). Equivalent to set(Number(num, den, exp10), precerve_precision).

Parameters

  num | The numerator of the new numeric value.
  den | The denominator of the new numeric value.
  exp10 | The base 10 exponent of the new numeric value.
  preserve_precision | Preserve the current precision (unless the new value has a lower precision).

## set() [6/9]

void MathStructure::set | ( | MathFunction * | o,
|  |  | ...
| ) |  |

Set the structure to a mathematical function.

Parameters

  o | The new function value.
  ... | Arguments (copied) to the function. End with NULL.

## set() [7/9]

void MathStructure::set | ( | std::string | sym,
|  | bool | preserve_precision = `false`,
|  | bool | force_symbol = `false`
| ) |  |

Set the structure to a symbolic/text value.

Parameters

  o | The new symolic/text value.
  preserve_precision | Preserve the current precision.
  force_symbol | Do not check for undefined or date value.

## set() [8/9]

void MathStructure::set | ( | Unit * | u,
|  | Prefix * | p = `NULL`,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a unit.

Parameters

  u | The new unit value.
  p | Prefix of the unit.
  preserve_precision | Preserve the current precision (unless the new value has a lower precision).

## set() [9/9]

void MathStructure::set | ( | Variable * | o,
|  | bool | preserve_precision = `false`
| ) |  |

Set the structure to a variable.

Parameters

  o | The new variable value.
  preserve_precision | Preserve the current precision.

## set_nocopy()

void MathStructure::set_nocopy | ( | MathStructure & | o,
|  | bool | merge_precision = `false`
| ) |  |

Set the structure to a copy of another structure. Pointers to child structures are copied.

Parameters

  o | The structure to copy.
  merge_precision | Preserve the current precision (unless the new value has a lower precision).

## setAborted()

void MathStructure::setAborted | ( | bool | preserve_precision = `false` | ) |

Mark that calculation was aborted.

Parameters

  preserve_precision | Preserve the current precision.

## setType()

void MathStructure::setType | ( | StructureType | mtype | ) |

Explicitely sets the type of the structure. setType() is dangerous and might crash the program if used unwisely.

Parameters

  mtype | The new structure type

## setUndefined()

void MathStructure::setUndefined | ( | bool | preserve_precision = `false` | ) |

Set the value of the structure to undefined.

Parameters

  preserve_precision | Preserve the current precision.

## setVector()

void MathStructure::setVector | ( | const MathStructure * | o,
|  |  | ...
| ) |  |

Set the structure to a vector.

Parameters

  o | The first element (copied) in the new vector.
  ... | Elements (copied) in the new vector. End with NULL.

The documentation for this class was generated from the following file:

- /opt/local/var/macports/build/_opt_bblocal_var_buildworker_ports_build_ports_math_libqalculate/libqalculate/work/libqalculate-4.9.0/libqalculate/MathStructure.h