[BACK]Return to dsolv.oxweave CVS log [TXT][DIR] Up to [local] / OpenXM / src / asir-contrib / packages / doc

Annotation of OpenXM/src/asir-contrib/packages/doc/dsolv.oxweave, Revision 1.5

1.5     ! takayama    1: /* $OpenXM: OpenXM/src/asir-contrib/packages/doc/dsolv.oxweave,v 1.4 2002/08/23 08:16:12 takayama Exp $ */
1.1       takayama    2: /* dsolv.oxweave */
1.4       takayama    3: /*&C-texi
                      4: @node DSOLV Functions,,, Top
                      5: */
                      6:
1.1       takayama    7: /*&eg-texi
                      8:
                      9: @chapter DSOLV Functions
                     10:
                     11: This section is a collection of functions to solve regular holonomic
                     12: systems in terms of series.
                     13: Algorithms are explained in the book [SST].
                     14: You can load this package by the command
1.3       takayama   15: @code{load("dsolv")$}
1.1       takayama   16: This package requires @code{Diff} and @code{dmodule}.
                     17:
1.3       takayama   18: To use the functions of the package @code{dsolv} in OpenXM/Risa/Asir,
                     19: executing the command @code{load("dsolv")$}
                     20: is necessary at first.
                     21:
                     22:
1.1       takayama   23: This package uses @code{ox_sm1}, so the variables you can use
                     24: is as same as those you can use in the package @code{sm1}.
                     25:
                     26: @section Functions
                     27:
                     28: */
                     29:
                     30: /*&jp-texi
                     31:
                     32: @chapter DSOLV $BH!?t(B
                     33:
                     34: $B$3$N@a$O@5B'%[%m%N%_%C%/7O$r5i?t$G2r$/$?$a$N(B
                     35: $BH!?t$r$"$D$a$F$"$k(B.
                     36: $B%"%k%4%j%:%`$K$D$$$F$O(B [SST] $B$K@bL@$,$"$k(B.
                     37: $B$3$N%Q%C%1!<%8$O<!$N%3%^%s%I(B @code{load("dsolv");}
                     38: $B$G%m!<%I$G$-$k(B.
1.3       takayama   39: $B$3$N%Q%C%1!<%8$O(B @code{Diff} $B$*$h$S(B @code{Dmodule} $B$r;HMQ$9$k(B.
                     40:
                     41: OpenXM/Risa/Asir $B$G$NMxMQ$K$"$?$C$F$O(B,
                     42: @example
                     43: load("dsolv");$
                     44: @end example
                     45: $B$,;O$a$KI,MW(B.
1.1       takayama   46:
                     47: $B$3$N%Q%C%1!<%8$O(B @code{ox_sm1} $B$rMxMQ$7$F$$$k(B.
                     48: $B$7$?$,$C$F;HMQ$G$-$kJQ?t$O(B @code{sm1} $B%Q%C%1!<%8$HF1MM$NJQ?t$7$+$D$+$($J$$(B.
                     49:
1.2       takayama   50: @section $BH!?t0lMw(B
1.1       takayama   51:
                     52: */
                     53:
1.5     ! takayama   54: /*&C-texi
1.1       takayama   55: @menu
                     56: * dsolv_dual::
1.4       takayama   57: * dsolv_starting_term::
1.1       takayama   58: @end menu
1.4       takayama   59: */
                     60:
                     61:
                     62: /*&eg-texi
1.1       takayama   63: @node dsolv_dual,,, DSOLV Functions
                     64: @subsection @code{dsolv_dual}
                     65: @findex dsolv_dual
                     66: @table @t
                     67: @item dsolv_dual(@var{f},@var{v})
                     68: ::  Grobner dual of @var{f}.
                     69: @end table
                     70:
                     71: @table @var
                     72: @item return
                     73: List
                     74: @item f, v
                     75: List
                     76: @end table
                     77:
                     78: @itemize @bullet
                     79: @item  It returns the Grobner dual of @var{f} in the ring of polynomials
                     80: with variables @var{v}.
                     81: @item The ideal generated by @var{f} must be primary to the maximal ideal
                     82: generated by @var{v}.
                     83: If it is not primary to the maximal ideal, then this function falls into
                     84: an infinite loop.
1.3       takayama   85: @end itemize
                     86:
                     87:
                     88: @noindent
                     89: Algorithm:
                     90: This is an implementation of Algorithm 2.3.14 of the book [SST].
1.1       takayama   91: If we replace variables x, y, ... in the output by log(x), log(y), ...,
                     92: then these polynomials in log are solutions of the system of differential
1.2       takayama   93: equations @var{f}@code{_(x->x*dx, y->y*dy, ...)}.
1.3       takayama   94:
1.1       takayama   95: */
                     96:
                     97: /*&jp-texi
1.4       takayama   98: @node dsolv_dual,,, DSOLV Functions
1.1       takayama   99: @subsection @code{dsolv_dual}
                    100: @findex dsolv_dual
                    101: @table @t
                    102: @item dsolv_dual(@var{f},@var{v})
                    103: ::  @var{f} $B$N%0%l%V%JAPBP(B
                    104: @end table
                    105:
                    106: @table @var
                    107: @item $BLa$jCM(B
                    108: $B%j%9%H(B
                    109: @item f, v
                    110: $B%j%9%H(B
                    111: @end table
                    112:
                    113: @itemize @bullet
                    114: @item  $BJQ?t(B @var{v} $B>e$NB?9`<04D$K$*$$$F(B,
                    115: @var{f}  $B$N%0%l%V%JAPBP$r5a$a$k(B.
                    116: @item @var{f} $B$G@8@.$5$l$k%$%G%"%k$O(B, @var{v} $B$G@8@.$5$l$k6KBg%$%G%"%k$K(B
                    117: $BBP$7$F(B, primary $B$G$J$$$H$$$1$J$$(B.
                    118: primary $B$G$J$$>l9g(B, $B$3$NH!?t$OL58B%k!<%W$K$*$A$$$k(B.
1.3       takayama  119: @end itemize
                    120:
                    121: @noindent
                    122: Algorithm:
                    123: $B$3$NH!?t$OK\(B [SST] $B$N(B Algorithm 2.3.14  $B$N<BAu$G$"$k(B.
1.1       takayama  124: $B=PNOCf$NJQ?t(B x, y, ... $B$r$=$l$>$l(B log(x), log(y), ..., $B$G$*$-$+$($k$H(B,
                    125: $B$3$l$i$N(B log $BB?9`<0$O(B,
1.2       takayama  126: @var{f}@code{_(x->x*dx, y->y*dy, ...)}
                    127: $B$G@8@.$5$l$kHyJ,J}Dx<07O(B
1.1       takayama  128: $B$N2r$H$J$C$F$$$k(B.
                    129: */
                    130:
                    131: /*&C-texi
                    132:
                    133: @example
                    134:
                    135:
                    136: [435] dsolv_dual([y-x^2,y+x^2],[x,y]);
                    137: [x,1]
                    138: [436] dsolv_act(y*dy-sm1_mul(x*dx,x*dx,[x,y]),log(x),[x,y]);
                    139: 0
                    140: [437] dsolv_act(y*dy+sm1_mul(x*dx,x*dx,[x,y]),log(x),[x,y]);
                    141: 0
                    142:
                    143: [439] primadec([y^2-x^3,x^2*y^2],[x,y]);
                    144: [[[y^2-x^3,y^4,x^2*y^2],[y,x]]]
                    145: [440] dsolv_dual([y^2-x^3,x^2*y^2],[x,y]);
                    146: [x*y^3+1/4*x^4*y, x^2*y, x*y^2+1/12*x^4, y^3+x^3*y,
                    147:  x^2, x*y, y^2+1/3*x^3, x, y, 1]
                    148:
                    149: [441] dsolv_test_dual();
                    150:   Output is  omitted.
                    151:
                    152: @end example
                    153:
                    154: */
                    155:
                    156:
                    157: /*&eg-texi
                    158:
                    159: @node dsolv_starting_term,,, DSOLV Functions
                    160: @subsection @code{dsolv_starting_term}
                    161: @findex dsolv_starting_term
                    162: @table @t
                    163: @item dsolv_starting_term(@var{f},@var{v},@var{w})
                    164: ::  Find the starting term of the solutions of
                    165: the regular holonomic system @var{f}
                    166: to the direction @var{w}.
                    167: @end table
                    168:
                    169: @table @var
                    170: @item return
                    171: List
                    172: @item f, v, w
                    173: List
                    174: @end table
                    175:
                    176: @itemize @bullet
                    177: @item Find the starting term of the solutions of
                    178: the regular holonomic system @var{f}
                    179: to the direction @var{w}.
                    180: @item The return value is of the form
                    181: [[@var{e1}, @var{e2}, ...],
                    182:  [@var{s1}, @var{s2}, ...]]
                    183: where @var{e1} is an exponent vector and @var{s1} is the corresponding
                    184: solution set, and so on.
                    185: @item If you set @code{Dsolv_message_starting_term} to 1,
                    186: then this function outputs messages during the computation.
                    187: @end itemize
                    188:
                    189: */
                    190:
                    191: /*&jp-texi
                    192:
1.4       takayama  193: @node dsolv_starting_term,,, DSOLV Functions
1.1       takayama  194: @subsection @code{dsolv_starting_term}
                    195: @findex dsolv_starting_term
                    196: @table @t
                    197: @item dsolv_starting_term(@var{f},@var{v},@var{w})
                    198: :: $B@5B'%[%m%N%_%C%/7O(B @var{f} $B$NJ}8~(B @var{w} $B$G$N5i?t2r$N(B
                    199: Staring terms $B$r7W;;$9$k(B. $B$3$3$G(B, @var{v} $B$OJQ?t$N=89g(B.
                    200: @end table
                    201:
                    202: @table @var
                    203: @item $BLa$jCM(B
                    204: $B%j%9%H(B
                    205: @item f, v, w
                    206: $B%j%9%H(B
                    207: @end table
                    208:
                    209: @itemize @bullet
                    210: @item $B@5B'%[%m%N%_%C%/7O(B @var{f} $B$NJ}8~(B @var{w} $B$G$N5i?t2r$N(B
                    211: Staring terms $B$r7W;;$9$k(B. $B$3$3$G(B, @var{v} $B$OJQ?t$N=89g(B.
                    212: @item $BLa$jCM$O<!$N7A$r$7$F$$$k(B:
                    213: [[@var{e1}, @var{e2}, ...],
                    214:  [@var{s1}, @var{s2}, ...]]
                    215: $B$3$3$G(B @var{e1} $B$O(B exponent $B%Y%/%H%k$G$"$j(B @var{s1} $B$O$3$N%Y%/%H%k$K(B
                    216: $BBP1~$9$k2r$N=89g(B,   $B0J2<F1MM(B.
                    217: @item $BJQ?t(B @code{Dsolv_message_starting_term} $B$r(B 1 $B$K$7$F$*$/$H(B,
                    218: $B$3$NH!?t$O7W;;$NESCf$K$$$m$$$m$H%a%C%;!<%8$r=PNO$9$k(B.
                    219: @end itemize
                    220:
1.3       takayama  221:
1.1       takayama  222: */
                    223:
                    224: /*&C-texi
1.3       takayama  225:
                    226: @noindent
                    227: Algorithm: Saito, Sturmfels, Takayama, Grobner Deformations of Hypergeometric
                    228: Differential Equations ([SST]), Chapter 2.
                    229:
1.1       takayama  230:
                    231: @example
                    232: [1076]   F = sm1_gkz( [ [[1,1,1,1,1],[1,1,0,-1,0],[0,1,1,-1,0]], [1,0,0]]);
                    233: [[x5*dx5+x4*dx4+x3*dx3+x2*dx2+x1*dx1-1,-x4*dx4+x2*dx2+x1*dx1,
                    234:   -x4*dx4+x3*dx3+x2*dx2,
                    235:   -dx2*dx5+dx1*dx3,dx5^2-dx2*dx4],[x1,x2,x3,x4,x5]]
                    236: [1077]  A= dsolv_starting_term(F[0],F[1],[1,1,1,1,0])$
                    237: Computing the initial ideal.
                    238: Done.
                    239: Computing a primary ideal decomposition.
                    240: Primary ideal decomposition of the initial Frobenius ideal
                    241: to the direction [1,1,1,1,0] is
                    242: [[[x5+2*x4+x3-1,x5+3*x4-x2-1,x5+2*x4+x1-1,3*x5^2+(8*x4-6)*x5-8*x4+3,
                    243:    x5^2-2*x5-8*x4^2+1,x5^3-3*x5^2+3*x5-1],
                    244:  [x5-1,x4,x3,x2,x1]]]
                    245:
                    246: ----------- root is [ 0 0 0 0 1 ]
                    247: ----------- dual system is
                    248: [x5^2+(-3/4*x4-1/2*x3-1/4*x2-1/2*x1)*x5+1/8*x4^2
                    249:  +(1/4*x3+1/4*x1)*x4+1/4*x2*x3-1/8*x2^2+1/4*x1*x2,
                    250:  x4-2*x3+3*x2-2*x1,x5-x3+x2-x1,1]
                    251:
                    252: [1078] A[0];
                    253: [[ 0 0 0 0 1 ]]
                    254: [1079] map(fctr,A[1][0]);
                    255: [[[1/8,1],[x5,1],[log(x2)+log(x4)-2*log(x5),1],
                    256:           [2*log(x1)-log(x2)+2*log(x3)+log(x4)-4*log(x5),1]],
                    257:  [[1,1],[x5,1],[-2*log(x1)+3*log(x2)-2*log(x3)+log(x4),1]],
                    258:  [[1,1],[x5,1],[-log(x1)+log(x2)-log(x3)+log(x5),1]],
                    259:  [[1,1],[x5,1]]]
                    260:
                    261: @end example
                    262:
                    263: */
                    264:

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>