New description of coloring.
authorIsaac Dooley <idooley2@illinois.edu>
Thu, 21 Feb 2008 22:17:08 +0000 (22:17 +0000)
committerIsaac Dooley <idooley2@illinois.edu>
Thu, 21 Feb 2008 22:17:08 +0000 (22:17 +0000)
doc/projections/manual.tex

index f4a4ee357e2b690468c77013800d2ff0d6a849c9..0f5a5057880653dc96a0f41fe443e10912c01bb4 100644 (file)
@@ -838,7 +838,7 @@ The following menu options are available:
 \item {\bf Tools} contains 1 option: {\it Modify Ranges} opens the initial 
 dialog box thereby allowing you to select new set of processors or time duration
 parameters.
-\item {\bf Colors} contains 4 options: {\it Change Colors} functions in
+\item {\bf Colors} contains options for loading, using, and modifying color schemes. {\it Change Colors} functions in
 a manner similar to the button of the same name described under control 
 panel information below. {\it Save Colors} allows you to save the current
 color set to a file named ``color.map'' into the same directory where your
@@ -849,6 +849,9 @@ load any previously saved color sets described above. {\it Default Colors}
 resets the current color set to the default set that \projections{} assigns
 without user intervention.
 
+Other color schemes are provided that can be used for some applications. The colors set as described above are the default coloring scheme. Other options for coloring the events are by event id (chare array index), user supplied parameter, or memory usage. In order to color by a user supplied parameter such as timestep, the C function  \texttt{traceUserSuppliedData(int value);} should be called within some entry methods. If such a method is called in an entry method, the entry method invocation can be colored by the parameter. The user supplied data can also be viewed in the tooltip that appears when the cursor hovers over an entry method invocation in the window. To color by memory usage, the C function \texttt{traceMemoryUsage();} should be called in all entry methods. The call records the current memory usage. Red indicates high memory usage, and green indicates low memory usage. The actual memory usage can also be viewed in the tooltips that appear when the cursor is over an event. The memory usage is only available in when using a Charm++ version that uses gnu memory.
+
+
 \item {\bf Screenshot} contains 1 option: 
 {\it Save as JPG or PNG} save the visible portion of the visualization
 to an image file. You must choose a filename ending with a \texttt{.png}