viz3Danim

Live version

Access the live version here

Description

viz3Danim performs interactive visualization of 3D structures, mode shapes and animations, using a json file format described here.

This program is a web app: it runs directly in a web browser with no installation required. It can also be run locally, offline, on your own machine (as long as Python is installed).

For convenience, we provide a live and active version hosted on github.io, with an example or without example.

NOTE: no files are stored on the server, no cookies are used, everything is run on the client side. It should be safe to use confidential files on this live version. For increased privacy, see how to run the Web App locally.

A python app is in development here but is still in "beta".

Json file format

The input files are .json files. You can see a simple example below, and more advanced examples in the examples directory of this repository.

The content of the file is as follows:

• Nodes: a list of nodal coordinates (x,y,z) for each node
• Connectivity: a connectivity matrix providing the node indices defining each element (for now elements consists of two nodes)
• ElemeProps: properties for each element
• Modes: optional field providing the modes of the structure.
• groundLevel: optional field, providing the level of the ground (e.g. the sea bed, typically a negative number).
• TimeSeries: optional field providing the time series of displacements of the structure. The format is mostly undocumented for now, it might evolve in the future.

Example files are located in the examples folder of this repository.

The .json files can be generated using:

• SubDyn (part of OpenFAST). Setting the options OutCBModes and OutFEMModes, see here.

• For modes: the python module graph.py and finite element (FEM) module of welib. See the welib FEM examples

• For time series: the python module fast_mesh.py of welib, using the MeshStorage class, see this example

A simple example of Json file:

Below is an example of json file where a triangle, made of three nodes and three elements. Two "modes" are included, where the base of the triangle moves rigidly along the x or y direction.

{"Connectivity":[
      [0, 1],
      [1, 2],
      [2, 0]
  ],
 "Nodes": [
      [ 0.0, 0.0, 1.0],
      [ 0.0,-0.25, 0.0], 
      [ 0.0, 0.25, 0.0]
 ],
 "ElemProps": [
      {"shape": "cylinder", "Diam": 0.1},
      {"shape": "cylinder", "Diam": 0.2},
      {"shape": "cylinder", "Diam": 0.1}
  ],
  "Modes": {
      "defaultSet": [
          {"name": "Mode1", "Displ": [[0.0, 0.0, 0.0], [0.3, 0.0, 0.0], [0.3, 0.0, 0.0]]},
          {"name": "Mode2", "Displ": [[0.0, 0.0, 0.0], [0.0, 0.3, 0.0], [0.0, 0.3, 0.0]]}
      ]
  }
}

Loading this json file results in the following 3d visualization (click on the image to visualize the mode in the live version of the web app):

More examples are found in the the examples directory of this repository.

Using the Web App

A live and active version of the web GUI is available here with an example or here without an example.

You can also launch a local version of the Web App on your machine, without the need for an internet connection. See how to run the Web App locally.

Basic help

• To open a file in the Web App, simply drag and drop a json file into your browser. You can alternatively use the the dropdown menu "Menu > Load"

• For more help, look at "Menu -> Help", in particular for some keyboard shortcuts to scale the modes amplitudes and frequencies.

Keyboard shortcuts

• a: increase amplitude of modes
• d: decrease amplitude of modes
• w: speed up modes or animation
• s: slow down modes or animation

Running the Web App locally.

You can run with Web App locally and without internet for convenience and confidentiality is of concern. Simply clone this repository and from the root of this repository run:

python webapp.py

This should create a local web server and launch the local version of the web app into your browser. If your browswer does not open automatically, open it, and navigate to https://localhost:1337/.

Debugging

Most browser can open a debugging console by pressing Ctrl+Shift+J. Error messages from javascript will be reported in the Console window, together with some log outputs from the app.

To force reload the webapp use Ctrl-F5, this will reload all the files included (otherwise cached versions are used).

Contributing

Any contributions to this project are welcome! If you want to add a feature to this program or report a bug, the best approach would be to open an issue and start the discussion there.

If you find this project useful, you can also buy me a coffee (donate a small amount) with the link below: