.. _Peacock: ########### Peacock 3D ########### Conventional 2D exploration has its limitations which is why d3VIEW incorporates a 3D application called Peacock to help examine and explore models in 3D space. This application integrates most prominently with simulations and Simlytiks and can be used to unravel more information from our 3D models. Watch the following video for an overview of the application's capabilities: .. video:: _static/movies/Peacock/Peacock_July22-2022_V4.mp4 :width: 100% | | **What Will Be Covered** * Extracting and uploading models * Understanding the interface * Advanced features * Exporting and sharing ---------------------------------------------------------------------------------------------------------------------------------- ************************** Extracting and Uploading ************************** There are two ways we can use Peacock for exploring our models. First, we can extract 3D files from a simulation or physical test. Second, we can upload our own 3D files under a simulation or physical test to open in Peacock. Let's first go over what files are supported in Peacock. Supported Files ================ Peacock 3D supports a range of 3D files including extracted simulation files: +-------------------------+-----------+-----------------------+ | Name | Extension | d3VIEW Generated Only | +=========================+===========+=======================+ | Peacock3D | .js3d | X | +-------------------------+-----------+-----------------------+ | Peacock3D | .js3d.zip | X | +-------------------------+-----------+-----------------------+ | Stereolithography (CAD) | .stl | | +-------------------------+-----------+-----------------------+ | Polygon | .ply | | +-------------------------+-----------+-----------------------+ | Object | .obj | | +-------------------------+-----------+-----------------------+ | Visualization Toolkit | .vtk | | +-------------------------+-----------+-----------------------+ | VTK Surface Models | .vtp | | +-------------------------+-----------+-----------------------+ Extracting 3D Models From Data =============================== Let's go over how to extract a 3D file for viewing in Peacock. We'll be reviewing how to extract from a simulation, but we can also extract from physical test data so long as we have the data to support it. After submitting a simulation :ref:`(learn how to do that here),` we'll open it and go to the the responses page (1) :ref:`(learn how to navigate simulations here)` and click "Extract Responses" (2) to get started. .. thumbnail:: /_images/Images/Peacock/SimulationResponsesPage.png :title: Simulation Responses Page .. centered:: :sup:`Figure 1: Simulation Responses Page` | Once we have the Extract Responses window up, we'll navigate to the dyna_d3plot Data source tab. .. thumbnail:: /_images/Images/Peacock/dyna_d3plot_tab.png :title: Extract dyna_d3plot Response .. centered:: :sup:`Figure 2: Extract dyna_d3plot Response` | For this example, we are extracting from an occupant belted sample simulation (email support@d3view.com to get this simulation file). We'll set up the parameters as follows making sure we name our model with the correct .js3d.zip extension, choosing Peacock3D as the output type and specifying a final state: .. thumbnail:: /_images/Images/Peacock/InputParameters.png :title: Extract dyna_d3plot Input Parameters .. centered:: :sup:`Figure 3: Extract dyna_d3plot Input Parameters` | We can choose to preview the response first (1) and then go ahead and extract it (2). .. thumbnail:: /_images/Images/Peacock/ExtractPeacockModel.png :title: Extract Peacock 3D Model .. centered:: :sup:`Figure 4: Extract Peacock 3D Model` | After hitting extract, we should see our new response at the top of our simulation responses page. We'll click on it and expand the window to start exploring it in Peacock. .. thumbnail:: /_images/Images/Peacock/ExtractedResponse.png :title: Extracted Peacock 3D Model .. centered:: :sup:`Figure 5: Extracted Peacock 3D Model` | Uploading a Local Model =============================== To upload a local 3D model, go to the Physical Tests application and upload your model as a new test :ref:`(learn how to create a physical test in more detail here).` In this example, we are uploading a brain PLY file and naming the test according. We'll process the text to upload it to the platform. .. thumbnail:: /_images/Images/Peacock/NewPhysTestUploadModel.png :title: Upload Model as a Physical Test .. centered:: :sup:`Figure 6: Upload Model as a Physical Test` | The new test will show up on our Physical Tests main page. (Click the refresh button at the top if you don't see it initially). We'll click on its name to open it in a new tab. .. thumbnail:: /_images/Images/Peacock/OpenModel.png :title: Open Physical Test Model .. centered:: :sup:`Figure 7: Open Physical Test Model` | Under the Files section of the test, we'll see our uploaded model. .. thumbnail:: /_images/Images/Peacock/ModelFile.png :title: Model File .. centered:: :sup:`Figure 8: Model File` | We can then click on the model name to open in a new Peacock window as shown in the following video: .. video:: _static/movies/Peacock/OpenUploadedModel.mp4 :width: 100% | | Progressive Loading ===================== When we upload and open large models, Peacock initiates progressive loading based on groups by user-defined parts list. This allows us to interact with intricate models sooner than waiting for the full model to load. .. thumbnail:: /_images/Images/Peacock/ProgressiveLoading.png :title: Progressive Loading .. centered:: :sup:`Figure 9: Progressive Loading` | When we open a model of this caliber, we'll see a progressive loading bar on the bottom right (1) and a Pause Progressive Loading button on the bottom left (2). .. thumbnail:: /_images/Images/Peacock/ProgLoadBarPauseButton.png :title: Progressive Loading Bar and Pause Button .. centered:: :sup:`Figure 10: Progressive Loading Bar and Pause Button` | Once we click pause, we'll be able to interact with the semi-loaded model. We can see under the BOM, or Bill of Materials, menu :ref:`(more on that here)` which parts/groups have fully rendered, indicated with a green dot, and which still have yet to render, indicated with a red dot. .. video:: _static/movies/Peacock/ProgressiveLoading.mp4 :width: 100% | | We can restart the rendering process by clicking the blue button again which will now say Play Progressive Loading. .. thumbnail:: /_images/Images/Peacock/PlayProgressiveLoading.png :title: Play Progressive Loading .. centered:: :sup:`Figure 11: Play Progressive Loading` | ************** Navigation ************** In this section, we'll go over the basics of how to navigate and explore a 3D model. Peacock Interface ================== The following image maps the options available in the 3D app with descriptions for each below: .. thumbnail:: /_images/Images/Peacock/PeacockInterface.png :title: Peacock Interface .. centered:: :sup:`Figure 12: Peacock Interface` 1. Model file name 2. Files: import more models 3. Edit: turn fringes on/off 4. View: change the perspective of the model 5. Export: download the model as a GIF or PNG of current view 6. Take a Tour: guided tour of Peacock basics 7. BOM: view and edit Bill of Materials 8. Groups: view, upload and edit assembly groups 9. Setting: customize the experience such as changing the lighting or background color 10. Perspective: takes us back to the Home view 11. View: another way to change perspective 12. Fringes: another way to turn fringes on/off 13. Quick Export to PNG 14. Quick Export to GIF 15. Animation controls 16. Settings for animation controls 17. Animation information 18. Close out of Peacock 19. Information and controls will populate here when using certain features 20. Model tabs: all uploaded model will be shown here for navigation Perspective and Views ======================= Click, hold and then move the mouse to explore different sides of the 3D model. .. video:: _static/movies/Peacock/MoveModel.mp4 :width: 100% | | Use the View menus at the bottom or top of the window to see the model orthographically. .. video:: _static/movies/Peacock/ModelViews.mp4 :width: 100% | | ************** Features ************** In this section, we'll go over some of Peacock's useful features for exploring models. Customization =============== Under the settings menu to the left, we can customize aspects of our model and experience in the 3D viewer. .. thumbnail:: /_images/Images/Peacock/customizesettings.png :title: Peacock Interface .. centered:: :sup:`Figure 13: Peacock Interface` | Edit the material type, clip the model, change the background color, choose different lighting and measure our model all under this menu. .. video:: _static/movies/Peacock/customize.mp4 :width: 100% | | .. _BillofMaterials: Bill of Materials ================== Under the BOM (cube) menu, we can review all our model parts. .. thumbnail:: /_images/Images/Peacock/BOMMenu.png :title: Bill of Material Menu .. centered:: :sup:`Figure 14: Bill of Material Menu` | Click on the pivot caret to see information about a particular part and customize it. .. thumbnail:: /_images/Images/Peacock/BOMPart.png :title: Bill of Material Part .. centered:: :sup:`Figure 15: Bill of Material Part` | We can update the part color as well as change the material type from solid to wireframe. .. video:: _static/movies/Peacock/BOM_ColorMaterial.mp4 :width: 100% | | Uncheck parts to hide them from the model. Recheck to add them back or use the right side panel to restore them individually or restore them all. .. video:: _static/movies/Peacock/BOM_Visibility.mp4 :width: 100% | | Right-Click Options ===================== Right-click on a model part to see the right-click options. .. thumbnail:: /_images/Images/Peacock/RightClickMenu.png :title: Right-Click Menu .. centered:: :sup:`Figure 16: Right-Click Menu` | Show Part Details ----------------- Show Part Details gives use the same information and customization abilities as the BOM menu for individual parts. .. thumbnail:: /_images/Images/Peacock/ShowPartDetails.png :title: Show Part Details .. centered:: :sup:`Figure 17: Show Part Details` | We change the color and opacity, switch to wireframes, remove and even transform the model part. Make sure to click on Save to apply the changes. We can also use the Reset Part option to revert it back to its original settings. .. video:: _static/movies/Peacock/ShowPartDetails.mp4 :width: 100% | | Bounding Box --------------- Bounding Box allows us to select groups of the model by using a selection box. We can choose the keep or remove selected elements in the right side panel. .. thumbnail:: /_images/Images/Peacock/BoundingBox.png :title: Bounding Box .. centered:: :sup:`Figure 18: Bounding Box` | Use the axis lines to resize and move the bounding box. Once we have our desired parts selected, we can choose to keep or remove the select parts and faces. Keeping excludes the rest while removing excludes the selected. If we choose to remove the selection as shown in the following video, we can create a section cut of our model. .. video:: _static/movies/Peacock/BoundingBox_Remove.mp4 :width: 100% | | In the right side panel, we'll notice that the removed aspects of the model are listed as faces since we may have not selected full model parts. .. thumbnail:: /_images/Images/Peacock/RemovedFaces.png :title: Removed Faces .. centered:: :sup:`Figure 19: Removed Faces` | Just as with our parts, we can restore individual faces or restore all. .. video:: _static/movies/Peacock/BoundingBox_Restore.mp4 :width: 100% | | Fringes ===================== Peacock has fringe options for nodal and time-histories from LS-DYNA such as plastic-strain, von-mises-stress and triaxiality. .. video:: _static/movies/Peacock/fringe_uniaxial.mp4 :width: 100% | | When extracting a JS3D response, make sure to indicate which type under the fringe parameters. .. thumbnail:: /_images/Images/Peacock/FringeParameters.png :title: Fringe Parameters .. centered:: :sup:`Figure 20: Fringe Parameters` | Once we're in Peacock, we can turn on fringes under the respective menu. .. thumbnail:: /_images/Images/Peacock/TurnOnFringes.png :title: Turn On Fringes .. centered:: :sup:`Figure 21: Turn On Fringes` | We'll see fringe spectrum (1) on the right side of our model canvas and our fringe settings on the right side panel. .. thumbnail:: /_images/Images/Peacock/FringeSpectrumandSettings.png :title: Fringe Spectrum and Settings .. centered:: :sup:`Figure 22: Fringe Spectrum and Settings` | After we make any necessary updates, we can play our model to see changes in its fringe colors. .. video:: _static/movies/Peacock/PlasticStrainFringes.mp4 :width: 100% | | Assembly Groups ===================== Under the Groups (cogs) menu, we can visualize and upload assemblies from LS-Prepost, Primer or Meta-Post. .. thumbnail:: /_images/Images/Peacock/AssemblyGroups.png :title: Assembly Groups .. centered:: :sup:`Figure 23: Assembly Groups` | Choose the group file type (1), then drag-and-drop or click-to-upload (2) the group files. .. thumbnail:: /_images/Images/Peacock/AddGroupFiles.png :title: Add Group Files .. centered:: :sup:`Figure 24: Add Group Files` | Here is a video example: .. video:: _static/movies/Peacock/Assembly.mp4 :width: 100% | | Model Syncing ===================== Aside from opening models directly from a simulation or physical test, we can also view and analyze these models in Simlytiks. We'll do this by comparing responses of these simulations or physical tests. :ref:`(Learn more in this section on comparing physical test responses.)` .. thumbnail:: /_images/Images/Peacock/CompareSimulationResponses.png :title: Compare Simulation Responses .. centered:: :sup:`Figure 25: Compare Simulation Responses` | Once in Simlytiks, we'll create a new page (1). `(Learn more on that here.) `_ Then, we'll drag-and-drop a model into the page section (2). .. thumbnail:: /_images/Images/Peacock/AddModelstoPageSections.png :title: Add Models to Page Sections .. centered:: :sup:`Figure 26: Add Models to Page Sections` | We should see both models (one from each simulation we compared) appear on the page. .. thumbnail:: /_images/Images/Peacock/SimulationModels.png :title: HAT Simulation Models .. centered:: :sup:`Figure 27: HAT Simulation Models` | Now, we can perform any Peacock tools to one and see them reflected in the other. .. video:: _static/movies/Peacock/PeacockeModelSync.mp4 :width: 100% | | This allows us to intricately compare the models in real time. .. thumbnail:: /_images/Images/Peacock/SyncedSimulationModels.png :title: Synced Simulation Models .. centered:: :sup:`Figure 28: Synced Simulation Models` | ********************* Sharing & Exporting ********************* Let's review how we can share and export our 3D model. Sharing Options =================== The process for sharing our model will depend on if we extracted or uploaded it. Share 3D Response ------------------- Our extracted 3D response can be shared, first, by locating it in the Response section of a simulation or physical test, then by clicking on the 3 dots in its top right corner. Under these options, we'll choose Share. .. thumbnail:: /_images/Images/Peacock/ShareExtracted3DResponse.png :title: Share Extracted 3D Response .. centered:: :sup:`Figure 29: Share Extracted 3D Response` | In the next window, we'll indicate the type of share and then press OK. .. thumbnail:: /_images/Images/Peacock/TypeofShare.png :title: Type of Share .. centered:: :sup:`Figure 30: Type of Share` | For this example, we've chosen a public share which has populated a link. This is the most common option as anyone with the link can view the model even if they do not have a d3VIEW account. .. thumbnail:: /_images/Images/Peacock/PublicShareLink.png :title: Public Share Link .. centered:: :sup:`Figure 31: Public Share Link` | Share 3D File ---------------- For uploaded model files, locate the model under the Files tab of a simulation or physical test, click the 3 dots and choose Share. .. thumbnail:: /_images/Images/Peacock/ShareUploaded3DFile.png :title: Share Uploaded 3D File .. centered:: :sup:`Figure 32: Share Uploaded 3D File` | Choose which user to share the file with, then whether they can just read or read and write the file before pressing OK. .. thumbnail:: /_images/Images/Peacock/ChooseUserandPermission.png :title: Choose User and Permission .. centered:: :sup:`Figure 33: Choose User and Permission` | Exporting Options =================== We can export our model via a PNG or a GIF. The PNG will be a still of the current view, while the GIF will be the full animation. Find these export options under the Export Menu at the top or as quick buttons at the bottom. .. thumbnail:: /_images/Images/Peacock/Export3DModel.png :title: Export 3D Model .. centered:: :sup:`Figure 34: Export 3D Model` |