## On this page

  

 

 # Import

 Last update: 16.07.2025 

Parse files and import data. [More...](#details)

## <a name="nested-classes"></a>Classes

class [CreateSimulationArchive](class_create_simulation_archive.xhtml) A struct collecting export information for random field simulation data. [More...](class_create_simulation_archive.xhtml#details)  
 class [ImportCoP](class_import_co_p.xhtml) imports [CoP](struct_co_p.xhtml "Reference implementation for a quality metric for MOP models. ") values of amplitudes from CSV file [More...](class_import_co_p.xhtml#details)  
 class [ImportCSV](class_import_c_s_v.xhtml) A class collecting import information for a csv file. [More...](class_import_c_s_v.xhtml#details)  
 class [ImportDesigns](class_import_designs.xhtml) A class collecting import information for various design directories. [More...](class_import_designs.xhtml#details)  
 struct [ImportItemInfo](struct_import_item_info.xhtml) defines a data item which was found in an input file [More...](struct_import_item_info.xhtml#details)  
 struct [ImportOMDB](struct_import_o_m_d_b.xhtml) Stores settings for loading optiSLang omdb files. Limited to scalar parameters and responses. [More...](struct_import_o_m_d_b.xhtml#details)  
 struct [ImportOptiSLangBinary](struct_import_opti_s_lang_binary.xhtml) stores settings for loading optiSLang binary files [More...](struct_import_opti_s_lang_binary.xhtml#details)  
 class [ImportOptiSLangSignal](class_import_opti_s_lang_signal.xhtml) Sets up an SoS project for a single user defined optiSLang 3 signal identifier. [More...](class_import_opti_s_lang_signal.xhtml#details)  
 class [ImportSRBProject](class_import_s_r_b_project.xhtml) Import a Twin Builder Static ROM Builder (SRB) project. Expects a valid SRB project directory as input. [More...](class_import_s_r_b_project.xhtml#details)  
 struct [LoadDataBaseSettings](struct_load_data_base_settings.xhtml) stores settings for [loadDataBase()](group__import.xhtml#ga70a2e69b4c13a55f2ce33aa4c3b2d4d7 "loads data into database from file. The data will be replaced ") [More...](struct_load_data_base_settings.xhtml#details)  
 class [ModifyMeshBase](class_modify_mesh_base.xhtml) Base settings that are provided for all modifier classes that change mesh coorsinates. [More...](class_modify_mesh_base.xhtml#details)  
 class [PrepareRandomFieldSimulation](class_prepare_random_field_simulation.xhtml) A struct collecting export information for random field simulation data. [More...](class_prepare_random_field_simulation.xhtml#details)  
 class [ReferenceDesign](class_reference_design.xhtml) defines information on imported data and files given a reference design [More...](class_reference_design.xhtml#details)  
 ## <a name="func-members"></a>Functions

[MetaStructure](class_meta_structure.xhtml) [createSimpleStructuredGrid](group__import.xhtml#gad28feb79a0fc788de320a476a0d7cb7b) (number num\_x, number min\_x, number max\_x, number num\_y=1, number min\_y=0.0, number max\_y=0.0, number num\_z=1, number min\_z=0.0, number max\_z=0.0) creates a structured grid in 1d/2d/3d using equal node spacing along each axis direction [More...](#gad28feb79a0fc788de320a476a0d7cb7b)  
  [importElementSet\_CSV](group__import.xhtml#ga66ceb34a6bc68c6993953ffd67ce97a6) ([MetaStructure](class_meta_structure.xhtml) meta, string ident, string filename) Imports an element set from a CSV file. [More...](#ga66ceb34a6bc68c6993953ffd67ce97a6)  
  [importElementSet\_CSV](group__import.xhtml#gafdbef8d8935b5de6bd9377dccb7be86b) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string ident, string filename) Imports a element set from a CSV file. [More...](#gafdbef8d8935b5de6bd9377dccb7be86b)  
  [importElementSet\_Indices](group__import.xhtml#gabf01fed99ffd7261b2027a3ae856c530) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string ident, [Matrix](class_matrix.xhtml) indices) Imports a element set from a given index vector. [More...](#gabf01fed99ffd7261b2027a3ae856c530)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_2dGrid](group__import.xhtml#gad78c8096f803a0008c9e4b4d3b330f1f) (string filename) Imports the 2D mesh from a single CSV-Grid file. [More...](#gad78c8096f803a0008c9e4b4d3b330f1f)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_3dGrid](group__import.xhtml#ga0cc4f14b2aaa45983256eb28f0ed3c16) (string filename) Imports the 3D mesh from a single CSV-Grid file. [More...](#ga0cc4f14b2aaa45983256eb28f0ed3c16)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_Abaqus](group__import.xhtml#ga40fccd0835da19ea4dd0d995608be09f) (string filename) Imports the mesh from a single Abaqus file. [More...](#ga40fccd0835da19ea4dd0d995608be09f)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_ANSYS\_APDL](group__import.xhtml#ga40963f4f654afc7ae4906dce1f40d185) (string filename) Imports the mesh from a single ANSYS APDL input file. [More...](#ga40963f4f654afc7ae4906dce1f40d185)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_ANSYS\_RST](group__import.xhtml#ga32b4fc9148e08b68c4c9274915504e44) (string filename) Imports the mesh from a single ANSYS RST file. [More...](#ga32b4fc9148e08b68c4c9274915504e44)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_Fluent\_CSV](group__import.xhtml#ga16be129594b837ef9be8be31935578ee) (string filename) Imports the mesh from a single FLUENT CSV point cloud file. [More...](#ga16be129594b837ef9be8be31935578ee)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_Image](group__import.xhtml#gada330b78853aa13ca6ceb329344d6f34) (string filename) imports the mesh from a single pixel-image file [More...](#gada330b78853aa13ca6ceb329344d6f34)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_LSDynaK](group__import.xhtml#ga1b3d4d7a9aa07b994d5788f64dce55a3) (string filename) imports the mesh from a single LS-DYNA K file [More...](#ga1b3d4d7a9aa07b994d5788f64dce55a3)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_Nastran](group__import.xhtml#gaa36ee87ffdbd091817b26c2dc035a9b8) (string filename) imports the mesh from a single Nastran file [More...](#gaa36ee87ffdbd091817b26c2dc035a9b8)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_PERMAS](group__import.xhtml#gaef57434c059ee8e1b9072d2edf8be248) (string filename) Imports the mesh from a single PERMAS file. [More...](#gaef57434c059ee8e1b9072d2edf8be248)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_Signal](group__import.xhtml#gaeb71fd0d6c0d94526ddf10f296d8c44f) (string filename) Imports the mesh from a single CSV-Signal file. [More...](#gaeb71fd0d6c0d94526ddf10f296d8c44f)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_SRB](group__import.xhtml#gaea678feba221b77bf7ccde1ae3f4fcaa) (string filename) Imports the mesh from a Static ROM Builder points.bin file. [More...](#gaea678feba221b77bf7ccde1ae3f4fcaa)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_STL](group__import.xhtml#gab1c0c8bcc655f87c7493d19de8b3aa0d) (string filename, bool merge\_nodes=true, number relative\_node\_distance=1e-4) imports the mesh from a single STL file (either ASCII or binary) [More...](#gab1c0c8bcc655f87c7493d19de8b3aa0d)  
 [MetaStructure](class_meta_structure.xhtml) [importMesh\_VTK](group__import.xhtml#ga70974560197a992fc4d14f8e48794833) (string filename) Imports the mesh from a single VTK file. [More...](#ga70974560197a992fc4d14f8e48794833)  
  [importNodeSet\_CSV](group__import.xhtml#gac974302ab2a7cfee453d7336553b9feb) ([MetaStructure](class_meta_structure.xhtml) meta, string ident, string filename) Imports a node set from a CSV file. [More...](#gac974302ab2a7cfee453d7336553b9feb)  
  [importNodeSet\_CSV](group__import.xhtml#ga7eec79f2e97c458c456e8dedeb5f33ce) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string ident, string filename) Imports a node set from a CSV file. [More...](#ga7eec79f2e97c458c456e8dedeb5f33ce)  
  [importNodeSet\_Indices](group__import.xhtml#ga2bb1834a5c2918fb740e7a08b4b39162) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), string part\_ident, string ident, [Matrix](class_matrix.xhtml) indices) Imports a node set from a given index vector. [More...](#ga2bb1834a5c2918fb740e7a08b4b39162)  
  [loadDataBase](group__import.xhtml#ga70a2e69b4c13a55f2ce33aa4c3b2d4d7) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [LoadDataBaseSettings](struct_load_data_base_settings.xhtml) settings) loads data into database from file. The data will be replaced [More...](#ga70a2e69b4c13a55f2ce33aa4c3b2d4d7)  
 [ReferenceDesign](class_reference_design.xhtml) [referenceDesign](group__import.xhtml#gaeebdfe2e2b08f67a2a3e5c9873171679) () gives access to the reference design information [More...](#gaeebdfe2e2b08f67a2a3e5c9873171679)  
  [setReferenceMesh](group__import.xhtml#ga380830b2ab7587d1c03c5ea245d0d139) ([Structure](class_structure.xhtml) [database](group__data.xhtml#gaebcac3a2836ec9fdf2e47bd812994b6b), [MetaStructure](class_meta_structure.xhtml) mesh, bool do\_create\_mesh=true) sets the reference mesh It throws an exception if this is somehow not possible. [More...](#ga380830b2ab7587d1c03c5ea245d0d139)  
 <a id="details" name="details"></a>## Detailed Description

Parse files and import data.

## Function Documentation

<a id="gad28feb79a0fc788de320a476a0d7cb7b"></a>## [◆ ](#gad28feb79a0fc788de320a476a0d7cb7b)createSimpleStructuredGrid()

 [MetaStructure](class_meta_structure.xhtml) createSimpleStructuredGrid  ( number  *num\_x*,    number  *min\_x*,    number  *max\_x*,    number  *num\_y* = `1`,    number  *min\_y* = `0.0`,    number  *max\_y* = `0.0`,    number  *num\_z* = `1`,    number  *min\_z* = `0.0`,    number  *max\_z* = `0.0`   ) 

creates a structured grid in 1d/2d/3d using equal node spacing along each axis direction

Parameters num\_xnumber of grid points along x axis min\_xsmallest coordinate along x axis max\_xlargest coordinate along x axis num\_ynumber of grid points along y axis min\_ysmallest coordinate along y axis max\_ylargest coordinate along y axis num\_znumber of grid points along z axis min\_zsmallest coordinate along z axis max\_zlargest coordinate along z axis Returnsa meta structure containing the grid 



<a id="ga66ceb34a6bc68c6993953ffd67ce97a6"></a>## [◆ ](#ga66ceb34a6bc68c6993953ffd67ce97a6)importElementSet\_CSV() \[1/2\]

 importElementSet\_CSV  ( [MetaStructure](class_meta_structure.xhtml)  *meta*,    string  *ident*,    string  *filename*   ) 

Imports an element set from a CSV file.

Parameters metaThe meta structure to which the set definition shall be added to identThe ident string that shall be used for the imported set definition filenameThe absolute CSV file path where the set definition can be found 



<a id="gafdbef8d8935b5de6bd9377dccb7be86b"></a>## [◆ ](#gafdbef8d8935b5de6bd9377dccb7be86b)importElementSet\_CSV() \[2/2\]

 importElementSet\_CSV  ( [Structure](class_structure.xhtml)  *database*,    string  *part\_ident*,    string  *ident*,    string  *filename*   ) 

Imports a element set from a CSV file.

Parameters databaseThe database to which the set definition shall be added to part\_identThe part\_ident string that shall be used for the imported set definition identThe ident string that shall be used for the imported set definition filenameThe absolute CSV file path where the set definition can be found 



<a id="gabf01fed99ffd7261b2027a3ae856c530"></a>## [◆ ](#gabf01fed99ffd7261b2027a3ae856c530)importElementSet\_Indices()

 importElementSet\_Indices  ( [Structure](class_structure.xhtml)  *database*,    string  *part\_ident*,    string  *ident*,    [Matrix](class_matrix.xhtml)  *indices*   ) 

Imports a element set from a given index vector.

Parameters databaseThe database to which the set definition shall be added to part\_identThe part\_ident string that shall be used for the imported set definition identThe ident string that shall be used for the imported set definition indicesThe global indices (with respect to the current reference element set) 



<a id="gad78c8096f803a0008c9e4b4d3b330f1f"></a>## [◆ ](#gad78c8096f803a0008c9e4b4d3b330f1f)importMesh\_2dGrid()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_2dGrid  ( string  *filename*) 

Imports the 2D mesh from a single CSV-Grid file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="ga0cc4f14b2aaa45983256eb28f0ed3c16"></a>## [◆ ](#ga0cc4f14b2aaa45983256eb28f0ed3c16)importMesh\_3dGrid()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_3dGrid  ( string  *filename*) 

Imports the 3D mesh from a single CSV-Grid file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="ga40fccd0835da19ea4dd0d995608be09f"></a>## [◆ ](#ga40fccd0835da19ea4dd0d995608be09f)importMesh\_Abaqus()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_Abaqus  ( string  *filename*) 

Imports the mesh from a single Abaqus file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="ga40963f4f654afc7ae4906dce1f40d185"></a>## [◆ ](#ga40963f4f654afc7ae4906dce1f40d185)importMesh\_ANSYS\_APDL()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_ANSYS\_APDL  ( string  *filename*) 

Imports the mesh from a single ANSYS APDL input file.

Parameters filenameDefines the result file path ReturnsA meta structure containing the mesh 



<a id="ga32b4fc9148e08b68c4c9274915504e44"></a>## [◆ ](#ga32b4fc9148e08b68c4c9274915504e44)importMesh\_ANSYS\_RST()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_ANSYS\_RST  ( string  *filename*) 

Imports the mesh from a single ANSYS RST file.

Parameters filenameDefines the result file path ReturnsA meta structure containing the mesh 



<a id="ga16be129594b837ef9be8be31935578ee"></a>## [◆ ](#ga16be129594b837ef9be8be31935578ee)importMesh\_Fluent\_CSV()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_Fluent\_CSV  ( string  *filename*) 

Imports the mesh from a single FLUENT CSV point cloud file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="gada330b78853aa13ca6ceb329344d6f34"></a>## [◆ ](#gada330b78853aa13ca6ceb329344d6f34)importMesh\_Image()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_Image  ( string  *filename*) 

imports the mesh from a single pixel-image file

Parameters filenamedefines the input file Returnsa meta structure containing the mesh 



<a id="ga1b3d4d7a9aa07b994d5788f64dce55a3"></a>## [◆ ](#ga1b3d4d7a9aa07b994d5788f64dce55a3)importMesh\_LSDynaK()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_LSDynaK  ( string  *filename*) 

imports the mesh from a single LS-DYNA K file

Parameters filenamedefines the input file Returnsa meta structure containing the mesh 



<a id="gaa36ee87ffdbd091817b26c2dc035a9b8"></a>## [◆ ](#gaa36ee87ffdbd091817b26c2dc035a9b8)importMesh\_Nastran()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_Nastran  ( string  *filename*) 

imports the mesh from a single Nastran file

Parameters filenamedefines the input file Returnsa meta structure containing the mesh 



<a id="gaef57434c059ee8e1b9072d2edf8be248"></a>## [◆ ](#gaef57434c059ee8e1b9072d2edf8be248)importMesh\_PERMAS()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_PERMAS  ( string  *filename*) 

Imports the mesh from a single PERMAS file.

Parameters filenamedefines the input file ReturnsA meta structure containing the mesh 



<a id="gaeb71fd0d6c0d94526ddf10f296d8c44f"></a>## [◆ ](#gaeb71fd0d6c0d94526ddf10f296d8c44f)importMesh\_Signal()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_Signal  ( string  *filename*) 

Imports the mesh from a single CSV-Signal file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="gaea678feba221b77bf7ccde1ae3f4fcaa"></a>## [◆ ](#gaea678feba221b77bf7ccde1ae3f4fcaa)importMesh\_SRB()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_SRB  ( string  *filename*) 

Imports the mesh from a Static ROM Builder points.bin file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="gab1c0c8bcc655f87c7493d19de8b3aa0d"></a>## [◆ ](#gab1c0c8bcc655f87c7493d19de8b3aa0d)importMesh\_STL()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_STL  ( string  *filename*,    bool  *merge\_nodes* = `true`,    number  *relative\_node\_distance* = `1e-4`   ) 

imports the mesh from a single STL file (either ASCII or binary)

Parameters filenamedefines the input file Returnsa meta structure containing the mesh Parameters merge\_nodesDefines if nodes with nearly identrical coordinates are merged. If false, each node belongs to eactly one element. If true, one may erroneously merge nodes which do not belong together (eg. if two separate bodies are very close to each other) relative\_node\_distanceThe minimum relative distance between two nodes. If a distance between two nodes is below the tolerance, the nodes will be merged. The distance is defined by this factor multiplied with the largest triangle edge length in the model. 



<a id="ga70974560197a992fc4d14f8e48794833"></a>## [◆ ](#ga70974560197a992fc4d14f8e48794833)importMesh\_VTK()

 [MetaStructure](class_meta_structure.xhtml) importMesh\_VTK  ( string  *filename*) 

Imports the mesh from a single VTK file.

Parameters filenameDefines the input file ReturnsA meta structure containing the mesh 



<a id="gac974302ab2a7cfee453d7336553b9feb"></a>## [◆ ](#gac974302ab2a7cfee453d7336553b9feb)importNodeSet\_CSV() \[1/2\]

 importNodeSet\_CSV  ( [MetaStructure](class_meta_structure.xhtml)  *meta*,    string  *ident*,    string  *filename*   ) 

Imports a node set from a CSV file.

Parameters metaThe meta structure to which the set definition shall be added to identThe ident string that shall be used for the imported set definition filenameThe absolute CSV file path where the set definition can be found 



<a id="ga7eec79f2e97c458c456e8dedeb5f33ce"></a>## [◆ ](#ga7eec79f2e97c458c456e8dedeb5f33ce)importNodeSet\_CSV() \[2/2\]

 importNodeSet\_CSV  ( [Structure](class_structure.xhtml)  *database*,    string  *part\_ident*,    string  *ident*,    string  *filename*   ) 

Imports a node set from a CSV file.

Parameters databaseThe database to which the set definition shall be added to part\_identThe part\_ident string that shall be used for the imported set definition identThe ident string that shall be used for the imported set definition filenameThe absolute CSV file path where the set definition can be found 



<a id="ga2bb1834a5c2918fb740e7a08b4b39162"></a>## [◆ ](#ga2bb1834a5c2918fb740e7a08b4b39162)importNodeSet\_Indices()

 importNodeSet\_Indices  ( [Structure](class_structure.xhtml)  *database*,    string  *part\_ident*,    string  *ident*,    [Matrix](class_matrix.xhtml)  *indices*   ) 

Imports a node set from a given index vector.

Parameters databaseThe database to which the set definition shall be added to part\_identThe part\_ident string that shall be used for the imported set definition identThe ident string that shall be used for the imported set definition indicesThe global indices (with respect to the current reference node set) 



<a id="ga70a2e69b4c13a55f2ce33aa4c3b2d4d7"></a>## [◆ ](#ga70a2e69b4c13a55f2ce33aa4c3b2d4d7)loadDataBase()

 loadDataBase  ( [Structure](class_structure.xhtml)  *database*,    [LoadDataBaseSettings](struct_load_data_base_settings.xhtml)  *settings*   ) 

loads data into database from file. The data will be replaced

Parameters settingscontains the settings databasethe database where all objects are to be stored 



<a id="gaeebdfe2e2b08f67a2a3e5c9873171679"></a>## [◆ ](#gaeebdfe2e2b08f67a2a3e5c9873171679)referenceDesign()

 [ReferenceDesign](class_reference_design.xhtml) referenceDesign  ( ) 

gives access to the reference design information

Returnsa reference to the object stored in See alsoapplication\_data 



<a id="ga380830b2ab7587d1c03c5ea245d0d139"></a>## [◆ ](#ga380830b2ab7587d1c03c5ea245d0d139)setReferenceMesh()

 setReferenceMesh  ( [Structure](class_structure.xhtml)  *database*,    [MetaStructure](class_meta_structure.xhtml)  *mesh*,    bool  *do\_create\_mesh* = `true`   ) 

sets the reference mesh It throws an exception if this is somehow not possible.

Parameters meshthe reference mesh as a meta structure databasethe database to be modified do\_create\_meshIf this is false, then no FEM mesh is built up from the meta structure. Use this mode carefully, since SoS GUI, visualization and algorithms may not work properly. This mode is used for fast simulation of random field designs.