|
2 | 2 | <description>generates 3D overview images</description> |
3 | 3 | <macros> |
4 | 4 | <token name="@TOOL_VERSION@">1.0.0</token> |
5 | | - <token name="@VERSION_SUFFIX@">0</token> |
| 5 | + <token name="@VERSION_SUFFIX@">1</token> |
6 | 6 | </macros> |
7 | 7 | <requirements> |
8 | | - <container type="docker">ghcr.io/3dtrees-earth/tool_overviews:0.2</container> |
| 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 | 11 | export MPLCONFIGDIR=\$TMPDIR && |
12 | | - mkdir ./output_dir/ && |
13 | | - ln -s $input input.laz && |
14 | | - python -u /src/run.py |
15 | | - --dataset-path input.laz |
| 12 | + mkdir -p ./output_dir/ && |
| 13 | + ln -s '$input' input.laz && |
| 14 | + python -u /src/run.py |
| 15 | + --dataset-path input.laz |
16 | 16 | --max-points '$max_points' |
17 | 17 | --section-width '$section_width' |
18 | 18 | --image-width '$image_width' |
19 | 19 | --image-height '$image_height' |
20 | 20 | --top-views-deg '$top_views_deg' |
21 | 21 | --cmap '$cmap' |
22 | | - --camera-distance '$camera_distance' |
| 22 | + --camera-distance '$camera_distance' |
23 | 23 | --output-dir ./output_dir/ |
24 | | - ]]> |
| 24 | + ]]> |
25 | 25 | </command> |
26 | 26 | <inputs> |
27 | 27 | <param name="input" type="data" format="laz" label="Point Cloud Dataset" help="LAZ point cloud file to process"/> |
|
57 | 57 | <collection name="section_views" type="list" label="Section View Images"> |
58 | 58 | <discover_datasets pattern="(?P<name>section_.*\.png)" directory="./output_dir/" recurse="false" visible="false" format="png"/> |
59 | 59 | </collection> |
60 | | - <data name="overview_round" format="gif" label="Overview Animation" from_work_dir="overview_round.gif"/> |
| 60 | + <data name="overview_round" format="gif" label="Overview Animation" from_work_dir="output_dir/overview_round.gif"/> |
61 | 61 | </outputs> |
62 | 62 | <tests> |
63 | 63 | <test expect_num_outputs="3"> |
|
85 | 85 | </tests> |
86 | 86 | <help format="markdown"> |
87 | 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. |
| 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 | 128 |
|
129 | 129 | </help> |
130 | 130 | <creator> |
|
0 commit comments