3D Data Real-time Model Motion

This document is applicable to users who have installed the FineVis Data Visualization plugin to learn plugin functions.

Version

Note:

To use this function, you need to purchase the FVS 3D Component - Scene Twin function point. For details, you can contact FanRuan sales personnel.

Application Scenario

You can use the point data (latitude and longitude coordinates/3D spatial coordinates) of a model to drive the model to change its position within a 3D scene, thereby achieving accurate motion restoration within the 3D scene, as shown in the following figure.

Function Entry

You can choose Model > Scene Event > Model Real-time Motion > Add Model Real-time Motion, and configure real-time model motion, as shown in the following figure.

Preparation

1. Model Preparation

Note:

Only the root node of the driven model can be matched. The driven target needs be added to the scene as an independent model.

Model	Requirement Description
3D scenes, such as production workshops and logistics warehouses	1. Models requiring position changes with location data specified as relative coordinates: The origin of the 3D scene must coincide with the coordinate origin of the moving object. For example, if the relative movement data of an AGV in a workshop is referenced to a specific column as the origin, the origin of the 3D scene must also coincide with that column.   2. Models requiring position changes with location data specified as latitude and longitude coordinates: The latitude and longitude coordinates of the origin of the 3D scene need to be determined. For details, see 3D Scene Coordinate System.
Models requiring position changes, for example, an AGV	The front orientation of the model is aligned with the positive direction of the X-axis. Note: The model is set by default to face the positive direction of the X-axis after being imported into the scene. Subsequent rotation operations will not alter this front-facing orientation definition.

2. Data Preparation

Attribute Setting

The specific settings of the real-time model motion are as follows:

Setting	Descrip
Name	It means the name of the real-time motion event. Customization is supported. Empty and duplicate names are not supported.
Data Source	You can select from multiple data sources, such as dataset data and WebSocket data. The configuration options vary with the selected data source: When a dataset is selected, you need to select the dataset to be matched and set the refresh frequency. Note: The minimum refresh frequency is 1 second. When WebSocket is selected, you need to configure the WebSocket connection. Note For details about the WebSocket data push format requirements, see 3D Data Source.
Model Name	You can bind a field or enter a key value to identify the model object in the data that needs to be driven. Name Type: string
Moment	You can bind a field or enter a key value to identify the moment when a data point is retrieved from the data. Note: Only the Unix timestamp format (in milliseconds) is supported.
Model Coordinate Type	You can select latitude and longitude coordinates/3D spatial coordinates to distinguish point coordinate systems for driven motion. Latitude and Longitude Unit: degree Spatial Coordinate Unit: meter Spatial Coordinate Reference: WGS84
Model Coordinate	You can bind a field or enter a key value to identify the model point coordinate in the data that needs to be driven. Coordinate Type: string Coordinate Format: Latitude and Longitude: longitude, latitude, and h (optional) Spatial Coordinates: x, y, z

Notes

1. The model cursor must be placed at the bottom center of the entire model.

2. The front orientation of the model must be parallel to the positive direction of the X-axis, while maintaining no scaling or rotation applied.

3. The model must be exported as a single GLB file as a whole.

4. If you need to play the internal animation of a model (for example, character arm-swinging animation) during real-time motion, the animation must be named as In-place Motion Animation during modeling. This animation will be automatically triggered and played in real-time motion.

5. Real-time motion position restoration is based on the time when the template is previewed on the client. Point data before the previewing time on the client will not undergo position restoration.

For details, you can download the template:  Intelligent Warehousing and Logistics Demo

You can download and unzip the required template data: Warehousing and Logistics.zip. You should place the Warehousing and Logistics.db file into webapps/webroot/help and place the Cargo Warehousing.xlsx file into webapps/webroot/WEB-INF/reportlets.

Data Preparation

1. Choose Server > Define Data Connection, click  to create a data connection, and select the Warehousing and Logistics.db file for the URL, as shown in the following figure.

2. Create a File Dataset, set File Type to Excel, select Cargo Warehousing.xlsx, and tick Contain Column Heading in First Row, as shown in the following figure.

Note:

This file dataset has already been added to the example template. You only need to place the Cargo Warehousing.xlsx file in webapps/webroot/WEB-INF/reportlets.

3. Create a built-in dataset, and set the real-time motion data of the AGVs. The data should include the model names (string type), timestamps, and coordinate positions, as shown in the following figure.

Real-time Model Motion Setting

1. Select 3D Background, and click Edit Component on the right panel to enter the 3D component editing page.

2. Choose Model > Scene Event > Real-time Model Motion > Add Real-time Model Motion to configure real-time model motion, as shown in the following figure.

Effect Display

Click Save in the upper right corner of the template, and click Preview. The effect is the same as that shown in section "Application Scenario."