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/monom.lisp@ 1814

Last change on this file since 1814 was 1638, checked in by Marek Rychlik, 9 years ago

* empty log message *

File size: 7.3 KB
RevLine 
[1201]1;;; -*- Mode: Lisp -*-
[81]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
[1610]41(defpackage "MONOM"
[395]42 (:use :cl)
[422]43 (:export "MONOM"
[423]44 "EXPONENT"
[422]45 "MAKE-MONOM"
[887]46 "MAKE-MONOM-VARIABLE"
[396]47 "MONOM-ELT"
48 "MONOM-DIMENSION"
49 "MONOM-TOTAL-DEGREE"
50 "MONOM-SUGAR"
51 "MONOM-DIV"
52 "MONOM-MUL"
53 "MONOM-DIVIDES-P"
[395]54 "MONOM-DIVIDES-MONOM-LCM-P"
55 "MONOM-LCM-DIVIDES-MONOM-LCM-P"
[497]56 "MONOM-LCM-EQUAL-MONOM-LCM-P"
[395]57 "MONOM-DIVISIBLE-BY-P"
58 "MONOM-REL-PRIME-P"
59 "MONOM-EQUAL-P"
60 "MONOM-LCM"
61 "MONOM-GCD"
[504]62 "MONOM-DEPENDS-P"
[395]63 "MONOM-MAP"
64 "MONOM-APPEND"
65 "MONOM-CONTRACT"
[1153]66 "MONOM->LIST"))
[81]67
[1610]68(in-package :monom)
[48]69
70(deftype exponent ()
71 "Type of exponent in a monomial."
72 'fixnum)
73
[880]74(deftype monom (&optional dim)
75 "Type of monomial."
76 `(simple-array exponent (,dim)))
77
[884]78;; If a monomial is redefined as structure with slot EXPONENTS, the function
79;; below can be the BOA constructor.
[873]80(defun make-monom (&key
81 (dimension nil dimension-suppied-p)
82 (initial-exponents nil initial-exponents-supplied-p)
83 (initial-exponent nil initial-exponent-supplied-p)
84 &aux
85 (dim (cond (dimension-suppied-p dimension)
86 (initial-exponents-supplied-p (length initial-exponents))
87 (t (error "You must provide DIMENSION nor INITIAL-EXPONENTS"))))
88 (monom (cond
89 ;; when exponents are supplied
90 (initial-exponents-supplied-p
91 (make-array (list dim) :initial-contents initial-exponents
92 :element-type 'exponent))
93 ;; when all exponents are to be identical
94 (initial-exponent-supplied-p
95 (make-array (list dim) :initial-element initial-exponent
96 :element-type 'exponent))
97 ;; otherwise, all exponents are zero
98 (t
99 (make-array (list dim) :element-type 'exponent :initial-element 0)))))
[1600]100 "A constructor (factory) of monomials. If DIMENSION is given, a sequence of
[1599]101DIMENSION elements of type EXPONENT is constructed, where individual
102elements are the value of INITIAL-EXPONENT, which defaults to 0.
103Alternatively, all elements may be specified as a list
104INITIAL-EXPONENTS."
[883]105 monom)
[717]106
[837]107
[48]108;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
109;;
110;; Operations on monomials
111;;
112;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
113
[745]114(defun monom-dimension (m)
[872]115 (length m))
[745]116
[48]117(defmacro monom-elt (m index)
118 "Return the power in the monomial M of variable number INDEX."
[879]119 `(elt ,m ,index))
[48]120
[747]121(defun monom-total-degree (m &optional (start 0) (end (monom-dimension m)))
[48]122 "Return the todal degree of a monomoal M. Optinally, a range
123of variables may be specified with arguments START and END."
[871]124 (reduce #'+ m :start start :end end))
[48]125
[747]126(defun monom-sugar (m &aux (start 0) (end (monom-dimension m)))
[48]127 "Return the sugar of a monomial M. Optinally, a range
128of variables may be specified with arguments START and END."
[749]129 (monom-total-degree m start end))
[48]130
[876]131(defun monom-div (m1 m2 &aux (result (copy-seq m1)))
[48]132 "Divide monomial M1 by monomial M2."
[870]133 (map-into result #'- m1 m2))
[48]134
[876]135(defun monom-mul (m1 m2 &aux (result (copy-seq m1)))
[48]136 "Multiply monomial M1 by monomial M2."
[870]137 (map-into result #'+ m1 m2))
[48]138
139(defun monom-divides-p (m1 m2)
140 "Returns T if monomial M1 divides monomial M2, NIL otherwise."
[877]141 (every #'<= m1 m2))
[48]142
143(defun monom-divides-monom-lcm-p (m1 m2 m3)
144 "Returns T if monomial M1 divides MONOM-LCM(M2,M3), NIL otherwise."
[875]145 (every #'(lambda (x y z) (<= x (max y z)))
[869]146 m1 m2 m3))
[48]147
148(defun monom-lcm-divides-monom-lcm-p (m1 m2 m3 m4)
149 "Returns T if monomial MONOM-LCM(M1,M2) divides MONOM-LCM(M3,M4), NIL otherwise."
[869]150 (every #'(lambda (x y z w) (<= (max x y) (max z w)))
151 m1 m2 m3 m4))
152
[48]153
154(defun monom-lcm-equal-monom-lcm-p (m1 m2 m3 m4)
155 "Returns T if monomial MONOM-LCM(M1,M2) equals MONOM-LCM(M3,M4), NIL otherwise."
[869]156 (every #'(lambda (x y z w) (= (max x y) (max z w)))
157 m1 m2 m3 m4))
[48]158
[869]159
[48]160(defun monom-divisible-by-p (m1 m2)
161 "Returns T if monomial M1 is divisible by monomial M2, NIL otherwise."
[869]162 (every #'>= m1 m2))
[48]163
164(defun monom-rel-prime-p (m1 m2)
165 "Returns T if two monomials M1 and M2 are relatively prime (disjoint)."
[875]166 (every #'(lambda (x y) (zerop (min x y))) m1 m2))
[48]167
168(defun monom-equal-p (m1 m2)
169 "Returns T if two monomials M1 and M2 are equal."
[878]170 (every #'= m1 m2))
[48]171
[874]172(defun monom-lcm (m1 m2 &aux (result (copy-seq m1)))
[48]173 "Returns least common multiple of monomials M1 and M2."
[868]174 (map-into result #'max m1 m2))
[48]175
[874]176(defun monom-gcd (m1 m2 &aux (result (copy-seq m1)))
[48]177 "Returns greatest common divisor of monomials M1 and M2."
[868]178 (map-into result #'min m1 m2))
[48]179
180(defun monom-depends-p (m k)
181 "Return T if the monomial M depends on variable number K."
[738]182 (plusp (monom-elt m k)))
[48]183
[874]184(defmacro monom-map (fun m &rest ml &aux (result `(copy-seq ,m)))
[868]185 `(map-into ,result ,fun ,m ,@ml))
[48]186
187(defmacro monom-append (m1 m2)
[895]188 `(concatenate 'monom ,m1 ,m2))
[48]189
[1632]190(defmacro monom-contract (m k)
[1638]191 "Drop the first K variables in monomial M."
[868]192 `(setf ,m (subseq ,m ,k)))
[886]193
194(defun make-monom-variable (nvars pos &optional (power 1)
195 &aux (m (make-monom :dimension nvars)))
196 "Construct a monomial in the polynomial ring
197RING[X[0],X[1],X[2],...X[NVARS-1]] over the (unspecified) ring RING
198which represents a single variable. It assumes number of variables
199NVARS and the variable is at position POS. Optionally, the variable
200may appear raised to power POWER. "
201 (setf (monom-elt m pos) power)
202 m)
[1151]203
204(defun monom->list (m)
[1152]205 "A human-readable representation of a monomial M as a list of exponents."
[1161]206 (coerce m 'list))
Note: See TracBrowser for help on using the repository browser.