{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Vortex Studio is available on the Linux platform, albeit in a more limited capacity. ","type":"text"},{"type":"hardBreak"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"7d3cdad4-6684-4bda-bfbd-808efc900316"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"5b3bcab3-94eb-4847-868a-45bbb0fd711d"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Features and Capabilities","type":"text"}]},{"type":"paragraph","content":[{"text":"For Linux operating systems, Vortex Studio applications support the simulation of dynamics models and a basic visualization rendering for debugging. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multibody dynamics","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Terrain","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Powertrain modeling","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Advanced tire modeling","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rigid tracks","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flexible tracks","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cable systems","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Earthwork systems","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Python 3","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Python 2 is no longer supported on Linux since 2022.2. Please see ","type":"text"},{"text":"Converting Python 2 scripts to Python 3 Dynamics Script","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317370207#Python3Scripting-convertingToDynamicsScriptConvertingPython2scriptstoPython3DynamicsScript"}}]}]},{"type":"paragraph","content":[{"text":"While it is possible to create content in code, it is strongly recommended to use the Vortex Studio Editor on Windows to create your content that is going to run on the Linux platform.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Features and Capabilities Overview","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317379884"}}]},{"text":" for all available features of Vortex Studio.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"2022.8 is the last version supporting CentOS7 or equivalent. An update to the latest Ubuntu LTS and equivalent systems is in progress.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Vortex Studio on Linux can only open content created on Vortex Studio (Windows) 2023.3 or earlier. This will be fixed in a later release. For the moment, use an earlier version of Vortex Studio on Windows to create content to work on Linux. The recommended version and the last supported version of Linux is 2022.8 and the same version on Windows needs to be used for the best results.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"The Linux version does not contain all the Vortex Applications such as the Vortex Editor.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible however to edit on the Windows platform and bring your content to a Linux-based simulator.","type":"text"}]},{"type":"paragraph","content":[{"text":"Distributed simulation is not possible on Linux and it contains a subset of the SDK. ","type":"text"}]},{"type":"paragraph","content":[{"text":"See above for more details","type":"text"}]},{"type":"paragraph","content":[{"text":"To install ","type":"text","marks":[{"type":"strong"}]},{"text":"Vortex Studio","type":"text"},{"text":" on Linux:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a destination directory in your desired location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate into the directory you just created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the following:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

tar -xzvf /<your directory>/Vortex_Studio_*_x64_gcc73.tar.gz

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"tar","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-xzvf /","type":"text","marks":[{"type":"code"}]},{"text":"/Vortex_Studio_","type":"text","marks":[{"type":"code"}]},{"text":"*_x64_gcc73.","type":"text","marks":[{"type":"code"}]},{"text":"tar","type":"text","marks":[{"type":"code"}]},{"text":".gz","type":"text","marks":[{"type":"code"}]}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Licensing","type":"text"}]},{"type":"paragraph","content":[{"text":"Vortex Studio licensing is the same on Windows and Linux, but the tools are slightly different. The following links give you an overview of the Vortex Studio Licensing.","type":"text"}]},{"type":"paragraph","content":[{"text":"Vortex Studio Licensing","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317368851"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Node-lock Licenses","type":"text"}]},{"type":"paragraph","content":[{"text":"Generating Node-Locked LicenseFiles on Linux","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317369885#GeneratingNode-LockedLicenseFiles-GeneratingNode-LockedLicenseFilesonLinux"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Floating Licenses","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"License Server","type":"text"}]},{"type":"paragraph","content":[{"text":"Setting Up a License Server on Linux","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317380713#LicenseServerSetup-SettingUpaLicenseServeronLinux"}}]}]},{"type":"paragraph","content":[{"text":"Generating Floating License Files for a License Server on Linux","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317377688#GeneratingFloatingLicenseFiles-GeneratingFloatingLicenseFilesforaLicenseServeronLinux"}}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Connecting to a License server","type":"text"}]},{"type":"paragraph","content":[{"text":"Connecting your Computer to a License Server on Linux","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317377688#GeneratingFloatingLicenseFiles-ConnectingyourComputertoaLicenseServeronLinux"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Running a Simulation with Vortex","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup file","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio Director isn't supported on Linux so it is not possible to launch a simulator in Linux from it. On Linux, it is only possible to launch a dynamics simulation using that basic Simapp process and a custom-made application.","type":"text"}]},{"type":"paragraph","content":[{"text":"Simapp is a single Vortex application that can simulate Vortex Content. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When starting a simapp process on Linux, if no setup file is provided, it will use the default s","type":"text"},{"text":"imapp_DynamicsOnly.vxc ","type":"text","marks":[{"type":"em"}]},{"text":"from the resources folder. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This setup file contains only a Dynamics module and the Earthworks systems module. ","type":"text"}]},{"type":"paragraph","content":[{"text":"To create your own setup file, you need to use the ","type":"text"},{"text":"Vortex Studio Editor","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317374301"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Content ","type":"text"}]},{"type":"paragraph","content":[{"text":"To create content for your simulation, you must use the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Vortex Studio Editor","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317380994"}}]},{"text":" on Windows. The content saved must be copied or shared with the Linux system, with the same folder hierarchy.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"File paths in Vortex are always saved relative to one another unless there is no relative path possible or a path is defined as absolute manually.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Running a simulation","type":"text"}]},{"type":"paragraph","content":[{"text":"Content files to load can be given as command-line arguments to the simapp process. Since not all features are supported on Linux, like graphics, these extensions will be disabled on Linux.","type":"text"}]},{"type":"paragraph","content":[{"text":"To start the simulation, invoke the Simapp process from the command line and pass the content files to load. Use argument --config to specify the setup file to use.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# ./SimApp myScene.vxscene --config mySetup.vxc","type":"text"}]},{"type":"paragraph","content":[{"text":"Some information will be displayed in the console as the simulation runs, according to the logging level.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the argument --config is omitted, the setup file s","type":"text"},{"text":"imapp_DynamicsOnly.vxc ","type":"text","marks":[{"type":"em"}]},{"text":"from the resources folder will be used. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Automatic Content Loading","type":"text"}]},{"type":"paragraph","content":[{"text":"Our user guide indicates that it is preferable to load content while the application is in editing mode and when running the simulation to go in simulating mode. The default setup file s","type":"text"},{"text":"imapp_DynamicsOnly.vxc","type":"text","marks":[{"type":"em"}]},{"text":" sets the application mode to simulation as there is no way to change the mode from the command line. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The content loader extension can be added to the application via the setup file. When properly set, the content specified will be loaded while the application is in editing mode and start the simulation afterward, regardless of the application starting mode. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The content loader extension can be saved using absolute Linux paths, but if the content files defined in the Content Loader are relative to the setup file on disk when everything is copied or shared on Linux over, the relative paths will be kept and everything will be loaded properly.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Content Loader","type":"text","marks":[{"type":"link","attrs":{"href":"http://confluence:8090/display/VSD22/Vortex+Studio+Application+Extensions+and+Modules#VortexStudioApplicationExtensionsandModules-ContentLoader"}}]},{"text":" for more details.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Stopping the simulation","type":"text"}]},{"type":"paragraph","content":[{"text":"Ctrl + C ","type":"text","marks":[{"type":"strong"}]},{"text":"will stop the command running Vortex.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Debugging a simulation","type":"text"}]},{"type":"paragraph","content":[{"text":"The remote Debugger is the preferred way to debug simulations on Linux. The remote debugger is a Windows application that connects via the network to gather information about the simulation.","type":"text"}]},{"type":"paragraph","content":[{"text":"The setup file must be set to Enable Remote Access with a properly defined Listening Port. Use this setup file to start the simulation again and connect from your Windows PC.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the ","type":"text"},{"text":"Remote Debugger User Guide","type":"text","marks":[{"type":"link","attrs":{"href":"http://confluence:8090/display/VSD22/Remote+Debugger+User+Guide"}}]},{"text":" for more information. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Python remote debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also use ","type":"text"},{"text":"grpc ","type":"text","marks":[{"type":"strong"}]},{"text":"with Python and the connection should work. ","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Remote debugging with Python","type":"text","marks":[{"type":"link","attrs":{"href":"http://confluence:8090/display/VSD22/Remote+debugging+with+Python"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Additional information","type":"text"}]},{"type":"paragraph","content":[{"text":"Simulating with Vortex on Windows Subsystem for Linux - WSL2","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD236/pages/3317369410"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tutorials","type":"text"}]},{"type":"paragraph","content":[{"text":"Not all tutorials are available on Linux. Some C++ tutorials are available but it is possible that some features are not working.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Python tutorials are only available on Windows. They can be made to run but some will require modification as not all features are available. ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported