/** @file idx.cpp * * Implementation of GiNaC's indices. */ /* * GiNaC Copyright (C) 1999-2000 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 * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program 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 General Public License for more details. * * 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 */ #include #include "idx.h" #include "ex.h" #include "lst.h" #include "relational.h" #include "archive.h" #include "utils.h" #include "debugmsg.h" #ifndef NO_NAMESPACE_GINAC namespace GiNaC { #endif // ndef NO_NAMESPACE_GINAC GINAC_IMPLEMENT_REGISTERED_CLASS(idx, basic) ////////// // default constructor, destructor, copy constructor assignment operator and helpers ////////// // public idx::idx() : inherited(TINFO_idx), symbolic(true), covariant(false) { debugmsg("idx default constructor",LOGLEVEL_CONSTRUCT); serial=next_serial++; name="index"+ToString(serial); } idx::~idx() { debugmsg("idx destructor",LOGLEVEL_DESTRUCT); destroy(0); } idx::idx(const idx & other) { debugmsg("idx copy constructor",LOGLEVEL_CONSTRUCT); copy(other); } const idx & idx::operator=(const idx & other) { debugmsg("idx operator=",LOGLEVEL_ASSIGNMENT); if (this != &other) { destroy(1); copy(other); } return *this; } // protected void idx::copy(const idx & other) { inherited::copy(other); serial=other.serial; symbolic=other.symbolic; name=other.name; value=other.value; covariant=other.covariant; } void idx::destroy(bool call_parent) { if (call_parent) inherited::destroy(call_parent); } ////////// // other constructors ////////// // public idx::idx(bool cov) : inherited(TINFO_idx), symbolic(true), covariant(cov) { debugmsg("idx constructor from bool",LOGLEVEL_CONSTRUCT); serial=next_serial++; name="index"+ToString(serial); } idx::idx(const string & n, bool cov) : inherited(TINFO_idx), symbolic(true), name(n), covariant(cov) { debugmsg("idx constructor from string,bool",LOGLEVEL_CONSTRUCT); serial=next_serial++; } idx::idx(const char * n, bool cov) : inherited(TINFO_idx), symbolic(true), name(n), covariant(cov) { debugmsg("idx constructor from char*,bool",LOGLEVEL_CONSTRUCT); serial=next_serial++; } idx::idx(unsigned v, bool cov) : inherited(TINFO_idx), symbolic(false), value(v), covariant(cov) { debugmsg("idx constructor from unsigned,bool",LOGLEVEL_CONSTRUCT); serial=0; } ////////// // archiving ////////// /** Construct object from archive_node. */ idx::idx(const archive_node &n, const lst &sym_lst) : inherited(n, sym_lst) { debugmsg("idx constructor from archive_node", LOGLEVEL_CONSTRUCT); n.find_bool("symbolic", symbolic); n.find_bool("covariant", covariant); if (symbolic) { serial = next_serial++; if (!(n.find_string("name", name))) name = "index" + ToString(serial); } else { serial = 0; n.find_unsigned("value", value); } } /** Unarchive the object. */ ex idx::unarchive(const archive_node &n, const lst &sym_lst) { ex s = (new idx(n, sym_lst))->setflag(status_flags::dynallocated); if (ex_to_idx(s).symbolic) { // If idx is in sym_lst, return the existing idx for (unsigned i=0; i (const_cast(other)); if (covariant!=o.covariant) { // different co/contravariant return covariant ? -1 : 1; } if ((!symbolic) && (!o.symbolic)) { // non-symbolic, of equal type: compare values if (value==o.value) { return 0; } return value (const_cast(other)); if (covariant!=o.covariant) return false; if (symbolic!=o.symbolic) return false; if (symbolic && o.symbolic) return serial==o.serial; return value==o.value; } unsigned idx::calchash(void) const { hashvalue=golden_ratio_hash(golden_ratio_hash(tinfo_key ^ serial)); setflag(status_flags::hash_calculated); return hashvalue; } ////////// // new virtual functions which can be overridden by derived classes ////////// // public bool idx::is_co_contra_pair(const basic & other) const { // like is_equal_same_type(), but tests for different covariant status GINAC_ASSERT(is_of_type(other,idx)); const idx & o=static_cast (const_cast(other)); if (covariant==o.covariant) return false; if (symbolic!=o.symbolic) return false; if (symbolic && o.symbolic) return serial==o.serial; return value==o.value; } bool idx::is_symbolic(void) const { return symbolic; } unsigned idx::get_value(void) const { return value; } bool idx::is_covariant(void) const { return covariant; } ex idx::toggle_covariant(void) const { idx * i_copy=static_cast(duplicate()); i_copy->covariant = !i_copy->covariant; i_copy->clearflag(status_flags::hash_calculated); return i_copy->setflag(status_flags::dynallocated); } ////////// // non-virtual functions in this class ////////// // none ////////// // static member variables ////////// // protected unsigned idx::next_serial=0; ////////// // global constants ////////// const idx some_idx; const type_info & typeid_idx=typeid(some_idx); ////////// // other functions ////////// int canonicalize_indices(exvector & iv, bool antisymmetric) { if (iv.size()<2) { // nothing do to for 0 or 1 indices return INT_MAX; } bool something_changed=false; int sig=1; // simple bubble sort algorithm should be sufficient for the small number of indices needed exvector::const_iterator last_idx=iv.end(); exvector::const_iterator next_to_last_idx=iv.end()-1; for (exvector::iterator it1=iv.begin(); it1!=next_to_last_idx; ++it1) { for (exvector::iterator it2=it1+1; it2!=last_idx; ++it2) { int cmpval=(*it1).compare(*it2); if (cmpval==1) { iter_swap(it1,it2); something_changed=true; if (antisymmetric) sig=-sig; } else if ((cmpval==0) && antisymmetric) { something_changed=true; sig=0; } } } return something_changed ? sig : INT_MAX; } exvector idx_intersect(const exvector & iv1, const exvector & iv2) { // build a vector of symbolic indices contained in iv1 and iv2 simultaneously // assumes (but does not test) that each index occurs at most twice exvector iv_intersect; for (exvector::const_iterator cit1=iv1.begin(); cit1!=iv1.end(); ++cit1) { GINAC_ASSERT(is_ex_of_type(*cit1,idx)); if (ex_to_idx(*cit1).is_symbolic()) { for (exvector::const_iterator cit2=iv2.begin(); cit2!=iv2.end(); ++cit2) { GINAC_ASSERT(is_ex_of_type(*cit2,idx)); if ((*cit1).is_equal(*cit2)) { iv_intersect.push_back(*cit1); break; } } } } return iv_intersect; } #define TEST_PERMUTATION(A,B,C,P) \ if ((iv3[B].is_equal(iv2[0]))&&(iv3[C].is_equal(iv2[1]))) { \ if (antisymmetric) *sig=P; \ return iv3[A]; \ } ex permute_free_index_to_front(const exvector & iv3, const exvector & iv2, bool antisymmetric, int * sig) { // match (return value,iv2) to iv3 by permuting indices // iv3 is always cyclic GINAC_ASSERT(iv3.size()==3); GINAC_ASSERT(iv2.size()==2); *sig=1; TEST_PERMUTATION(0,1,2, 1); TEST_PERMUTATION(0,2,1, -1); TEST_PERMUTATION(1,0,2, -1); TEST_PERMUTATION(1,2,0, 1); TEST_PERMUTATION(2,0,1, 1); TEST_PERMUTATION(2,1,0, -1); throw(std::logic_error("permute_free_index_to_front(): no valid permutation found")); } unsigned subs_index_in_exvector(exvector & v, const ex & is, const ex & ir) { exvector::iterator it; unsigned replacements=0; unsigned current_replacements; GINAC_ASSERT(is_ex_of_type(is,idx)); GINAC_ASSERT(is_ex_of_type(ir,idx)); for (it=v.begin(); it!=v.end(); ++it) { current_replacements=count_index(*it,is); if (current_replacements>0) { (*it)=(*it).subs(is==ir); } replacements += current_replacements; } return replacements; } unsigned count_index(const ex & e, const ex & i) { exvector idxv=e.get_indices(); unsigned count=0; for (exvector::const_iterator cit=idxv.begin(); cit!=idxv.end(); ++cit) { if ((*cit).is_equal(i)) count++; } return count; } ex subs_indices(const ex & e, const exvector & idxv_subs, const exvector & idxv_repl) { GINAC_ASSERT(idxv_subs.size()==idxv_repl.size()); ex res=e; for (unsigned i=0; i