 branches/purecfg/TODO 2011/04/14 15:54:24 824
+++ branches/purecfg/TODO 2011/04/25 15:49:00 966
@@ 1,31 +1,29 @@
+NOTE: GLK's approximate ranking of 6 most imporant tagged with
+[GLK:1], [GLK:2], ...
+
========================
SHORT TERM ============= (for curvaturebased VR)
========================
For RGB color output of 2D transfer function (indexed by
kappa1,kappa2), or for a 1D transfer function, will need
something akin to convolution on vector images

IL support for higherorder tensor values (matrices, etc).
tensor construction [DONE]
tensor indexing [DONE]
tensor slicing
 verify that hessians work correctly
+ verify that hessians work correctly [DONE]
Outer products [DONE]
Add M dot v, v dot M, and M dot N [DONE]
Identity matrix [DONE up to code generation]
+Identity matrix [DONE]
Zero tensor [DONE up to code generation]
+Zero tensor [DONE]
trace [DONE]
extend norm (exp) to tensor[3,3]
+extend norm (exp) to tensor[3,3] [DONE]
extend implementation of scaling to work on higherorder tensors (it currently
just works on vectors)
+Matrix addition, subtraction, and scaling [DONE]
Use ∇⊗ etc. syntax
syntax [DONE]
@@ 44,20 +42,19 @@
Infix "^" operator for pow() [DONE]
+Code generation support for 1D image data, such as RGBA transfer functions [DONE]
+
==============================
other SHORT TERM ============= (including needed for LIC)
==============================
determinant ("det") for tensor[3,3]

Decide if we want to allow redefinitions of variables
 (as in vrlitecam.diderot)

extend norm (exp) to all tensor types
+test/uninit.diderot:
+documents need for better compiler error messages when output variables
+are not initialized; the current messages are very cryptic
extend normalize to all tensor types
+determinant ("det") for tensor[3,3]
vector fields: convolution on vector images
+extend norm (exp) to all tensor types [DONE for vectors and matrices]
expand trace in mid to low translation
@@ 68,13 +65,54 @@
rgba = real{4}
==============================
MEDIUM TERM ================== (needed for streamlines & tractography)
+MEDIUM TERM ================== (including needed for streamlines & tractography)
==============================
+[GLK:3] evals & evecs for symmetric tensor[3,3] (requires sequences)
+
+[GLK:4] Save Diderot output to nrrd, instead of "mip.txt"
+ For grid of strands, save to similarlyshaped array
+ For list of strands, save to long 1D (or 2D for nonscalar output) list
+ For ragged things (like tractography output), will need to save both
+ complete list of values, as well as list of start indices and lengths
+ to index into complete list
+
+[GLK:5] Use of Teem's "hest" commandline parser for getting
+any input variables that are not defined in the source file
+
+[GLK:6] ability to declare a field in such a way so that probe
+positions are *always* clamped to the support of "inside";
+there are many cases where this is the sensible behavior.
+(More generally, we could also have "repeat" declaration,
+copying action of GL_REPEAT in texturing)
+
ability to emit/track/record variables into dynamically resized
runtime buffer
evals & evecs for symmetric tensor[3,3]
+Want: allow X *= Y, X /= Y, X += Y, X = Y to mean what they do in C,
+provided that X*Y, X/Y, X+Y, XY are already supported.
+Nearly every Diderot program would be simplified by this.
+
+Want: nontrivial field expressions & functions:
+ image(2)[2] Vimg = load(...);
+ field#0(2)[] Vlen = Vimg ⊛ bspln3;
+to get a scalar field of vector length, or
+ field#2(2)[] F = Fimg ⊛ bspln3;
+ field#0(2)[] Gmag = ∇F;
+to get a scalar field of gradient magnitude, or
+ field#2(2)[] F = Fimg ⊛ bspln3;
+ field#0(2)[] Gmsq = ∇F•∇F;
+to get a scalar field of squared gradient magnitude, which is simpler
+to differentiate. However, there is value in having these, even if
+the differentiation of them is not supported (hence the indication
+of "field#0" for these above)
+
+Want: ability to apply "normalize" to a field itself, e.g.
+ field#0(2)[2] V = normalize(Vimg ⊛ ctmr);
+so that V(x) = normalize((Vimg ⊛ ctmr)(x)).
+Having this would simplify expression of standard LIC method, and
+would also help express other vector field expressions that arise
+in vector field feature exraction.
tensor fields: convolution on general tensor images
@@ 93,19 +131,20 @@
proper handling of stabilize method
Add support for code like
+test/vrkcomp2.diderot: Add support for code like
(F1 if x else F2)@pos
This will require duplication of the continuation of the conditional (but we should only
duplicate over the liverange of the result of the conditional.
+This will require duplication of the continuation of the conditional
+(but we should only duplicate over the liverange of the result of the
+conditional.
==============================
other MEDIUM TERM ============
==============================
want: warnings when D (and likely I) is declared as a
variable name (now get confusing error messages now)
+want: warnings when "D" (reserved for differentiation) is declared as
+a variable name (get confusing error messages now)
support for Python interop and GUI
@@ 113,10 +152,11 @@
LONG TERM ====================
==============================
Better handling of variables that determines the scope of a variable based on its actual use,
instead of where the user defined it. So, for example, we should lift strandinvariant variables
to global scope. Also prune out useless variables, which should include field variables after the
translation to midil.
+Better handling of variables that determines the scope of a variable
+based on its actual use, instead of where the user defined it. So,
+for example, we should lift strandinvariant variables to global
+scope. Also prune out useless variables, which should include field
+variables after the translation to midil.
co vs contra index distinction
@@ 135,15 +175,27 @@
"tensor comprehension" (like list comprehension)
Python/ctypes interface to runtimez
+Python/ctypes interface to runtime
======================
BUGS =================
======================
test/mipcam.diderot:
 // generated C code looks like "(float)p_ui_00.5e0f"
 //real rayU = 2.0*camUmax*(real(ui)  0.5)/real(imgResU)  camUmax;
+[GLK:1] test/derivs2.diderot:
+test/derivs3.diderot:
+gradients & Hessians are not being transformed from indextoworld,
+these test programs should produce black images when that is working
+
+[GLK:2] test/fields.diderot:
+documents various bugs/questions associated with simple field expressions
+(negation, addition, scalar multiplication)
+
+test/read2vecs.diderot:
+// HEY (BUG?) shouldn't it be a type error to load this 2D array of
+// 2vectors into a 2D *scalar* field? Instead, get:
+// uncaught exception Fail [Fail: Error in compiling lic.diderot]
+// raised at driver/main.sml:31.3931.76
+image(2)[] Vimg = load("../data/vorttest.nrrd");
test/vrkcomp.diderot:
// HEY (scoping BUG): the strand parameters (e.g. ui, vi) ...
@@ 158,5 +210,3 @@
// uncaught exception Size [size]
// raised at ctarget/ctarget.sml:47.1547.19
//field#4(3)[] F = img ⊛ bspln5;

