Home My Page Projects Code Snippets Project Openings diderot
Summary Activity Tracker Tasks SCM

SCM Repository

[diderot] Diff of /branches/vis15/src/compiler/gen/ir/mid-ir.spec
ViewVC logotype

Diff of /branches/vis15/src/compiler/gen/ir/mid-ir.spec

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 3508, Fri Dec 18 14:19:30 2015 UTC revision 4128, Thu Jun 30 23:19:13 2016 UTC
# Line 1  Line 1 
1  # specification of operators for MidIL version of the IR.  Each line (other than comments)  # specification of operators for MidIR version of the IR.  Each line (other than comments)
2  # specifies an operator using five fields, which are separated by ":".  The fields are  # specifies an operator using five fields, which are separated by ":".  The fields are
3  #       name  #       name
4  #       argument type           (optional)  #       argument type           (optional)
# Line 8  Line 8 
8  #  #
9  # Operations with effects are denoted by a "!" as the first character of the line.  # Operations with effects are denoted by a "!" as the first character of the line.
10  #  #
11  # type-indexed arithmetic operations  # integer operations
12  IAdd : : 1 : 2 : integer addition  IAdd : : 1 : 2 : integer addition
13  ISub : : 1 : 2 :  ISub : : 1 : 2 : integer subtraction
14  IMul : : 1 : 2 :  IMul : : 1 : 2 : integer multiplication
15  IDiv : : 1 : 2 :  IDiv : : 1 : 2 : integer division
16  IMod : : 1 : 2 : integer modulo  IMod : : 1 : 2 : integer modulo
17  INeg : : 1 : 1 :  INeg : : 1 : 1 : integer negation
18    #
19    # comparisons (integer and scalar)
20  LT : ty : 1 : 2 :  LT : ty : 1 : 2 :
21  LTE : ty : 1 : 2 :  LTE : ty : 1 : 2 :
22  EQ : ty : 1 : 2 :  EQ : ty : 1 : 2 :
# Line 25  Line 27 
27  Abs : ty : 1 : 1 :  Abs : ty : 1 : 1 :
28  Max : ty : 1 : 2 :  Max : ty : 1 : 2 :
29  Min : ty : 1 : 2 :  Min : ty : 1 : 2 :
30  # Clamp<ty>(lo, hi, x) -- clamps x to the range lo..hi  # Clamp<ty>(lo, hi, x) -- clamps tensor x to the range lo..hi, where lo and hi are scalars and x
31    # has type ty
32  Clamp : ty : 1 : 3 : clamp argument to range  Clamp : ty : 1 : 3 : clamp argument to range
33  # Lerp<ty>(a, b, t) -- computes a + t*(b-a)  # MapClamp<ty>(lo, hi, x) -- clamps x[alpha] to the range lo[alpha]..hi[alpha], where
34    # x, lo, and hi all have type ty (which is a non-scalar tensor type).
35    MapClamp : ty : 1 : 3 : clamp argument to range
36    # Lerp<ty>(a, b, t) -- computes a + t*(b-a), where a and b have type ty and t has type real
37  Lerp : ty : 1 : 3 : linear interpolation between 0 and 1  Lerp : ty : 1 : 3 : linear interpolation between 0 and 1
38  #  #
39  ### vector operations  ### tensor operations
40  # Normalize<n>(v)   -- returns the unit vector in direction u; n is the length ov u  #
41  Normalize : int : 1 : 1 :  # TensorIndex<ty,idxs>(T) returns the scalar T[idxs], where T has type ty
42  PrincipleEvec : ty : 1 : 2 : principle eigenvector; ty is result vector type  TensorIndex : ty * shape : 1 : 1 :
43    #
44    ### matrix operations
45    #
46  EigenVecs2x2 : : 1 : 1 : Eigen vectors and values for 2x2 matrix  EigenVecs2x2 : : 1 : 1 : Eigen vectors and values for 2x2 matrix
47  EigenVecs3x3 : : 1 : 1 : Eigen vectors and values for 3x3 matrix  EigenVecs3x3 : : 1 : 1 : Eigen vectors and values for 3x3 matrix
48  EigenVals2x2 : : 1 : 1 : Eigen values for 2x2 matrix  EigenVals2x2 : : 1 : 1 : Eigen values for 2x2 matrix
49  EigenVals3x3 : : 1 : 1 : Eigen values for 3x3 matrix  EigenVals3x3 : : 1 : 1 : Eigen values for 3x3 matrix
50  # Zero<ty>() -- zero tensor  # Zero<ty>() -- zero tensor
51  Zero : ty : 1 : 0 : identity matrix  Zero : ty : 1 : 0 : all zeros tensor
52  #  #
53  ### tuple operations  ### tuple operations
54  #  #
# Line 48  Line 57 
57  #  #
58  ### operations on sequences  ### operations on sequences
59  #  #
 # Index<ty,i>(u)  -- select ith element of sequence; ty is sequence type  
 Index : ty * int : 1 : 1 :  
60  # Subscript<ty>(u,i) -- select ith element of sequence; ty is type of sequence  # Subscript<ty>(u,i) -- select ith element of sequence; ty is type of sequence
61  Subscript : ty : 1 : 2 :  Subscript : ty : 1 : 2 :
62  # MkDynamic<ty,n> -- make a sequence with type ty[n] into a dynamic sequence  # MkDynamic<ty,n> -- make a sequence with type ty[n] into a dynamic sequence
63  !MkDynamic : ty * int : 1 : 1 : make a fixed-length sequence dynamic  !MkDynamic : ty * int : 1 : 1 : make a fixed-length sequence dynamic
64  !Append : ty : 2 : 1 : append an element onto a dynamic sequence  !Append : ty : 1 : 2 : append an element onto a dynamic sequence
65  !Prepend : ty : 2 : 1 : prepend an element onto a dynamic sequence  !Prepend : ty : 1 : 2 : prepend an element onto a dynamic sequence
66  !Concat : ty : 2 : 1 : concatenate two dynamic sequences  !Concat : ty : 1 : 2 : concatenate two dynamic sequences
67  # Range(lo,hi) -- create a sequence with values [lo, lo+1, ..., hi]  # Range(lo,hi) -- create a sequence with values [lo, lo+1, ..., hi]
68  Range : : 2 : 1 : create a range sequence  Range : : 1 : 2 : create a range sequence
69  # Length<ty> -- return the length of a sequence with type ty[]  # Length<ty> -- return the length of a sequence with type ty[]
70  Length : ty : 1 : 1 : return the length of a dynamic sequence  Length : ty : 1 : 1 : return the length of a dynamic sequence
71  #  #
72    # SphereQuery<posType,seqTy>(??)
73    SphereQuery : ty * ty : 1 : 2 : find strands within a sphere
74    #
75  # compute integral parts of reals  # compute integral parts of reals
76  Ceiling : int : 1 : 1 : compute real ceiling of a vector  Ceiling : int : 1 : 1 : compute real ceiling of a vector
77  Floor : int : 1 : 1 : compute real floor of a vector  Floor : int : 1 : 1 : compute real floor of a vector
# Line 70  Line 80 
80  #  #
81  ### conversions; the real to int forms are vector ops  ### conversions; the real to int forms are vector ops
82  IntToReal : : 1 : 1 :  IntToReal : : 1 : 1 :
83  RealToInt : int : 1 : 1 : cast real vector to int vector  RealToInt : int : 1 : 1 : cast reals to ints and vectors to int sequences
84    #
85    # reduction operations
86    R_All      : ty : 1 : 3 :
87    R_Exists   : ty : 1 : 3 :
88    R_Max      : ty : 1 : 3 :
89    R_Min      : ty : 1 : 3 :
90    R_Sum      : ty : 1 : 3 :
91    R_Product  : ty : 1 : 3 :
92    R_Mean     : ty : 1 : 3 :
93    R_Variance : ty : 1 : 4 :
94  #  #
95  ### image/kernel operations  ### image/kernel operations
96  #  #
97  Kernel     : Kernel.kernel * int  : 1 : 0 : Kernel<h, k>, where h is the kernel and k is level of differentiation  # BuildPos<s>(x) -- builds a vector of 2s kernel arguments at positions [x-s, .., x+(s-1)]
98  Transform : ImageInfo.info : 1 : 1 : Pulls transformation matrix from image.  BuildPos : int : 1 : 1 : compute vector of kernel arguments
99  Translate : ImageInfo.info : 1 : 1 : Pulls translation vector from image.  #
100    # EvalKernel<d,h,k>(u) -- computes h^(k)(u_i) for 1<i<d, where d is the size of vector u.
101    EvalKernel : int * Kernel.t * int : 1 : 1 : evaluate a kernel function application
102  #  #
103  # EvalKernel<i,h,k>(u) -- computes (D^k h)(u), where i is the size of vector u.  # Kernel<h,k>() -- represents the k'th derivative of the kernel h.
104  EvalKernel : int * Kernel.kernel * int : 1 : 1 : apply a kernel function to a scalar or vector of arguments  Kernel    : Kernel.t * int  : 1 : 0 :
105  #  #
106  # VoxelAddress<I,offset>(V, i, j, ...) -- compute the address of the voxel data indexed by i, j, ...  Transform  : ImageInfo.info : 1 : 1 : Pulls transformation matrix from image.
107  # for non-scalar images, the offset specifies which sample and I specifies the stride.  Translate  : ImageInfo.info : 1 : 1 : Pulls translation vector from image.
 VoxelAddress : ImageInfo.info * int : 1 : * : compute the address of a voxel  
 #  
 # VoxelAddressWithCtl<I,offset,ctl>(V, i, j, ...) -- compute the address of the voxel  
 # indexed by i, j, ... using the index control ctl. For non-scalar images, the offset  
 # specifies which sample and I specifies the stride.  
 VoxelAddressWithCtl : ImageInfo.info * int * idxctl : 1 : * : compute the address of a voxel  
108  #  #
109  # LoadVoxels<I,n>(a) -- load a vector of n voxels from the address a  # LoadVoxels<I,s>(V,n) -- loads a tensor of voxels from the image V, where I is the
110  LoadVoxels : ImageInfo.info * int : 1 : 1 : load a vector of voxel values from an address  # image info for V, s is size of the sample (i.e., twice the kernel support), and
111    # n is a sequence of integer indices that specifies the corner of the loaded tensor.
112    # If V has the type "image(d)[shp]", then n has type "int[n]" and the resulting tensor
113    # has the type "tensor[shp,s^d]".
114    LoadVoxels : ImageInfo.info * int : 1 : 2 : load a cube of voxels
115    #
116    # LoadVoxelsWithCtl<I,s,ctl>(V,n) -- like LoadVoxels, but it also uses the specified
117    # index control to deal with out-of-bounds indices.
118    LoadVoxelsWithCtl : ImageInfo.info * int * idxctl : 1 : 2 : load a cube of voxels
119  #  #
120  # Inside<I,s>(u,V) -- tests to see if image-space position u is inside the volume  # Inside<I,s>(n,V) -- tests to see if the index sequence n is inside the domain of V.
121  # occupied by the image V.  I is the image info and s is the border width  # I is the image info for V, s is the size of the sample to be loaded (see LoadVoxels)
122  Inside : ImageInfo.info * int : 1 : 2 :  Inside : ImageInfo.info * int : 1 : 2 :
123  #  #
124  # ImageDim<I,i>(V) -- returns the i'th dimension of the image  # ImageDim<I,i>(V) -- returns the i'th dimension of the image
125  ImageDim : ImageInfo.info * int : 1 : 1 :  ImageDim : ImageInfo.info * int : 1 : 1 :
126  #  #
127    # BorderCtlDefault<I>(V,t) -- wrap the image V with the border control that returns a default value t
128    BorderCtlDefault : ImageInfo.info : 1 : 2 :
129    # BorderCtlClamp<I>(V) -- wrap the image V with the border control that clamps the index
130    BorderCtlClamp : ImageInfo.info : 1 : 1 :
131    # BorderCtlMirror<I>(V) -- wrap the image V with the border control that mirrors the index
132    BorderCtlMirror : ImageInfo.info : 1 : 1 :
133    # BorderCtlWrap<I>(V) -- wrap the image V with the border control that wraps the index
134    BorderCtlWrap : ImageInfo.info : 1 : 1 :
135    #
136  # nrrd file loading  # nrrd file loading
137  LoadSeq   : ty * string : 1 : 0 : load sequence from nrrd file  LoadSeq   : ty * string : 1 : 0 : load sequence from nrrd file
138  LoadImage : ty * string : 1 : 0 : load image from nrrd file  LoadImage : ty * string : 1 : 0 : load image from nrrd file
139  #  #
140  # printing support for debugging  # printing support for debugging
141  !Print : tys : 0 : * : print strings  !Print : tys : 0 : * : print strings
142    #
143    # unlifted math functions
144    MathFn : MathFns.t : 1 : * : math function

Legend:
Removed from v.3508  
changed lines
  Added in v.4128

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0