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

SCM Repository

[diderot] Annotation of /tests/examples/fs3d/README.md
ViewVC logotype

Annotation of /tests/examples/fs3d/README.md

Parent Directory Parent Directory | Revision Log Revision Log


Revision 4640 - (view) (download)

1 : glk 4640 ## fs3d-scl.diderot: function sampler, 3D scalar synthetic fields
2 :    
3 :     `fs3d-scl.diderot` is based on [`fs2d-scl.diderot`](../fs2d); some
4 :     copy-and-pasting was involved. Like that program, the value of this
5 :     is not so much as a model of what a good or typical Diderot program
6 :     looks like, but as a utility for generating datasets for other Diderot
7 :     programs to work on. This same directory has a `fs3d-vec.diderot` for
8 :     generating vector fields, and possibly other programs; the
9 :     documentation below is for `fs3d-scl.diderot` though the other
10 :     programs will have very similar structure and usage.
11 :    
12 :     This programs generates synthetic scalar 3D data on regular grids that
13 :     are located and oriented in world space. The input arguments here
14 :     make it easy to sample the same underlying function on different
15 :     grids. Grid orientation is specified by the angle and axis of
16 :     rotation.
17 :    
18 :     Assuming the directions at https://github.com/Diderot-Language/examples
19 :     this program can be compiled with:
20 :    
21 :     ../../vis12/bin/diderotc --exec fs3d-scl.diderot
22 :    
23 :     The `-which` option will determine which function is sampled; look for
24 :     `(0 == which)` in the code to see the start of the function
25 :     definitions, this includes 3D functions used to make datasets for
26 :     [some](http://people.cs.uchicago.edu/~glk/pubs/#VIS-2003)
27 :     [previous](http://people.cs.uchicago.edu/~glk/pubs/#VIS-2009)
28 :     [papers](http://people.cs.uchicago.edu/~glk/pubs/#VIS-2014).
29 :    
30 :     This program is unusual in that its printed output needs to be captured
31 :     in order to have a NRRD header that records the orientation of the
32 :     sampling grid, so using the program involves redirection. To
33 :     get a self-contained parab.nrrd containing a parabola function
34 :    
35 :     ./fs2d-scl -which 3 | unu save -f nrrd -o parab.nrrd
36 :     rm out.nrrd
37 :    
38 :     Note that like in [`fs2d-scl.diderot`](../fs2d), the NRRD header
39 :     generated by this program assumes:
40 :    
41 :     1. This program was not compiled with `--double`
42 :     2. The program is running on a little-endian machine.
43 :    

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