|
1 | 1 | <tool id="3dtrees_overviews" name="3Dtrees: Overviews" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="24.2"> |
2 | 2 | <description>generates 3D overview images</description> |
3 | 3 | <macros> |
4 | | - <token name="@TOOL_VERSION@">1.0.0</token> |
5 | | - <token name="@VERSION_SUFFIX@">1</token> |
| 4 | + <token name="@TOOL_VERSION@">1.0.1</token> |
| 5 | + <token name="@VERSION_SUFFIX@">0</token> |
6 | 6 | </macros> |
7 | 7 | <requirements> |
8 | 8 | <container type="docker">ghcr.io/3dtrees-earth/tool_overviews:@TOOL_VERSION@</container> |
9 | 9 | </requirements> |
10 | 10 | <command detect_errors="exit_code"><![CDATA[ |
11 | | - export MPLCONFIGDIR=\$TMPDIR && |
12 | | - mkdir -p ./output_dir/ && |
13 | | - ln -s '$input' input.laz && |
14 | | - python -u /src/run.py |
| 11 | + mkdir -p ./output_dir/ && |
| 12 | + ln -s '$input' input.laz && |
| 13 | + python -u /src/run.py |
15 | 14 | --dataset-path input.laz |
16 | 15 | --max-points '$max_points' |
17 | 16 | --section-width '$section_width' |
18 | 17 | --image-width '$image_width' |
19 | 18 | --image-height '$image_height' |
20 | 19 | --top-views-deg '$top_views_deg' |
21 | 20 | --cmap '$cmap' |
22 | | - --camera-distance '$camera_distance' |
| 21 | + --camera-distance '$camera_distance' |
23 | 22 | --output-dir ./output_dir/ |
24 | | - ]]> |
| 23 | + ]]> |
25 | 24 | </command> |
26 | 25 | <inputs> |
27 | 26 | <param name="input" type="data" format="laz" label="Point Cloud Dataset" help="LAZ point cloud file to process"/> |
|
84 | 83 | </test> |
85 | 84 | </tests> |
86 | 85 | <help format="markdown"> |
87 | | - |
88 | | - **What it does** |
89 | | - |
90 | | - This tool generates 3D overview visualizations from point cloud dataset. It creates: |
91 | | - |
92 | | - 1. **Top View Images**: A series of top-down views rotated around the point cloud center |
93 | | - 2. **Section Views**: Cross-sectional views from north-south and east-west directions |
94 | | - 3. **Overview Animation**: An animated GIF showing the rotation sequence |
95 | | - |
96 | | - The tool automatically handles large datasets by downsampling to a manageable number of points while preserving the overall structure and appearance. |
97 | | - |
98 | | - ----- |
99 | | - |
100 | | - **Input** |
101 | | - |
102 | | - - **Point Cloud Dataset**: LAZ format point cloud file |
103 | | - - **Maximum Points**: Limit for downsampling (default: 100M points) |
104 | | - - **Section Width**: Width of cross-sectional views in meters |
105 | | - - **Image Dimensions**: Width and height of output images in pixels |
106 | | - - **Top View Rotation**: Angular step size for rotation sequence |
107 | | - - **Color Map**: Visualization color scheme (height-based coloring) |
108 | | - - **Camera Distance**: Distance from point cloud center for rendering |
109 | | - |
110 | | - ----- |
111 | | - |
112 | | - **Output** |
113 | | - |
114 | | - - **Top View Images**: Collection of PNG images showing top-down views at different rotation angles |
115 | | - - **Section View Images**: Collection of PNG images showing cross-sectional views |
116 | | - - **Overview Animation**: GIF file showing the complete rotation sequence |
117 | | - |
118 | | - ----- |
119 | | - |
120 | | - **Example** |
121 | | - |
122 | | - For a forest point cloud dataset, this tool will generate: |
123 | | - - 36 top view images (every 10 degrees) |
124 | | - - 2 section view images (north-south and east-west cuts) |
125 | | - - 1 animated GIF showing the complete 360° rotation |
126 | | - |
127 | | - The images use height-based coloring to show terrain and vegetation structure. |
128 | | - |
129 | | - </help> |
| 86 | + |
| 87 | +**What it does** |
| 88 | + |
| 89 | +This tool generates 3D overview visualizations from point cloud dataset. It creates: |
| 90 | + |
| 91 | +1. **Top View Images**: A series of top-down views rotated around the point cloud center |
| 92 | +2. **Section Views**: Cross-sectional views from north-south and east-west directions |
| 93 | +3. **Overview Animation**: An animated GIF showing the rotation sequence |
| 94 | + |
| 95 | +The tool automatically handles large datasets by downsampling to a manageable number of points while preserving the overall structure and appearance. |
| 96 | + |
| 97 | +----- |
| 98 | + |
| 99 | +**Input** |
| 100 | + |
| 101 | +- **Point Cloud Dataset**: LAZ format point cloud file |
| 102 | +- **Maximum Points**: Limit for downsampling (default: 100M points) |
| 103 | +- **Section Width**: Width of cross-sectional views in meters |
| 104 | +- **Image Dimensions**: Width and height of output images in pixels |
| 105 | +- **Top View Rotation**: Angular step size for rotation sequence |
| 106 | +- **Color Map**: Visualization color scheme (height-based coloring) |
| 107 | +- **Camera Distance**: Distance from point cloud center for rendering |
| 108 | + |
| 109 | +----- |
| 110 | + |
| 111 | +**Output** |
| 112 | + |
| 113 | +- **Top View Images**: Collection of PNG images showing top-down views at different rotation angles |
| 114 | +- **Section View Images**: Collection of PNG images showing cross-sectional views |
| 115 | +- **Overview Animation**: GIF file showing the complete rotation sequence |
| 116 | + |
| 117 | +----- |
| 118 | + |
| 119 | +**Example** |
| 120 | + |
| 121 | +For a forest point cloud dataset, this tool will generate: |
| 122 | +- 36 top view images (every 10 degrees) |
| 123 | +- 2 section view images (north-south and east-west cuts) |
| 124 | +- 1 animated GIF showing the complete 360° rotation |
| 125 | + |
| 126 | +The images use height-based coloring to show terrain and vegetation structure. |
| 127 | + |
| 128 | + </help> |
130 | 129 | <creator> |
131 | 130 | <person name="Julian Frey" email="julian.frey@wwd.uni-freiburg.de" url="https://orcid.org/0000-0001-7895-702X"/> |
132 | 131 | <person name="Kilian Gerberding" email="kilian.gerberding@geosense.uni-freiburg.de" url="https://orcid.org/0009-0002-5001-2571"/> |
|
0 commit comments