WxNviz: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
m (remove hardcoded version specific urls, use latest version)
 
(25 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Back to [[WxPython-based GUI for GRASS|wxGUI]] page.
''(Back to [[WxPython-based GUI for GRASS|wxGUI]] page.)''


See also {{cmd|wxGUI.Nviz|version=70}} manual page.
'''wxNviz''' is a [[wxGUI]] extension which allows users to realistically render multiple surfaces (raster data) in a 3D space, optionally using thematic coloring, draping 2D vector data over the surfaces, displaying 3D vector data in the space, and visualization of volume data (3D raster data).
 
For usage instructions, see also the {{cmd|wxGUI.nviz|desc=manual page}}.


'''wxNviz''' is a [[wxGUI]] extension which allows users to realistically render multiple surfaces (raster data) in a 3D space, optionally using thematic coloring, draping 2D vector data over the surfaces, displaying 3D vector data in the space, and visualization of volume data (3D raster data).
__TOC__
__TOC__
== Screenshots ==
== Screenshots ==
<center>
<center>
{|
<gallery perrow=3 widths=200>
|-
Image:Wxnviz-alpha-0.png|2008-06-27: Display raster map from layer tree in 2.5D (surface)
| [[Image:Wxnviz-alpha-0.png|250px|thumb|2008-06-27: Display raster map from layer tree in 2.5D (surface)]] ||
Image:Wxnviz-alpha-1.png|2008-07-05: Support for vector data (2D lines) added
[[Image:Wxnviz-alpha-1.png|250px|thumb|2008-07-05: Support for vector data (2D lines) added]]
Image:Wxnviz-alpha-2.png|2008-07-26: Support for vector point data
|-
Image:Wxnviz-alpha-3.png|2008-08-02: 3D vector data support
| [[Image:Wxnviz-alpha-2.png|250px|thumb|2008-07-26: Support for vector point data]] ||
Image:Wxnviz-alpha-4.png|2008-08-09: Initial support for volumetric data
[[Image:Wxnviz-alpha-3.png|250px|thumb|2008-08-02: 3D vector data support]]
Image:Wxnviz-lmgr.png|2010-05-31: 3D view tools window integrated into Layer Manager
|-
Image:Wxnviz-light.png|Lighting control panel in Layer Manager (2010-06-17)
| [[Image:Wxnviz-alpha-4.png|250px|thumb|2008-08-09: Initial support for volumetric data]] ||
Image:Wxnviz-fringe.png|Fringe control panel in Layer Manager (2010-06-23)
[[Image:Wxnviz-lmgr.png|250px|thumb|2010-05-31: 3D view tools window integrated into Layer Manager]]
Image:Wxnviz-redirect.png|Redirect messages to wxGUI (2010-08-08)
|-
Image:Wxnviz-volumes.png|Displaying raster (surface), 2D vector and 3D raster (volume) in the 3D space (2010-08-16)
| [[Image:Wxnviz-light.png|250px|thumb|center|Lighting control panel in Layer Manager (2010-06-17)]] ||
Image:WxNviz surface page.png|Surface page of WxNviz modified (2011-06-02)
[[Image:Wxnviz-fringe.png|250px|thumb|center|Fringe control panel in Layer Manager (2010-06-23)]]
Image:WxNviz_constant_surface_page.png|Constant surface page added (2011-06-02)
|-
Image:WxNviz_lighting.png|Lighting fixed (2011-05-02)
| [[Image:Wxnviz-redirect.png|250px|thumb|center|Redirect messages to wxGUI (2010-08-08)]] ||
Image:WxNviz_cutting_planes_1.png|Cutting planes (shading blend) (2011-06-10)
[[Image:Wxnviz-volumes.png|250px|thumb|center|Displaying raster (surface), 2D vector and 3D raster (volume) in the 3D space (2010-08-16)]]
Image:WxNviz_cutting_planes_2.png|Cutting planes (shading top color) (2011-06-10)
|}
Image:WxNviz_view_page.png|View page modified (2011-06-10)
Image:Nviz_cmd_cutting_planes.png‎|Picture of surfaces cut by two planes (generated by nviz_cmd) (2011-06-30)
Image:WxNviz_generate_command.png‎|Command for nviz_cmd generated by wxNviz (2011-07-01)
Image:WxNviz_north_arrow.png‎|North Arrow implemented (2011-07-08)
Image:WxNviz_volumes.png‎|Colored isosurfaces with transparency (2011-07-08)
Image:WxNviz_volume_slices_1.png‎|Partially transparent slice (2011-07-14)
Image:WxNviz_volume_slices_2.png‎|Combination of slices and isosurface (2011-07-14)
Image:WxNviz_overlays.png‎|Raster legend, text label and north arrow (2011-07-22)
Image:WxNviz_thematic_points_colors‎.png|Thematic mapping (colors) for points (2011-08-05)
Image:WxNviz_colorrules_dialog.png|Dialog for {{cmd|v.colors}} opened from 3D view (2011-08-05)
</gallery>
</center>
</center>
== Animations ==
{{YouTube|AByFPKHvgu4|desc=Using fly-through mode for creating animation}}
== Video tutorials ==


== HowTo ==
{{YouTube|ib1-mBbWkv4|desc=Loading data, settings layer properties}}
{{YouTube|ZLDstyumxv0|desc=Visualizing fringes and north arrow}}
{{YouTube|CmK-fEyf2SY|desc=3D raster maps (volumes) in the space (isosurface and slice mode)}}
{{YouTube|13wj5KWEweE|desc=Color thematic mapping}}
 
=== Older tutorials (2010) ===


{{YouTube|Ej_rBc9sgvE|desc=Loading data, settings layer properties}}
{{YouTube|Ej_rBc9sgvE|desc=Loading data, settings layer properties}}
Line 36: Line 56:
* Fog support (see [http://gpwiki.org/index.php/OpenGL:Tutorials:Tutorial_Framework:Light_and_Fog], [http://www.swiftless.com/tutorials/opengl/fog.html], [http://nehe.gamedev.net/data/lessons/lesson.asp?lesson=16])
* Fog support (see [http://gpwiki.org/index.php/OpenGL:Tutorials:Tutorial_Framework:Light_and_Fog], [http://www.swiftless.com/tutorials/opengl/fog.html], [http://nehe.gamedev.net/data/lessons/lesson.asp?lesson=16])
* Vertical labels (take from geonames.org point data): like in http://tev.fbk.eu/marmota/blog/?p=82
* Vertical labels (take from geonames.org point data): like in http://tev.fbk.eu/marmota/blog/?p=82
* Second interactive light source for isosurface visualization
* Tick marks and coordinate values to x,y,z axis when drawing fringe
<strike></strike>
== Troubleshooting  ==
* Nothing is rendered at all:
: Please note that with wxGTK port of wxPython (Linux systems), a problem might appear during wxNviz initialization (nothing is rendered at all) or when rendering vectors (bad order of rendering surfaces and vectors). If you encounter such problems, try to change a depth buffer number in wxGUI Menu > Settings > Preferences > Map Display > Advanced (possible numbers are 0, 16, 24, 32). It is currently not possible to automatically find out the right number which is working for your computer.
== Known issues  ==
#List of [http://trac.osgeo.org/grass/query?status=assigned&status=new&status=reopened&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=milestone&keywords=~wxNviz open] and [http://trac.osgeo.org/grass/query?status=assigned&status=closed&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=milestone&keywords=~wxNviz closed] tickets
#<strike>Adding vector data crashes wxGUI on Mac</strike>
#<strike>Viewing height sometimes sets to 1 after switching to 2D and back to 3D View (or with the simultaneous 2D view - very nice feature) and even after View is reset, it keeps getting back at 1 each time the slider is touched</strike>
#:Fixed in {{rev|46208}}
#Adding draw, draw current and clear button may be useful
#Thematic mapping is available in GRASS 7 only
#Display region in 3D does not change accordingly to display region in 2D in version &lt;= 6.5
#Appearance:
##&nbsp;I&nbsp;<strike>need to click View tab to get the arrow draw, same for the scale bar </strike>
##add legend &gt; OK: nothing gets drawn in 3D but the legend shows up when I switch to 2D but when I clicked delete scalebar (which was not drawn), my surface disapeared but the legend showed up along with white and black background (which I assume was supposed to be transparent, because when I moved the legend the surface was under it - we already discussed this, it may be my problem, because it works for Michael).
#General
##<strike>when I go from 3D view to 2D and then back to 3D I lose most of my settings&nbsp;</strike>
##<strike>similarly, when I add volume to Map layers I lose my view settings and the 3D view goes back to default </strike>
#Volumes:
##change of region by g.region seems to be ignored (or I missed something), I had to restart GRASS with the new region to get the 3D region for volumes right. Given that the default top, botom is 1,0, if GRASS starts with the default 3D region settings volumes do not work because there is just one level.
##<strike>isosurfaces work with my terrestrial lidar data but the slices don't, it seems that it is due my resolution being 0.3m, when I change it to 1m I get at least some limited slicing
###this may be in ogsf becuase slices in nviz do not work with this data either </strike>
#<strike>changing color to constant did not change the color of the isosurface</strike>


== Known issues ==
== Comparison of Tcl/Tk nviz and wxNviz functionality ==
What is missing in wxNviz:
* scaled difference
* lighting - follow surface viewpoint
* keyframe animation
* text rendering (in OpenGl)


# List of [http://trac.osgeo.org/grass/query?status=assigned&status=new&status=reopened&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=milestone&keywords=~wxNviz open] and [http://trac.osgeo.org/grass/query?status=assigned&status=closed&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=milestone&keywords=~wxNviz closed] tickets
What is working only partially:
# Light settings do not work on Mac
* legend, labels
# Adding vector data crashes wxGUI on Mac
* thematic mapping - nviz allows to choose also icon and multiple classification
# Rendering at fine resolution works only when changing viewing position or clicking the buttons that increase the numbers for perspective, twist, height and z-exag. Moving sliders does the required change but there is no redraw to full resolution
* basic support of animations
# Viewing height sometimes sets to 1 after switching to 2D and back to 3D View (or with the simultaneous 2D view - very nice feature) and even after View is reset, it keeps getting back at 1 each time the slider is touched
#:Hopefully fixed in {{rev|46208}}
# Typing in the height or z-exag numbers and ENTER does not do anything but the typed number gets accepted after clicking on the increase/decrease button, it is not possible to set the height value beyond the initial maximum
# Adding fringe just flashes it but it does not stay
# Isosurfaces tested with Nags Head time series data (I will provide link) don't seem to be working, after setting 3D region and adding 3D raster nothing gets drawn, when moving the related DEM around only line rectangle shows instead of a box.
# Adding draw, draw current and clear button may be useful


==Missing features==
What is new in wxNviz:
* it is possible to change view more interactively using mouse
 
Notes:
* Scripting functionality is replaced by m.nviz.image module
* wxNviz state is saved in workspace


* cutting planes for multiple surfaces
* 3D points with multiple attributes


== Google Summer of Code ==
== Google Summer of Code ==
Line 67: Line 119:
=== [[wxNviz GSoC 2011|2011]] ===
=== [[wxNviz GSoC 2011|2011]] ===


* [http://trac.osgeo.org/grass/wiki/SoCProjects#wxNvizdevelopmentforenhanced34Dvisualizationandanalysis Accepted Google Summer of Code 2011 project]
* [http://trac.osgeo.org/grass/wiki/SoCProjects#CompletionofwxGUINvizextensionfor3DdatavisualizationinGRASSGIS Accepted Google Summer of Code 2011 project]


== See also ==
== See also ==
Line 74: Line 126:


{{WxGUI}}
{{WxGUI}}
[[Category:NVIZ]]
[[Category:Visualization]]

Latest revision as of 10:56, 4 December 2018

(Back to wxGUI page.)

wxNviz is a wxGUI extension which allows users to realistically render multiple surfaces (raster data) in a 3D space, optionally using thematic coloring, draping 2D vector data over the surfaces, displaying 3D vector data in the space, and visualization of volume data (3D raster data).

For usage instructions, see also the manual page.

Screenshots

  • 2008-06-27: Display raster map from layer tree in 2.5D (surface)

    2008-06-27: Display raster map from layer tree in 2.5D (surface)

  • 2008-07-05: Support for vector data (2D lines) added

    2008-07-05: Support for vector data (2D lines) added

  • 2008-07-26: Support for vector point data

    2008-07-26: Support for vector point data

  • 2008-08-02: 3D vector data support

    2008-08-02: 3D vector data support

  • 2008-08-09: Initial support for volumetric data

    2008-08-09: Initial support for volumetric data

  • 2010-05-31: 3D view tools window integrated into Layer Manager

    2010-05-31: 3D view tools window integrated into Layer Manager

  • Lighting control panel in Layer Manager (2010-06-17)

    Lighting control panel in Layer Manager (2010-06-17)

  • Fringe control panel in Layer Manager (2010-06-23)

    Fringe control panel in Layer Manager (2010-06-23)

  • Redirect messages to wxGUI (2010-08-08)

    Redirect messages to wxGUI (2010-08-08)

  • Displaying raster (surface), 2D vector and 3D raster (volume) in the 3D space (2010-08-16)

    Displaying raster (surface), 2D vector and 3D raster (volume) in the 3D space (2010-08-16)

  • Surface page of WxNviz modified (2011-06-02)

    Surface page of WxNviz modified (2011-06-02)

  • Constant surface page added (2011-06-02)

    Constant surface page added (2011-06-02)

  • Lighting fixed (2011-05-02)

    Lighting fixed (2011-05-02)

  • Cutting planes (shading blend) (2011-06-10)

    Cutting planes (shading blend) (2011-06-10)

  • Cutting planes (shading top color) (2011-06-10)

    Cutting planes (shading top color) (2011-06-10)

  • View page modified (2011-06-10)

    View page modified (2011-06-10)

  • Picture of surfaces cut by two planes (generated by nviz_cmd) (2011-06-30)

    Picture of surfaces cut by two planes (generated by nviz_cmd) (2011-06-30)

  • Command for nviz_cmd generated by wxNviz (2011-07-01)

    Command for nviz_cmd generated by wxNviz (2011-07-01)

  • North Arrow implemented (2011-07-08)

    North Arrow implemented (2011-07-08)

  • Colored isosurfaces with transparency (2011-07-08)

    Colored isosurfaces with transparency (2011-07-08)

  • Partially transparent slice (2011-07-14)

    Partially transparent slice (2011-07-14)

  • Combination of slices and isosurface (2011-07-14)

    Combination of slices and isosurface (2011-07-14)

  • Raster legend, text label and north arrow (2011-07-22)

    Raster legend, text label and north arrow (2011-07-22)

  • Thematic mapping (colors) for points (2011-08-05)

    Thematic mapping (colors) for points (2011-08-05)

  • Dialog for v.colors opened from 3D view (2011-08-05)

    Dialog for v.colors opened from 3D view (2011-08-05)

Animations

Load video
YouTube
Using fly-through mode for creating animation

Video tutorials

Load video
YouTube
Loading data, settings layer properties
Load video
YouTube
Visualizing fringes and north arrow
Load video
YouTube
3D raster maps (volumes) in the space (isosurface and slice mode)
Load video
YouTube
Color thematic mapping

Older tutorials (2010)

Load video
YouTube
Loading data, settings layer properties
Load video
YouTube
Visualizing fringes
Load video
YouTube
3D raster maps (volumes) in the space

Ideas

  • Fog support (see [1], [2], [3])
  • Vertical labels (take from geonames.org point data): like in http://tev.fbk.eu/marmota/blog/?p=82
  • Second interactive light source for isosurface visualization
  • Tick marks and coordinate values to x,y,z axis when drawing fringe

Troubleshooting

  • Nothing is rendered at all:
Please note that with wxGTK port of wxPython (Linux systems), a problem might appear during wxNviz initialization (nothing is rendered at all) or when rendering vectors (bad order of rendering surfaces and vectors). If you encounter such problems, try to change a depth buffer number in wxGUI Menu > Settings > Preferences > Map Display > Advanced (possible numbers are 0, 16, 24, 32). It is currently not possible to automatically find out the right number which is working for your computer.

Known issues

  1. List of open and closed tickets
  2. Adding vector data crashes wxGUI on Mac
  3. Viewing height sometimes sets to 1 after switching to 2D and back to 3D View (or with the simultaneous 2D view - very nice feature) and even after View is reset, it keeps getting back at 1 each time the slider is touched
    Fixed in r46208
  4. Adding draw, draw current and clear button may be useful
  5. Thematic mapping is available in GRASS 7 only
  6. Display region in 3D does not change accordingly to display region in 2D in version <= 6.5
  7. Appearance:
    1.  I need to click View tab to get the arrow draw, same for the scale bar
    2. add legend > OK: nothing gets drawn in 3D but the legend shows up when I switch to 2D but when I clicked delete scalebar (which was not drawn), my surface disapeared but the legend showed up along with white and black background (which I assume was supposed to be transparent, because when I moved the legend the surface was under it - we already discussed this, it may be my problem, because it works for Michael).
  8. General
    1. when I go from 3D view to 2D and then back to 3D I lose most of my settings 
    2. similarly, when I add volume to Map layers I lose my view settings and the 3D view goes back to default
  9. Volumes:
    1. change of region by g.region seems to be ignored (or I missed something), I had to restart GRASS with the new region to get the 3D region for volumes right. Given that the default top, botom is 1,0, if GRASS starts with the default 3D region settings volumes do not work because there is just one level.
    2. isosurfaces work with my terrestrial lidar data but the slices don't, it seems that it is due my resolution being 0.3m, when I change it to 1m I get at least some limited slicing
      1. this may be in ogsf becuase slices in nviz do not work with this data either
  10. changing color to constant did not change the color of the isosurface

Comparison of Tcl/Tk nviz and wxNviz functionality

What is missing in wxNviz:

  • scaled difference
  • lighting - follow surface viewpoint
  • keyframe animation
  • text rendering (in OpenGl)

What is working only partially:

  • legend, labels
  • thematic mapping - nviz allows to choose also icon and multiple classification
  • basic support of animations

What is new in wxNviz:

  • it is possible to change view more interactively using mouse

Notes:

  • Scripting functionality is replaced by m.nviz.image module
  • wxNviz state is saved in workspace


Google Summer of Code

2008

2010

2011

See also

Retrieved from "https://grasswiki.osgeo.org/w/index.php?title=WxNviz&oldid=25411"