Bender/Documentation/2.0/Tutorial: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
(Add 2.0 screenshots)
 
Line 1: Line 1:
= Video =
= Video =
{|
{|
|[[Image:Bender-1.1-preview-video.png|link=http://vimeo.com/73247670|400px|Bender workflow tutorial]]
|[[Image:Bender-2.0-tutorial-video.png|link=http://vimeo.com/73247670|400px|Bender workflow tutorial]]
| Links to tutorial sections:
| Links to tutorial sections:
[[#Step_2:_Load_data|Load data]] -> [https://vimeo.com/73247670#t=0m16s 0:16] <br>
[[#Step_2:_Load_data|Load data]] -> [https://vimeo.com/73247670#t=0m16s 0:16] <br>
[[#Step_3:_Generate_bone_and_skin_surface_models|Merge labels]] -> [https://vimeo.com/73247670#t=0m28s 0:28]<br>
[[#Step_3:_Merge_and_resample|Merge labels]] -> [https://vimeo.com/73247670#t=0m28s 0:28]<br>
[[#Step_3:_Generate_bone_and_skin_surface_models|Generate bone surface]] -> [https://vimeo.com/73247670#t=0m32s 0:32]<br>
[[#Step_3:_Merge_and_resample|Resample image]] -> [https://vimeo.com/73247670#t=0m28s 0:28]<br>
[[#Step_3:_Generate_bone_and_skin_surface_models|Generate skin surface]] -> [https://vimeo.com/73247670#t=0m34s 0:34]<br>
[[#Step_3:_Merge_and_resample|Pad image]] -> [https://vimeo.com/73247670#t=0m28s 0:28]<br>
[[#Step_4:_Define_rigging|Armature/Rig]] -> [https://vimeo.com/73247670#t=0m40s 0:40]<br>
[[#Step_4:_Extract_materials|Create tetrahedral mesh]] -> [https://vimeo.com/73247670#t=0m32s 0:32]<br>
[[#Step_5:_Skinning|Volume skinning]] -> [https://vimeo.com/73247670#t=0m50s 0:50]<br>
[[#Step_4:_Extract_materials|Extract bone mesh]] -> [https://vimeo.com/73247670#t=0m32s 0:32]<br>
[[#Step_6:_Weights|Bone weights]] -> [https://vimeo.com/73247670#t=0m55s 0:55]<br>
[[#Step_4:_Extract_materials|Extract skin mesh]] -> [https://vimeo.com/73247670#t=0m34s 0:34]<br>
[[#Step_6:_Weights|Evaluate surface]] -> [https://vimeo.com/73247670#t=1m00s 1:00]<br>
[[#Step_5:_Define_rigging|Armature/Rig]] -> [https://vimeo.com/73247670#t=0m40s 0:40]<br>
[[#Step_7:_Pose_surface|Pose surface]] -> [https://vimeo.com/73247670#t=1m06s 1:06]<br>
[[#Step_6:_Skinning|Volume skinning]] -> [https://vimeo.com/73247670#t=0m50s 0:50]<br>
[[#Step_8:_Pose_voxelized_model|Resample labelmap]] -> [https://vimeo.com/73247670#t=1m14s 1:15]<br>
[[#Step_7:_Weights|Compute weights]] -> [https://vimeo.com/73247670#t=0m55s 0:55]<br>
[[#Step_7:_Weights|Evaluate mesh]] -> [https://vimeo.com/73247670#t=1m00s 1:00]<br>
[[#Step_7:_Weights|Apply materials]] -> [https://vimeo.com/73247670#t=1m00s 1:00]<br>
[[#Step_8:_Pose_armature|Pose armature]] -> [https://vimeo.com/73247670#t=1m06s 1:06]<br>
[[#Step_8:_Pose_armature|Simulate pose]] -> [https://vimeo.com/73247670#t=1m14s 1:15]<br>
|}
|}


Line 19: Line 23:
Select "File->Download Sample Data" in the menu.
Select "File->Download Sample Data" in the menu.
Select directory (with write access) and click the "Download data" button
Select directory (with write access) and click the "Download data" button
[[Image:Bender-Tutorial-v1.1-DownloadSampleData.png|center|300px]]
[[Image:Bender-Tutorial-v2.0-DownloadSampleData.png|center|300px]]
===Step 2: Load data===
===Step 2: Load data===
Go back to the Bender workflow module by clicking "Back" in the toolbar (or the "Bender" logo icon.
Go back to the Bender workflow module by clicking "Back" in the toolbar (or the "Bender" logo icon.
Click the Volume folder button and select the downloaded "man-arm-2mm.mha" file
Click the Volume folder button and select the downloaded "man-arm-2mm.mha" file
Click the Colors folder button and select the downloaded "Tissues-v1.1.0.txt" file
Click the Colors folder button and select the downloaded "Tissues-v2.0.txt" file
Validate the step by clicking "2/7 - Extract bones and skin"
Validate the step by clicking the button "2/7 - Merge and resample"
[[Image:Bender-Tutorial-v1.1-1A-Labelmap.png|center|300px]]
[[Image:Bender-Tutorial-v2.0-1A-Labelmap.png|center|300px]]
===Step 3: Generate bone and skin surface models===
===Step 3: Merge and resample===
Click the "Merge labels" button
Click the "Merge labels" button
[[Image:Bender-Tutorial-v1.1-1B-MergeLabels.png|center|300px]]
[[Image:Bender-Tutorial-v2.0-2A-MergeLabels.png|center|300px]]
Click the "Generate bone model" button
Click the "Resample" button and then the "Pad" button
[[Image:Bender-Tutorial-v1.1-2A-BoneModelMaker.png|center|300px]]
[[Image:Bender-Tutorial-v2.0-2B-ResampleImage.png|center|300px]]
Click the "Generate skin model" button
Validate the step by clicking "3/7 - Extract materials"
[[Image:Bender-Tutorial-v1.1-2B-SkinModelMaker.png|center|300px]]
===Step 4: Extract materials ===
Validate the step by clicking "3/7 - Create armature (rigging)"
Click the "Generate mesh" button
===Step 4: Define rigging ===
[[Image:Bender-Tutorial-v2.0-3A-CreateTetrahedralMesh.png|center|300px]]
Click "Select a Preset" and "Load armature from file" from the menu
Click the "Extract bone model" button
Select "man-arm-2mm-armature.vtk" file
[[Image:Bender-Tutorial-v2.0-3B-ExtractBoneMesh.png|center|300px]]
[[Image:Bender-Tutorial-v1.1-3A-Armatures.png|center|300px]]
Click the "Extract skin model" button
Validate the step by clicking "4/7 - Skin armature to volume"
[[Image:Bender-Tutorial-v2.0-3C-ExtractSkinMesh.png|center|300px]]
===Step 5: Skinning===
Validate the step by clicking "4/7 - Create armature (rigging)"
===Step 5: Define rigging ===
Click "Select a Preset" and "Arm-armature" from the menu
{| align="center"
|[[Image:Bender-Tutorial-v2.0-4A-Armatures-1.png|center|300px]]
|[[Image:Bender-Tutorial-v2.0-4A-Armatures-2.png|center|300px]]
|}
Validate the step by clicking "5/7 - Skin armature to volume"
===Step 6: Skinning===
Click the "Skin volume" button
Click the "Skin volume" button
[[Image:Bender-Tutorial-v1.1-4A-VolumeSkinning.png|center|300px]]
[[Image:Bender-Tutorial-v2.0-5A-VolumeSkinning.png|center|300px]]
Validate the step by clicking "5/7 - Compute weights"
Validate the step by clicking "6/7 - Compute weights"
===Step 6: Weights===
===Step 7: Weights===
Click the "Compute weights" button
Click the "Compute weights" button
Click the "Evaluate surface weight" button
Click the "Evaluate surface weight" button
[[Image:Bender-Tutorial-v1.1-4B-ComputeWeights.png|center|300px]]
Click the "Apply material properties" button
Validate the step by clicking "6/7 - Pose armature (posing)"
[[Image:Bender-Tutorial-v2.0-6C-ApplyMaterials.png|center|300px]]
===Step 7: Pose surface===
Validate the step by clicking "7/7 - Pose armature (posing)"
Select Skin in the "Input surface" combobox
===Step 8: Pose armature===
[[Image:Bender-Tutorial-v1.1-5B-PoseArmature.png|center|300px]]
Click the "camera" tool button and select the file "man-arm-biceps-curl-v2.0.bvh". In the dialog, select the frame #30 in Options and validate with the "Open" button.
Validate the "7/7 - Pose labelmap (resampling)"
{| align="center"
===Step 8: Pose voxelized model===
|[[Image:Bender-Tutorial-v2.0-7A-PoseArmature-1.png|center|300px]]
Click the "Pose Labelmap" button
|[[Image:Bender-Tutorial-v2.0-7A-PoseArmature-2.png|center|300px]]
[[Image:Bender-Tutorial-v1.1-6A-ResampleLabelmap.png|center|300px]]
|}
Only the bone and skin labels are volume rendered, all the labels can be rendered if you clear the Label(s) line edit. The crop checkbox shows/hides the volume rendering cropping box
Click the "Simulate pose" button and wait for the results to appear.
[[Image:Bender-Tutorial-v2.0-7B-SimulatePose.png|center|300px]]

Latest revision as of 13:36, 1 April 2014

Video

Bender workflow tutorial Links to tutorial sections:

Load data -> 0:16
Merge labels -> 0:28
Resample image -> 0:28
Pad image -> 0:28
Create tetrahedral mesh -> 0:32
Extract bone mesh -> 0:32
Extract skin mesh -> 0:34
Armature/Rig -> 0:40
Volume skinning -> 0:50
Compute weights -> 0:55
Evaluate mesh -> 1:00
Apply materials -> 1:00
Pose armature -> 1:06
Simulate pose -> 1:15

Step by Step

Step 1: Download tutorial data

Select "File->Download Sample Data" in the menu. Select directory (with write access) and click the "Download data" button

Bender-Tutorial-v2.0-DownloadSampleData.png

Step 2: Load data

Go back to the Bender workflow module by clicking "Back" in the toolbar (or the "Bender" logo icon. Click the Volume folder button and select the downloaded "man-arm-2mm.mha" file Click the Colors folder button and select the downloaded "Tissues-v2.0.txt" file Validate the step by clicking the button "2/7 - Merge and resample"

Bender-Tutorial-v2.0-1A-Labelmap.png

Step 3: Merge and resample

Click the "Merge labels" button

Bender-Tutorial-v2.0-2A-MergeLabels.png

Click the "Resample" button and then the "Pad" button

Bender-Tutorial-v2.0-2B-ResampleImage.png

Validate the step by clicking "3/7 - Extract materials"

Step 4: Extract materials

Click the "Generate mesh" button

Bender-Tutorial-v2.0-3A-CreateTetrahedralMesh.png

Click the "Extract bone model" button

Bender-Tutorial-v2.0-3B-ExtractBoneMesh.png

Click the "Extract skin model" button

Bender-Tutorial-v2.0-3C-ExtractSkinMesh.png

Validate the step by clicking "4/7 - Create armature (rigging)"

Step 5: Define rigging

Click "Select a Preset" and "Arm-armature" from the menu

Bender-Tutorial-v2.0-4A-Armatures-1.png
Bender-Tutorial-v2.0-4A-Armatures-2.png

Validate the step by clicking "5/7 - Skin armature to volume"

Step 6: Skinning

Click the "Skin volume" button

Bender-Tutorial-v2.0-5A-VolumeSkinning.png

Validate the step by clicking "6/7 - Compute weights"

Step 7: Weights

Click the "Compute weights" button Click the "Evaluate surface weight" button Click the "Apply material properties" button

Bender-Tutorial-v2.0-6C-ApplyMaterials.png

Validate the step by clicking "7/7 - Pose armature (posing)"

Step 8: Pose armature

Click the "camera" tool button and select the file "man-arm-biceps-curl-v2.0.bvh". In the dialog, select the frame #30 in Options and validate with the "Open" button.

Bender-Tutorial-v2.0-7A-PoseArmature-1.png
Bender-Tutorial-v2.0-7A-PoseArmature-2.png

Click the "Simulate pose" button and wait for the results to appear.

Bender-Tutorial-v2.0-7B-SimulatePose.png