close Warning: Can't synchronize with repository "(default)" (The repository directory has changed, you should resynchronize the repository with: trac-admin $ENV repository resync '(default)'). Look in the Trac log for more information.

source: branches/f4grobner/monomial.lisp@ 843

Last change on this file since 843 was 843, checked in by Marek Rychlik, 10 years ago

* empty log message *
File size: 7.7 KB
RevLine 
[81]1;;; -*- Mode: Lisp; Package: Maxima; Syntax: Common-Lisp; Base: 10 -*-
2;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3;;;
4;;; Copyright (C) 1999, 2002, 2009, 2015 Marek Rychlik <rychlik@u.arizona.edu>
5;;;
6;;; This program is free software; you can redistribute it and/or modify
7;;; it under the terms of the GNU General Public License as published by
8;;; the Free Software Foundation; either version 2 of the License, or
9;;; (at your option) any later version.
10;;;
11;;; This program is distributed in the hope that it will be useful,
12;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
13;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14;;; GNU General Public License for more details.
15;;;
16;;; You should have received a copy of the GNU General Public License
17;;; along with this program; if not, write to the Free Software
18;;; Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19;;;
20;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
21
[418]22;;----------------------------------------------------------------
23;; This package implements BASIC OPERATIONS ON MONOMIALS
24;;----------------------------------------------------------------
25;; DATA STRUCTURES: Conceptually, monomials can be represented as lists:
26;;
27;; monom: (n1 n2 ... nk) where ni are non-negative integers
28;;
29;; However, lists may be implemented as other sequence types,
30;; so the flexibility to change the representation should be
31;; maintained in the code to use general operations on sequences
32;; whenever possible. The optimization for the actual representation
33;; should be left to declarations and the compiler.
34;;----------------------------------------------------------------
35;; EXAMPLES: Suppose that variables are x and y. Then
36;;
[714]37;; Monom x*y^2 ---> (1 2)
[418]38;;
39;;----------------------------------------------------------------
40
[394]41(defpackage "MONOMIAL"
[395]42 (:use :cl)
[422]43 (:export "MONOM"
[423]44 "EXPONENT"
[422]45 "MAKE-MONOM"
[396]46 "MONOM-ELT"
47 "MONOM-DIMENSION"
48 "MONOM-TOTAL-DEGREE"
49 "MONOM-SUGAR"
50 "MONOM-DIV"
51 "MONOM-MUL"
52 "MONOM-DIVIDES-P"
[395]53 "MONOM-DIVIDES-MONOM-LCM-P"
54 "MONOM-LCM-DIVIDES-MONOM-LCM-P"
[497]55 "MONOM-LCM-EQUAL-MONOM-LCM-P"
[395]56 "MONOM-DIVISIBLE-BY-P"
57 "MONOM-REL-PRIME-P"
58 "MONOM-EQUAL-P"
59 "MONOM-LCM"
60 "MONOM-GCD"
[504]61 "MONOM-DEPENDS-P"
[395]62 "MONOM-MAP"
63 "MONOM-APPEND"
64 "MONOM-CONTRACT"
65 "MONOM-EXPONENTS"))
[81]66
[419]67(in-package :monomial)
[48]68
69(deftype exponent ()
70 "Type of exponent in a monomial."
71 'fixnum)
72
[723]73(defstruct (monom
[725]74 ;; BOA constructor
[841]75 ;; NOTE: having a non-default constructor inhibits reading via #S(...)
[842]76 (:constructor make-monom (&key
77 (dimension 0)
[838]78 (initial-exponents #() initial-exponents-supplied-p)
79 (initial-exponent #() initial-exponent-supplied-p)
[843]80 &aux
[838]81 (exponents (cond
82 ;; when exponents are supplied
83 (initial-exponents-supplied-p
84 (make-array (list dimension) :initial-contents initial-exponents
85 :element-type 'exponent))
86 ;; when all exponents are to be identical
87 (initial-exponent-supplied-p
88 (make-array (list dimension) :initial-element initial-exponent
89 :element-type 'exponent))
90 ;; otherwise, all exponents are zero
91 (t (make-array (list dimension) :element-type 'exponent :initial-element 0))))))
[837]92 )
[726]93 (exponents nil :type (vector exponent *)))
[717]94
[837]95
[48]96;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
97;;
98;; Operations on monomials
99;;
100;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
101
[745]102(defun monom-dimension (m)
103 (declare (type monom m))
[746]104 (length (monom-exponents m)))
[745]105
[48]106(defmacro monom-elt (m index)
107 "Return the power in the monomial M of variable number INDEX."
[727]108 `(elt (monom-exponents ,m) ,index))
[48]109
[747]110(defun monom-total-degree (m &optional (start 0) (end (monom-dimension m)))
[48]111 "Return the todal degree of a monomoal M. Optinally, a range
112of variables may be specified with arguments START and END."
113 (declare (type monom m) (fixnum start end))
[728]114 (reduce #'+ (monom-exponents m) :start start :end end))
[48]115
[747]116(defun monom-sugar (m &aux (start 0) (end (monom-dimension m)))
[48]117 "Return the sugar of a monomial M. Optinally, a range
118of variables may be specified with arguments START and END."
119 (declare (type monom m) (fixnum start end))
[749]120 (monom-total-degree m start end))
[48]121
[729]122(defun monom-div (m1 m2 &aux (result (copy-structure m1)))
[48]123 "Divide monomial M1 by monomial M2."
[728]124 (declare (type monom m1 m2))
[729]125 (map-into (monom-exponents result) #'- (monom-exponents m1) (monom-exponents m2))
126 result)
[48]127
[729]128(defun monom-mul (m1 m2 &aux (result (copy-structure m1)))
[48]129 "Multiply monomial M1 by monomial M2."
130 (declare (type monom m1 m2 result))
[729]131 (map-into (monom-exponents result) #'+ (monom-exponents m1) (monom-exponents m2))
132 result)
[48]133
134(defun monom-divides-p (m1 m2)
135 "Returns T if monomial M1 divides monomial M2, NIL otherwise."
136 (declare (type monom m1 m2))
[730]137 (every #'<= (monom-exponents m1) (monom-exponents m2)))
[48]138
139(defun monom-divides-monom-lcm-p (m1 m2 m3)
140 "Returns T if monomial M1 divides MONOM-LCM(M2,M3), NIL otherwise."
141 (declare (type monom m1 m2 m3))
[731]142 (every #'(lambda (x y z) (declare (type exponent x y z)) (<= x (max y z)))
143 (monom-exponents m1)
144 (monom-exponents m2)
145 (monom-exponents m3)))
[48]146
147(defun monom-lcm-divides-monom-lcm-p (m1 m2 m3 m4)
148 "Returns T if monomial MONOM-LCM(M1,M2) divides MONOM-LCM(M3,M4), NIL otherwise."
149 (declare (type monom m1 m2 m3 m4))
[732]150 (every #'(lambda (x y z w) (declare (type exponent x y z w)) (<= (max x y) (max z w)))
151 (monom-exponents m1)
152 (monom-exponents m2)
153 (monom-exponents m3)
154 (monom-exponents m4)))
[48]155
156(defun monom-lcm-equal-monom-lcm-p (m1 m2 m3 m4)
157 "Returns T if monomial MONOM-LCM(M1,M2) equals MONOM-LCM(M3,M4), NIL otherwise."
158 (declare (type monom m1 m2 m3 m4))
[733]159 (every #'(lambda (x y z w) (declare (type exponent x y z w)) (= (max x y) (max z w)))
160 (monom-exponents m1)
161 (monom-exponents m2)
162 (monom-exponents m3)
163 (monom-exponents m4)))
[48]164
165(defun monom-divisible-by-p (m1 m2)
166 "Returns T if monomial M1 is divisible by monomial M2, NIL otherwise."
167 (declare (type monom m1 m2))
[733]168 (every #'>= (monom-exponents m1) (monom-exponents m2)))
[48]169
170(defun monom-rel-prime-p (m1 m2)
171 "Returns T if two monomials M1 and M2 are relatively prime (disjoint)."
172 (declare (type monom m1 m2))
[734]173 (every #'(lambda (x y) (declare (type exponent x y)) (zerop (min x y)))
174 (monom-exponents m1)
175 (monom-exponents m2)))
[48]176
177(defun monom-equal-p (m1 m2)
178 "Returns T if two monomials M1 and M2 are equal."
179 (declare (type monom m1 m2))
[735]180 (every #'= (monom-exponents m1) (monom-exponents m2)))
[48]181
[736]182(defun monom-lcm (m1 m2 &aux (result (copy-structure m1)))
[48]183 "Returns least common multiple of monomials M1 and M2."
184 (declare (type monom m1 m2))
[736]185 (map-into (monom-exponents result) #'max
186 (monom-exponents m1)
[737]187 (monom-exponents m2))
188 result)
[48]189
[737]190(defun monom-gcd (m1 m2 &aux (result (copy-structure m1)))
[48]191 "Returns greatest common divisor of monomials M1 and M2."
192 (declare (type monom m1 m2))
[737]193 (map-into (monom-exponents result) #'min (monom-exponents m1) (monom-exponents m2))
194 result)
[48]195
196(defun monom-depends-p (m k)
197 "Return T if the monomial M depends on variable number K."
198 (declare (type monom m) (fixnum k))
[738]199 (plusp (monom-elt m k)))
[48]200
[738]201(defmacro monom-map (fun m &rest ml &aux (result `(copy-structure ,m)))
202 `(map-into (monom-exponents ,result) ,fun ,m ,@ml))
[48]203
204(defmacro monom-append (m1 m2)
[835]205 `(make-monom :exponents (concatenate 'vector (monom-exponents ,m1) (monom-exponents ,m2))))
[48]206
207(defmacro monom-contract (k m)
[740]208 `(setf (monom-exponents ,m) (subseq (monom-exponents ,m) ,k)))
Note: See TracBrowser for help on using the repository browser.