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 3474, Wed Dec 2 18:26:40 2015 UTC revision 3775, Tue Apr 26 20:55:36 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  Add : ty : 1 : 2 :  IAdd : : 1 : 2 : integer addition
13  Sub : ty : 1 : 2 :  ISub : : 1 : 2 : integer subtraction
14  Mul : ty : 1 : 2 :  IMul : : 1 : 2 : integer multiplication
15  Div : ty : 1 : 2 :  IDiv : : 1 : 2 : integer division
16  Mod : : 1 : 2 : integer modulo  IMod : : 1 : 2 : integer modulo
17  Neg : ty : 1 : 1 :  INeg : : 1 : 1 : integer negation
18  Abs : ty : 1 : 1 :  #
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 23  Line 24 
24  GT : ty : 1 : 2 :  GT : ty : 1 : 2 :
25  GTE : ty : 1 : 2 :  GTE : ty : 1 : 2 :
26  Not : : 1 : 1 : boolean negation  Not : : 1 : 1 : boolean negation
27  Max : : 1 : 2 :  Abs : ty : 1 : 1 :
28  Min : : 1 : 2 :  Max : ty : 1 : 2 :
29    Min : ty : 1 : 2 :
30  # Clamp<ty>(lo, hi, x) -- clamps x to the range lo..hi  # Clamp<ty>(lo, hi, x) -- clamps x to the range lo..hi
31  Clamp : ty : 1 : 3 : clamp argument to range  Clamp : ty : 1 : 3 : clamp argument to range
32  # Lerp<ty>(a, b, t) -- computes a + t*(b-a)  # Lerp<ty>(a, b, t) -- computes a + t*(b-a)
33  Lerp : ty : 1 : 3 : linear interpolation between 0 and 1  Lerp : ty : 1 : 3 : linear interpolation between 0 and 1
34  #  #
35  ### vector operations  ### matrix operations
36  # Dot<n>(u, v)  -- computes dot product of u and v; n specifies u and v's arity  #
 Dot : int : 1 : 2 :  
 # MulVecMat<m,n>(v, M) -- computes v*M, where M is an mxn-matrix and v is an m-vector  
 MulVecMat : int * int : 1 : 2 : vector times matrix multiplication  
 # MulMatVec<m,n>(M, v) -- computes M*v, where M is an mxn-matrix and v is a n-vector  
 MulMatVec : int * int : 1 : 2 : matrix times vector multiplication (type is matrix type)  
 # MulMatMat<m,n,p>(M, N) -- computes M*N, where M is an mxn-matrix and N is an nxp-matrix  
 MulMatMat : int * int * int : 1 : 2 : matrix times matrix multiplication  
 # MulVecTen3<m,n,p>(v, T) -- computes v*T, where T is an mxnxp-tensor and v is an m-vector  
 MulVecTen3 : int * int * int : 1 : 2 : vector times 3rd-order tensor multiplication  
 # MulTen3Vec<m,n,p>(v, T) -- computes T*v, where T is an mxnxp-tensor and v is a p-vector  
 MulTen3Vec : int * int * int : 1 : 2 : 3rd-order tensor times vector multiplication  
 # ColonMul<ty1,ty2>(T1, T2) -- computes T1:T2, where T1 (resp. T2) has type ty1 (resp. ty2)  
 ColonMul : ty * ty : 1 : 2 : colon product  
 # Cross(u, v)   -- computes cross product of u and v  
 Cross : : 1 : 2 :  
 # Norm<ty>(x) -- returns the norm of the tensor x, which has type ty  
 Norm : ty : 1 : 1 :  
 # Normalize<n>(v)   -- returns the unit vector in direction u; n is the length ov u  
 Normalize : int : 1 : 1 :  
 # Scale<ty>(s,u) -- multiply scalar s time tensor u; ty specifies u's type  
 Scale : ty : 1 : 2 : scalar*tensor multiplication  
 PrincipleEvec : ty : 1 : 2 : principle eigenvector; ty is result vector type  
37  EigenVecs2x2 : : 1 : 1 : Eigen vectors and values for 2x2 matrix  EigenVecs2x2 : : 1 : 1 : Eigen vectors and values for 2x2 matrix
38  EigenVecs3x3 : : 1 : 1 : Eigen vectors and values for 3x3 matrix  EigenVecs3x3 : : 1 : 1 : Eigen vectors and values for 3x3 matrix
39  EigenVals2x2 : : 1 : 1 : Eigen values for 2x2 matrix  EigenVals2x2 : : 1 : 1 : Eigen values for 2x2 matrix
40  EigenVals3x3 : : 1 : 1 : Eigen values for 3x3 matrix  EigenVals3x3 : : 1 : 1 : Eigen values for 3x3 matrix
 # Identity<n>() -- nxn identity matrix  
 Identity : int : 1 : 0 : identity matrix  
41  # Zero<ty>() -- zero tensor  # Zero<ty>() -- zero tensor
42  Zero : ty : 1 : 0 : identity matrix  Zero : ty : 1 : 0 : all zeros tensor
43  # Trace<n>(M) -- computes trace of nxn matrix M  #
44  Trace : int : 1 : 1 : compute trace of matrix  ### tuple operations
 # Transpose<n,m>(M) -- computes transpose of nxm matrix  
 Transpose : int * int : 1 : 1 : compute transpose of matrix  
 Slice : ty * mask : 1 : 1 : tensor slice; type is tensor argument type  
45  #  #
 # operations on sequences  
46  # Select<ty,i>(u)  -- select ith element of tuple; ty is tuple type  # Select<ty,i>(u)  -- select ith element of tuple; ty is tuple type
47  Select : ty * int : 1 : 1 :  Select : ty * int : 1 : 1 :
48  # Index<ty,i>(u)  -- select ith element of sequence; ty is sequence type  #
49    ### operations on sequences
50    #
51    # Index<ty,i>(u)  -- select ith element of tensor; ty is sequence type
52  Index : ty * int : 1 : 1 :  Index : ty * int : 1 : 1 :
53  # 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
54  Subscript : ty : 1 : 2 :  Subscript : ty : 1 : 2 :
55  # 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
56  !MkDynamic : ty * int : 1 : 1 : make a fixed-length sequence dynamic  !MkDynamic : ty * int : 1 : 1 : make a fixed-length sequence dynamic
57  !Append : ty : 2 : 1 : append an element onto a dynamic sequence  !Append : ty : 2 : 1 : append an element onto a dynamic sequence
58  !Prepend : ty : 2 : 1 : prepend an element onto a dynamic sequence  !Prepend : ty : 2 : 1 : prepend an element onto a dynamic sequence
59  !Concat : ty : 2 : 1 : concatenate two dynamic sequences  !Concat : ty : 2 : 1 : concatenate two dynamic sequences
60  # Length<ty> -- return the length of a sequence with type ty{}  # Range(lo,hi) -- create a sequence with values [lo, lo+1, ..., hi]
61    Range : : 2 : 1 : create a range sequence
62    # Length<ty> -- return the length of a sequence with type ty[]
63  Length : ty : 1 : 1 : return the length of a dynamic sequence  Length : ty : 1 : 1 : return the length of a dynamic sequence
64  #  #
65    # SphereQuery<posType,seqTy>(??)
66    SphereQuery : ty * ty : 1 : 2 : find strands within a sphere
67    #
68  # compute integral parts of reals  # compute integral parts of reals
69  Ceiling : int : 1 : 1 : compute real ceiling of a vector  Ceiling : int : 1 : 1 : compute real ceiling of a vector
70  Floor : int : 1 : 1 : compute real floor of a vector  Floor : int : 1 : 1 : compute real floor of a vector
# Line 93  Line 75 
75  IntToReal : : 1 : 1 :  IntToReal : : 1 : 1 :
76  RealToInt : int : 1 : 1 : cast real vector to int vector  RealToInt : int : 1 : 1 : cast real vector to int vector
77  #  #
78  ### image/kernel operations  # reduction operations
79  #  R_All      : ty : 1 : 3 :
80  # VoxelAddress<I,offset>(V, i, j, ...) -- compute the address of the voxel data indexed by i, j, ...  R_Exists   : ty : 1 : 3 :
81  # for non-scalar images, the offset specifies which sample and I specifies the stride.  R_Max      : ty : 1 : 3 :
82  VoxelAddress : ImageInfo.info * int : 1 : * : compute the address of a voxel  R_Min      : ty : 1 : 3 :
83    R_Sum      : ty : 1 : 3 :
84    R_Product  : ty : 1 : 3 :
85    R_Mean     : ty : 1 : 3 :
86    R_Variance : ty : 1 : 4 :
87  #  #
88  # VoxelAddressWithCtl<I,offset,ctl>(V, i, j, ...) -- compute the address of the voxel  ### image/kernel operations
 # 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  
89  #  #
90  # LoadVoxels<I,n>(a) -- load a vector of n voxels from the address a  # BuildPos<s>(x) -- builds a vector of 2s kernel arguments at positions [x-s, .., x+(s-1)]
91  LoadVoxels : ImageInfo.info * int : 1 : 1 : load a vector of voxel values from an address  BuildPos : int : 1 : 1 : compute vector of kernel arguments
92  #  #
93  # PosToImgSpace<I>(V,u) -- transforms the world-space position u into the image-space specified by V.  # EvalKernel<d,h,k>(u) -- computes h^(k)(u_i) for 1<i<d, where d is the size of vector u.
94  PosToImgSpace : ImageInfo.info : 1 : 2 : transform a world-space position to image-space  EvalKernel : int * Kernel.kernel * int : 1 : 1 : evaluate a kernel function application
95  #  #
96  # TensorToWorldSpace<I,ty>(V,u) -- transforms the image-space tensor u to from V's image space to world space  # Kernel<h,k>() -- represents the k'th derivative of the kernel h.
97  TensorToWorldSpace : ImageInfo.info * ty : 1 : 2 : transform an image-space gradient to world-space  Kernel    : Kernel.kernel * int  : 1 : 0 :
98  #  #
99  # EvalKernel<i,h,k>(u) -- computes (D^k h)(u), where i is the size of vector u.  Transform  : ImageInfo.info : 1 : 1 : Pulls transformation matrix from image.
100  EvalKernel : int * Kernel.kernel * int : 1 : 1 : apply a kernel function to a scalar or vector of arguments  Translate  : ImageInfo.info : 1 : 1 : Pulls translation vector from image.
101    #
102    # LoadVoxels<I,s>(V,n) -- loads a tensor of voxels from the image V, where I is the
103    # image info for V, s is size of the sample (i.e., twice the kernel support), and
104    # n is a sequence of integer indices that specifies the corner of the loaded tensor.
105    # If V has the type "image(d)[shp]", then n has type "int[n]" and the resulting tensor
106    # has the type "tensor[shp,s^d]".
107    LoadVoxels : ImageInfo.info * int : 1 : 2 : load a cube of voxels
108    #
109    # LoadVoxelsWithCtl<I,s,ctl>(V,n) -- like LoadVoxels, but it also uses the specified
110    # index control to deal with out-of-bounds indices.
111    LoadVoxelsWithCtl : ImageInfo.info * int * idxctl : 1 : 2 : load a cube of voxels
112  #  #
113  # 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.
114  # 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)
115  Inside : ImageInfo.info * int : 1 : 2 :  Inside : ImageInfo.info * int : 1 : 2 :
116  #  #
117  # ImageDim<I,i>(V) -- returns the i'th dimension of the image  # ImageDim<I,i>(V) -- returns the i'th dimension of the image
118  ImageDim : ImageInfo.info * int : 1 : 1 :  ImageDim : ImageInfo.info * int : 1 : 1 :
119  #  #
120    # BorderCtlDefault<I>(V,t) -- wrap the image V with the border control that returns a default value t
121    BorderCtlDefault : ImageInfo.info : 1 : 2 :
122    # BorderCtlClamp<I>(V) -- wrap the image V with the border control that clamps the index
123    BorderCtlClamp : ImageInfo.info : 1 : 1 :
124    # BorderCtlMirror<I>(V) -- wrap the image V with the border control that mirrors the index
125    BorderCtlMirror : ImageInfo.info : 1 : 1 :
126    # BorderCtlWrap<I>(V) -- wrap the image V with the border control that wraps the index
127    BorderCtlWrap : ImageInfo.info : 1 : 1 :
128    #
129  # nrrd file loading  # nrrd file loading
130  LoadSeq   : ty * string : 1 : 0 : load sequence from nrrd file  LoadSeq   : ty * string : 1 : 0 : load sequence from nrrd file
131  LoadImage : ty * string : 1 : 0 : load image from nrrd file  LoadImage : ty * string : 1 : 0 : load image from nrrd file
132  #  #
 # inputs  
 !Input            : input : 0 : 0 : program input  
 !InputWithDefault : input : 0 : 1 : program input with default value as argument  
 #  
133  # printing support for debugging  # printing support for debugging
134  !Print : tys : 0 : * : print strings  !Print : tys : 0 : * : print strings
135    #
136    # unlifted math functions
137    MathFn : MathFns.t : 1 : * : math function

Legend:
Removed from v.3474  
changed lines
  Added in v.3775

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