[BACK]Return to usage.sm1 CVS log [TXT][DIR] Up to [local] / OpenXM / src / kan96xx / Kan

Annotation of OpenXM/src/kan96xx/Kan/usage.sm1, Revision 1.1.1.1

1.1       maekawa     1: %% usage.sm1
                      2: %%  [(key word)
                      3: %%    [(   )
                      4: %%     (   )
                      5: %%    ]
                      6: %%   ] putUsages
                      7: [(putUsages)
                      8:  [$[(key word) [(explanation line 1) (explanation line 2) ... ]] putUsages$ ]
                      9: ] putUsages
                     10:
                     11: [(;)
                     12:  [(Output the prompt sm1>)]
                     13: ] putUsages
                     14:
                     15: [(::)
                     16:  [(Pop the top of the stack and print it.)]
                     17: ] putUsages
                     18:
                     19: [(Libraries)
                     20:  [
                     21:   (Doc/appell.sm1   : It generates Appell differential equations.)
                     22:   (Doc/bfunction.sm1: Computing the b-function of a given polynomial)
                     23:   (                   by using Groebner basis. Written by T.Oaku.)
                     24:   (Doc/factor-a.sm1: A sample interface to factor polynomials by risa/asir.)
                     25:   (Doc/gkz.sm1     : It generates GKZ systems for given A and b.)
                     26:   (Doc/hol.sm1     : Basic package for holonomic systems. Holonomic rank,)
                     27:   (                  characteristic ideal, singular locus.)
                     28:   (Doc/resol0.sm1  : Constructing Schreyer resolutions. tower.sm1, tower-sugar.sm1)
                     29:   (Doc/rest0.sm1   : Computing the restriction (inverse image) as a complex.)
                     30:   (                  This package is under developement by T.Oaku.)
                     31:   (                  cf. restall_s.sm1, resol0.sm1)
                     32:  ]
                     33: ] putUsages
                     34: /Loadall {
                     35:    [(parse) (bfunction.sm1) pushfile] extension
                     36:    [(parse) (hol.sm1) pushfile] extension
                     37:    [(parse) (gkz.sm1) pushfile] extension
                     38:    [(parse) (appell.sm1)pushfile] extension
                     39:    [(parse) (resol0.sm1)pushfile] extension
                     40: } def
                     41: [(Loadall)
                     42:  [(Loadall loads the packages  bfunction.sm1, hol.sm1, gkz.sm1, appell.sm1,)
                     43:   (resol0.sm1)
                     44: ]] putUsages
                     45:
                     46: [(Version)
                     47:  [(Packages must be loaded in a proper version of kan/sm1.)
                     48:   (It can be checked as follows.)
                     49:   (Example:  )
                     50:   (   /factor-a.version (2.981101) def)
                     51:   (   factor-a.version [(Version)] system_variable gt )
                     52:   $   { (This package requires the latest version of kan/sm1) message$
                     53:   $     (Please get it from http://www.math.kobe-u.ac.jp/KAN) message$
                     54:   $     error$
                     55:   $   } { } ifelse$
                     56: ]]putUsages
                     57:
                     58:
                     59: [(bugs)
                     60:  [(All known bugs are fixed.)
                     61:  ]
                     62: ] putUsages
                     63:
                     64: [(factor)
                     65:  [(Load Doc/factor-a.sm1, then factorization can be computed by invoking )
                     66:   (asir, of which ftp cite is at http://www.math.kobe-u.ac.jp)
                     67:  ]
                     68: ] putUsages
                     69:
                     70:
                     71: [(message)
                     72:  [ (string message)
                     73:    (Output the string to the screen with the newline.)
                     74:    (cf. messagen.)
                     75:    $Example:  (Hello world) message$
                     76:  ]
                     77: ] putUsages
                     78:
                     79: [(messagen)
                     80:  [ (string messagen)
                     81:    (Output the string to the screen without the newline.)
                     82:    (cf. message.)
                     83:    $Example:  (Hello world) messagen$
                     84:  ]
                     85: ] putUsages
                     86:
                     87: [(ring_of_polynomials)
                     88:  [ (string ring_of_polynomials)
                     89:    (This command is used to define a ring of polynomials with the macros)
                     90:    (define_ring, weight_vector and elimination_order.)
                     91:    (The user cannot use the variable names h, e, H and E.)
                     92:    (cf. show_ring, system_variable --- CurrentRing)
                     93:    (    print_switch_status, switch_function)
                     94:    (Example: [(x,y,z) ring_of_polynomials (x,y) elimination_order 0] define_ring)
                     95:  ]
                     96: ] putUsages
                     97:
                     98: [(ring_of_differential_operators)
                     99:  [ (string ring_of_differential_operators)
                    100:    (This command is used to define a ring of differential operators )
                    101:    (with the macros define_ring, weight_vector and elimination_order.)
                    102:    (The user cannot use the variable names h, e, H and E.)
                    103:    (cf. show_ring, system_variable --- CurrentRing)
                    104:    (    print_switch_status, switch_function)
                    105:    (Example: [(x,y,z) ring_of_differential_operators (Dx,Dy) elimination_order 0] define_ring)
                    106:    (         Dx,Dy, and Dz are corresponding differential operators to the )
                    107:    (         space variables x, y and z.)
                    108:  ]
                    109: ] putUsages
                    110:
                    111: [(ring_of_difference_operators)
                    112:  [ (string ring_of_difference_operators)
                    113:    (  )
                    114:    (This command has not been maintained since 1996. So, there may be)
                    115:    (troubles if it is used with new features of kan/sm1.)
                    116:    (  )
                    117:    (This command is used to define a ring of difference operators )
                    118:    (with the macros define_ring, weight_vector and elimination_order.)
                    119:    (The user cannot use the variable names h, e, H and E.)
                    120:    (cf. show_ring, system_variable --- CurrentRing)
                    121:    (    print_switch_status, switch_function)
                    122:    (Example: [(x,y,z) ring_of_difference_operators (Ex,Ey) elimination_order 0] define_ring)
                    123:    (         Ex,Ey, and Ez are corresponding difference operators to the )
                    124:    (         space variables x, y and z ( Ex x = (x+1) Ex).)
                    125:  ]
                    126: ] putUsages
                    127:
                    128:
                    129: [(ring_of_q_difference_operators)
                    130:  [ (string ring_of_q_difference_operators)
                    131:    (  )
                    132:    (This command has not been maintained since 1996. So, there may be)
                    133:    (troubles if it is used with new features of kan/sm1.)
                    134:    (  )
                    135:    (This command is used to define a ring of q-difference operators )
                    136:    (with the macros define_qring, weight_vector and elimination_order.)
                    137:    (Note that you should use this macro with define_qring instead of)
                    138:    (define_ring.)
                    139:    (The user cannot use the variable names h, e, q and E.)
                    140:    (cf. show_ring, system_variable --- CurrentRing)
                    141:    (    print_switch_status, switch_function)
                    142:    (Example: [(x,y,z) ring_of_q_difference_operators (Qx,Qy) elimination_order 0] define_qring)
                    143:    (         Qx,Qy, and Qz are corresponding q-difference operators to the )
                    144:    (         space variables x, y and z ( Qx x = (q) x Q).)
                    145:  ]
                    146: ] putUsages
                    147:
                    148:
                    149: [(define_ring)
                    150:   [( [varlist ring_of_??? order characteristic options] define_ring)
                    151:    ( Pointer to the ring.)
                    152:    (Example: [(x,y,z) ring_of_polynomials [[(x) 100 (y) 10 (z) 1]] weight_vector)
                    153:    (          11] define_qring )
                    154:    (Example: [(x,y) ring_of_polynomials [[(x) 1]] weight_vector 0 ] define_ring)
                    155:    (         /R set)
                    156:    (cf. define_qring, set_up_ring@ <coefficient ring>)
                    157:    (    <<ring_of_???>> ring_of_polynomials, ring_of_differential_operators, )
                    158:    (    ring_of_difference_operators)
                    159:    (    <<order>> elimination_order, weight_vector)
                    160:    (    ring_def,ring , << ,, >>)
                    161:   ]
                    162: ] putUsages
                    163:
                    164:
                    165: [(.)
                    166:  [(string . polynomial)
                    167:   (Parse the string as a polynomial in the current ring and put it on the stack)
                    168:   (Example ( (x+2)^3 ) .)
                    169:  ]
                    170: ] putUsages
                    171:
                    172: [(evenQ)
                    173:  [ (number evenQ bool)
                    174:  ]
                    175: ] putUsages
                    176:
                    177: [(reverse)
                    178:  [ (array reverse reversed_array)
                    179:  ]
                    180: ] putUsages
                    181:
                    182: [(memberQ)
                    183:  [(element array(list) memberQ bool)
                    184:  ]
                    185: ] putUsages
                    186:
                    187: [(transpose)
                    188:  [( matrix transpose transposed_matrix)
                    189:  ]
                    190: ] putUsages
                    191:
                    192: [(timer)
                    193:  [( { codes } timer )
                    194:   (It outputs the execution time to execute << codes >>.)
                    195:   (If you type in ctrl-C while you are executing this macro,)
                    196:   (you need to type in set_timer after you type in ctrl-C to reset)
                    197:   (the timer.)
                    198: ]] putUsages
                    199:
                    200: [(complement)
                    201:  [( set universal_set complement complement_set)
                    202:   (Example: [1 2] [3 4 1 2 5] complement ::)
                    203:  ]
                    204: ] putUsages
                    205:
                    206: [(pushVariables)
                    207:  [ (varlist pushVariables pushed-variables)
                    208:    (The macro is used to define local variables in a macro.)
                    209:    (Example : /foo {                     )
                    210:    (           /arg1 set                 )
                    211:    (          [/abc /cd] pushVariables   )
                    212:    (          [ /abc arg1 def            )
                    213:    (            /cd abc 1 add def )
                    214:    (            /arg1 cd def )
                    215:    (          ] pop                      )
                    216:    (          popVariables)
                    217:    (          arg1  )
                    218:    (          } def )
                    219:    (  10 foo ::    returns 11 )
                    220:    (    In the example, abc and cd are local variables.)
                    221:  ]
                    222: ] putUsages
                    223:
                    224:
                    225:
                    226: /@@@.global.usage1
                    227:  [(@@@. is the prefix for the global control variables and global functions.)
                    228:   (@@@.quiet   :  1 ---> quiet mode,  0 ---> not. cf. sm1 -q)
                    229:   (@@@.esymbol : (e_) is the standard value. It is used to express)
                    230:   (              vectors internally. cf. fromVectors, toVectors)
                    231:   (@@@.Dsymbol :  (D) is the standard value for differential operator.)
                    232:   (                cf. ring_of_differential_operators)
                    233:   (@@@.diffEsymbol :  (E) is the standard value for difference operator.)
                    234:   (                cf. ring_of_difference_operators)
                    235:   (@@@.Qsymbol :  (Q) is the standard value for q-difference operator.)
                    236:   (                cf. ring_of_qdifference_operators)
                    237:  ]
                    238: def
                    239: [(@@@.quiet)  @@@.global.usage1] putUsages
                    240: [(@@@.Dsymbol)  @@@.global.usage1] putUsages
                    241: [(@@@.diffEsymbol)  @@@.global.usage1] putUsages
                    242: [(@@@.Qsymbol)  @@@.global.usage1] putUsages
                    243: [(@@@.esymbol)  @@@.global.usage1] putUsages
                    244:
                    245: [(join)
                    246:  [(list1 list2 join list3)
                    247:   (Ex.  [1 2] [3 [4 (ab)]] join  [1 2 3 [4 (ab)]])
                    248:  ]
                    249: ] putUsages
                    250:
                    251: [(not)
                    252:  [(int not int)
                    253:   (1 not 0)
                    254:   (0 not 1)
                    255:  ]
                    256: ] putUsages
                    257:
                    258: [(append)
                    259:  [(list1 obj2 append list3)
                    260:   (Ex.  [1 2]  3 append  [1 2 3])
                    261:  ]
                    262: ] putUsages
                    263:
                    264: [(null)
                    265:  [(<<null>> returns null object)]
                    266: ] putUsages
                    267:
                    268: [(oxasir)
                    269:  [(ox_asir is an asir server which is complient to open xxx protocol.)
                    270:   (This module is necessary for efficient execution factorization )
                    271:   (of b-functions in annfs, deRham.  cf. lib/oxasir.sm1)
                    272:   (ox_asir has not yet been put on the ftp cite. 12/17, 1998.)
                    273:  ]
                    274: ] putUsages
                    275:
                    276: [(toVectors)
                    277:  [(obj toVectors vec)
                    278:   (Convert the internal expression of vector into the array <<vec>>.)
                    279:   (obj can be  [n [g1 ... gm]] where n is the length of the vector.)
                    280:   $Example 1: [(x) ring_of_polynomials 0] define_ring  $
                    281:   $           (e_ + 2).  toVectors :: $
                    282:   (        --->  [2  , 1] )
                    283:   (Example 2: [3 (e_ +2).] toVectors ::)
                    284:   (        ---> [2 , 1 , 0 ])
                    285:   (Example 3: [(e_+2). (e_^2+1).] toVectors ::)
                    286:   (        ---> [[2 , 1] [1 , 0 , 1]] )
                    287:   (Example 4: [2 [(e x + 1). (x+1).]] toVectors )
                    288:   (           ===> [ [1 , x] [x+1 , 0] ] )
                    289: ]] putUsages
                    290: [(toVectors2)
                    291:  [(Remained for the compatibility. cf. toVectors)
                    292: ]] putUsages
                    293:

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