X-Git-Url: https://www.ginac.de/ginac.git//ginac.git?p=ginac.git;a=blobdiff_plain;f=ginac%2Fidx.h;h=a5eda1aa93773bbbe142935e6e3fc393dcf5f684;hp=07ff839202acf8584915bc9ed537d6059e00df49;hb=d916416984a857e80962239a0ee93e7216f803bb;hpb=6c9a7dfd6b92368b21a2fe5aaf3638bc849099ba diff --git a/ginac/idx.h b/ginac/idx.h index 07ff8392..a5eda1aa 100644 --- a/ginac/idx.h +++ b/ginac/idx.h @@ -3,7 +3,7 @@ * Interface to GiNaC's indices. */ /* - * GiNaC Copyright (C) 1999-2001 Johannes Gutenberg University Mainz, Germany + * GiNaC Copyright (C) 1999-2011 Johannes Gutenberg University Mainz, Germany * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -17,17 +17,17 @@ * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ -#ifndef __GINAC_IDX_H__ -#define __GINAC_IDX_H__ +#ifndef GINAC_IDX_H +#define GINAC_IDX_H #include "ex.h" +#include "numeric.h" namespace GiNaC { - /** This class holds one index of an indexed object. Indices can * theoretically consist of any symbolic expression but they are usually * only just a symbol (e.g. "mu", "i") or numeric (integer). Indices belong @@ -45,14 +45,20 @@ public: * @return newly constructed index */ explicit idx(const ex & v, const ex & dim); - // functions overriding virtual functions from bases classes + // functions overriding virtual functions from base classes public: - void print(const print_context & c, unsigned level = 0) const; bool info(unsigned inf) const; - unsigned nops() const; - ex & let_op(int i); + size_t nops() const; + ex op(size_t i) const; + ex map(map_function & f) const; + ex evalf(int level = 0) const; + ex subs(const exmap & m, unsigned options = 0) const; + void archive(archive_node& n) const; + void read_archive(const archive_node& n, lst& syms); protected: - ex subs(const lst & ls, const lst & lr) const; + ex derivative(const symbol & s) const; + bool match_same_type(const basic & other) const; + unsigned calchash() const; // new virtual functions in this class public: @@ -63,27 +69,42 @@ public: // non-virtual functions in this class public: /** Get value of index. */ - ex get_value(void) const {return value;} + ex get_value() const {return value;} /** Check whether the index is numeric. */ - bool is_numeric(void) const {return is_ex_exactly_of_type(value, numeric);} + bool is_numeric() const {return is_exactly_a(value);} /** Check whether the index is symbolic. */ - bool is_symbolic(void) const {return !is_ex_exactly_of_type(value, numeric);} + bool is_symbolic() const {return !is_exactly_a(value);} /** Get dimension of index space. */ - ex get_dim(void) const {return dim;} + ex get_dim() const {return dim;} /** Check whether the dimension is numeric. */ - bool is_dim_numeric(void) const {return is_ex_exactly_of_type(dim, numeric);} + bool is_dim_numeric() const {return is_exactly_a(dim);} /** Check whether the dimension is symbolic. */ - bool is_dim_symbolic(void) const {return !is_ex_exactly_of_type(dim, numeric);} + bool is_dim_symbolic() const {return !is_exactly_a(dim);} + + /** Make a new index with the same value but a different dimension. */ + ex replace_dim(const ex & new_dim) const; + + /** Return the minimum of the dimensions of this and another index. + * If this is undecidable, throw an exception. */ + ex minimal_dim(const idx & other) const; + +protected: + void print_index(const print_context & c, unsigned level) const; + void do_print(const print_context & c, unsigned level) const; + void do_print_csrc(const print_csrc & c, unsigned level) const; + void do_print_latex(const print_latex & c, unsigned level) const; + void do_print_tree(const print_tree & c, unsigned level) const; protected: ex value; /**< Expression that constitutes the index (numeric or symbolic name) */ ex dim; /**< Dimension of space (can be symbolic or numeric) */ }; +GINAC_DECLARE_UNARCHIVER(idx); /** This class holds an index with a variance (co- or contravariant). There @@ -102,26 +123,34 @@ public: * @return newly constructed index */ varidx(const ex & v, const ex & dim, bool covariant = false); - // functions overriding virtual functions from bases classes + // functions overriding virtual functions from base classes public: - void print(const print_context & c, unsigned level = 0) const; bool is_dummy_pair_same_type(const basic & other) const; + void archive(archive_node& n) const; + void read_archive(const archive_node& n, lst& syms); +protected: + bool match_same_type(const basic & other) const; // non-virtual functions in this class public: /** Check whether the index is covariant. */ - bool is_covariant(void) const {return covariant;} + bool is_covariant() const {return covariant;} /** Check whether the index is contravariant (not covariant). */ - bool is_contravariant(void) const {return !covariant;} + bool is_contravariant() const {return !covariant;} /** Make a new index with the same value but the opposite variance. */ - ex toggle_variance(void) const; + ex toggle_variance() const; + +protected: + void do_print(const print_context & c, unsigned level) const; + void do_print_tree(const print_tree & c, unsigned level) const; // member variables protected: bool covariant; /**< x.mu, default is contravariant: x~mu */ }; +GINAC_DECLARE_UNARCHIVER(varidx); /** This class holds a spinor index that can be dotted or undotted and that @@ -144,48 +173,45 @@ public: * @return newly constructed index */ spinidx(const ex & v, const ex & dim = 2, bool covariant = false, bool dotted = false); - // functions overriding virtual functions from bases classes + // functions overriding virtual functions from base classes public: - void print(const print_context & c, unsigned level = 0) const; bool is_dummy_pair_same_type(const basic & other) const; + // complex conjugation + ex conjugate() const { return toggle_dot(); } + void archive(archive_node& n) const; + void read_archive(const archive_node& n, lst& syms); +protected: + bool match_same_type(const basic & other) const; // non-virtual functions in this class public: /** Check whether the index is dotted. */ - bool is_dotted(void) const {return dotted;} + bool is_dotted() const {return dotted;} /** Check whether the index is not dotted. */ - bool is_undotted(void) const {return !dotted;} + bool is_undotted() const {return !dotted;} /** Make a new index with the same value and variance but the opposite * dottedness. */ - ex toggle_dot(void) const; + ex toggle_dot() const; /** Make a new index with the same value but opposite variance and * dottedness. */ - ex toggle_variance_dot(void) const; + ex toggle_variance_dot() const; + +protected: + void do_print(const print_context & c, unsigned level) const; + void do_print_latex(const print_latex & c, unsigned level) const; + void do_print_tree(const print_tree & c, unsigned level) const; // member variables protected: bool dotted; }; +GINAC_DECLARE_UNARCHIVER(spinidx); // utility functions -inline const idx &ex_to_idx(const ex & e) -{ - return static_cast(*e.bp); -} - -inline const varidx &ex_to_varidx(const ex & e) -{ - return static_cast(*e.bp); -} - -inline const spinidx &ex_to_spinidx(const ex & e) -{ - return static_cast(*e.bp); -} /** Check whether two indices form a dummy pair. */ bool is_dummy_pair(const idx & i1, const idx & i2); @@ -226,7 +252,7 @@ inline void find_dummy_indices(const exvector & v, exvector & out_dummy) } /** Count the number of dummy index pairs in an index vector. */ -inline unsigned count_dummy_indices(const exvector & v) +inline size_t count_dummy_indices(const exvector & v) { exvector free_indices, dummy_indices; find_free_and_dummy(v.begin(), v.end(), free_indices, dummy_indices); @@ -234,17 +260,18 @@ inline unsigned count_dummy_indices(const exvector & v) } /** Count the number of dummy index pairs in an index vector. */ -inline unsigned count_free_indices(const exvector & v) +inline size_t count_free_indices(const exvector & v) { exvector free_indices, dummy_indices; find_free_and_dummy(v.begin(), v.end(), free_indices, dummy_indices); return free_indices.size(); } -/** Given two index vectors, find those indices that appear in the first - * vector but not in the second one (asymmetric set difference). */ -exvector index_set_difference(const exvector & set1, const exvector & set2); +/** Return the minimum of two index dimensions. If this is undecidable, + * throw an exception. Numeric dimensions are always considered "smaller" + * than symbolic dimensions. */ +ex minimal_dim(const ex & dim1, const ex & dim2); } // namespace GiNaC -#endif // ndef __GINAC_IDX_H__ +#endif // ndef GINAC_IDX_H