Display Methods on HMesh2d

All display-methods on HMeshes offer the possibility of adaptive visualization with regard to various thresholds and error estimates which have to be provided by the user in a prescribed way or can also for example in case of lens-estimators be calculated by default-routines. See the example-HMesh-interfaces for further details. Without any error-estimates the HMesh is always drawn up to the level given by its level_of_interest entry, whereas with error-estimates some elements may be extracted on a higher hierarchy-level without losing essential detail-information but gaining a speedup because of this partial inspection of the mesh.

   

(HMESH2D *)GRAPE(hmesh, "display")()

HMESH2D *hmesh

The HMesh2d instance hmesh is rendered on the standard device in a default manner. In patch and texture mode the elements are displayed as flat shaded patches, in grid mode the edges of the elements are drawn. If geometry-estimators or lens-estimators are provided, these are used for adaptive visualization. An options-layer allows to activate/deactivate the lens-adaptivity.

   

(HMESH2D *)GRAPE(hmesh, "vect-disp")()

HMESH2D *hmesh

This method draws a 2d or 3d vector-valued function as arrow-field on the mesh. The mesh is drawn in a default manner, the arrows as flat arrows in 3d-space starting from points of a virtual equidistant grid put on the instance hmesh.

The options-layer shown in Figure 4 allows changing diplay-parameters.

  
Figure 4: Options Layer for HMesh2d-vect-disp

The ruler distance determines the z-shift of all arrows, the mesh-width is the distance between the arrows. Length gives a scale-factor which is applied to each function-value-vector. If the resulting length is bigger than the value max length, the vector is shortened to this value. If lens-estimators are provided, a lens can be activated/deactivated and a final ruler called lens factor allows to enlargen the mesh-width automatically in case of activated lens. An example is shown in figure 5.

  
Figure 5: example of "vect-disp"

   

(HMESH2D *)GRAPE(hmesh, "rgb-disp")()

HMESH2D *hmesh

This method draws vector-valued functions encoding the data in rgb-space. This is done by cutting the function-vectors componentwise to the unit-interval and taking these values as rgb-vector. Every element is patched with these colors in its vertices. A lens is automatically initialized based on the estimates generated by the method "calc-lenstimators". Grid-mode is not supported. An example is shown in Figure 6.

  
Figure 6: Example of "rgb-disp"

   

(HMESH2D *)GRAPE(hmesh, "shrink-disp")()

HMESH2D *hmesh

Similar to the standard display-method this one draws each element by a shrinked patch or shrinked polygon depending on grid-patch mode. The shrink-factor can be changed by a corresponding ruler. Additional a lens can be activated/deactivated. An example is shown in Figure 7.

  
Figure 7: example of "shrink-disp"

   

(HMESH2D *)GRAPE(hmesh, "geometry-graph-disp")()

HMESH2D *hmesh

Similar to the "isoline-disp" method, this method also draws isolines/isopatches on the hmesh. Instead of corresponding to the current function, these isolines belong to the z-coordinate-function of the hmesh. Thus real geometry-isolines are drawn. This method is faster than using the function-selector and choosing the function z-coordinate, which gives the same result. With the options-layer shown in Figure 8 a lens can be activated/deactivated, the display can be switched to a projection on the x/y-plane and the colorbar can be accessed. An example is shown in Figure 9.

  
Figure 10: Options Layer for HMesh2d-geometry-graph-disp

  
Figure 9: example of "geometry-graph-disp"

   

(HMESH2D *)GRAPE(hmesh, "function-graph-disp")()

HMESH2D *hmesh

This method draws the instance hmesh not as a plain mesh but the nodal z-coordinates are shifted by a multiple of the nodal function-values. The factor of this multiple can be changed as graph-height in the options-layer for this display-method shown in figure 10. A lens can be activated/deactivated if lens-estimators are supported in the instance hmesh. An example is shown in figure 11.

  
Figure: Options Layer for HMesh2d-geometry-graph-disp

  
Figure 11: example of "function-graph-disp"

       

(HMESH2D *)GRAPE(hmesh, "isoline-disp")()

(HMESH2D *)GRAPE(hmesh, "isoline-select-disp")()

HMESH2D *hmesh

These two display-methods draw isolines and iso-patches on the mesh. In grid-mode "isoline-disp" draws equidistant isolines with respect to the actual colorbar, that means line-distance, colors and min/max-values are taken from the colorbar. "isoline-select-disp" just draws selected isolines. In patch-mode iso-patches are drawn, the select-display version additionally draws the selected lines. The following figure shows the options-layer for this method in texture mode. In other modes some buttons/rulers are hidden, if they are not used.

  
Figure 12: Options Layer for HMesh2d-isoline-disp

In texture-mode   the surface of the mesh is patched with textures which are able to react on light-sources. This ability can be activated/deactivated by the button Texture with lightmodel. The button modus activates/deactivates the ruler graph-height and an additional extruding of the mesh in z-direction according to a multiple of the nodal function-values, the factor given by graph-height. The button hp disp activates the remaining two rulers Texel per Pixel and p-deg. This mode draws higher polynomial textures on each element. The polynomial degree and resolution of the textures are determined by these rulers. An example of this display-method is shown in Figure 13.

  
Figure 13: example of "isoline-disp"

   

(HMESH2D *)GRAPE(hmesh, "debug-disp")()

HMESH2D *hmesh

This method is a debug-tool for hmesh-interfaces. It displays the hmesh like the shrink-method and the element's boundaries by blue lines. Therefore the shrink-options-layer is shown. The traversal-functions of the hmesh-interface can now be called by pressing the corresponding buttons of the options-layer for this method shown in Figure 14.

  
Figure 14: Options Layer for HMesh2d-debug-disp

The resulting element and its parents-path to a macro-element is highlighted by white boundaries. Child-elements are shifted from their parents in z-direction according to the value of the ruler level-scale. Additional information is shown for the actual element by activating one of the buttons show indices, show coord's or show function-values. The drawing of the mesh can be enabled/disabled by the button show mesh. An example is shown in Figure 15.

  
Figure 15: example of "debug-disp"