Skip to main content

Sofa helper to build scenes

Project description

Easily build complex simulation graphs for SOFA

Install

pip install sofacomponents

Quick start

from sofacomponents import Node, SofaFactory

# build the factory
fa = SofaFactory(debug=False)

# create the root node
root = Node()
# add attributes
root.attrs(dt=0.05, gravity=[0, -1, 0])
# add sofa components from the factory
root.add(
    fa.VisualStyle(displayFlags="showVisual"),
    fa.DefaultAnimationLoop(),
    fa.RequiredPlugin(pluginName="SofaOpenglVisual SofaPython"),
)
# add child node
childNode = root.child("childNode").add(
    fa.MeshVTKLoader(filename="mesh.vtk"),
    # add components not from the factory
    fa.UnknownComponent(data="foo"),
)

# display the scene
print(root)

# Export the scene
root.write_scene_to("scene.py")

# Export the graph
root.write_graph_to("graph.txt")

Output:

root
  └ VisualStyle (displayFlags=showVisual)
  └ DefaultAnimationLoop ()
  └ RequiredPlugin (pluginName=SofaOpenglVisual SofaPython)
  └ childNode
    └ MeshVTKLoader (filename=mesh.vtk)
    └ UnknownComponent (data=foo)

Python generated scene:

import Sofa

class SceneElectroMechanical(Sofa.PythonScriptController):
    def __init__(self, node):
        self.createGraph(node)

    def createGraph(self, root):
        # root
        root.dt = 0.05
        root.gravity = [0, -1, 0]
        root.createObject("VisualStyle", displayFlags="showVisual")
        root.createObject("DefaultAnimationLoop",)
        root.createObject("RequiredPlugin", pluginName="SofaOpenglVisual SofaPython")

        # root/childNode
        childNode = root.createChild("childNode")
        childNode.createObject("MeshVTKLoader", filename="mesh.vtk")
        childNode.createObject("UnknownComponent", data="foo")

def createScene(root_node):
    SceneElectroMechanical(root_node)

Extend

Create a factory instanciating the SofaFactory class.

The sofa_component decorator allows to update the parameters directory with:

  1. the general default parameters (See SofaFactory._defaults)
  2. the params you choose for your component
  3. the custom kwargs given by the user
from sofacomponents import SofaFactory, sofa_component

class MyFactory(SofaFactory):
    def __init__(self, debug=False):
        super().__init__(debug)
   
    @sofa_component
    def MyComponentNoParams(self, **kwargs):
        """ Minimum signature to register the component to the factory """
        return "MyComponentName"

    @sofa_component
    def MyComponent(self, **kwargs):
        params = dict(
            data="foo",
            # ...
        )
        return "MyComponentName", params

And then

# build the factory
fa = MyFactory()

Embeded documentation

pycharm documentation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sofacomponents-0.1.17.tar.gz (252.8 kB view details)

Uploaded Source

Built Distribution

sofacomponents-0.1.17-py3-none-any.whl (646.0 kB view details)

Uploaded Python 3

File details

Details for the file sofacomponents-0.1.17.tar.gz.

File metadata

  • Download URL: sofacomponents-0.1.17.tar.gz
  • Upload date:
  • Size: 252.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.0

File hashes

Hashes for sofacomponents-0.1.17.tar.gz
Algorithm Hash digest
SHA256 d5d58a7e0c2fa445e8ca116e09be76b1be95382fdbe220d5d04c2baf587d7ff3
MD5 11db0eddce91cbe8744f86875a3c2724
BLAKE2b-256 8b86f7d3a0ea7884a14e3cb509167882eda3fc84464f6d027c2d58f63a9efd04

See more details on using hashes here.

File details

Details for the file sofacomponents-0.1.17-py3-none-any.whl.

File metadata

  • Download URL: sofacomponents-0.1.17-py3-none-any.whl
  • Upload date:
  • Size: 646.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.0

File hashes

Hashes for sofacomponents-0.1.17-py3-none-any.whl
Algorithm Hash digest
SHA256 59cd12677915ee573fbc734eeb8fb3759b45adf55b87c11de778f906028df665
MD5 7ddff52b6e7ec8ef0f1b36a1f7ebf1ba
BLAKE2b-256 efc4d875c027eb35a0a7aef18452a4cc8694dd9cfe43435a3f16121d7b3546a8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page