First, it's worth explaining the relationship between the material properties that Orca3D maintains in the model file and those in the Material Library. When a model is read into Rhino, Orca3D compares the materials used in the model file to those in the library. If there is a match, the properties from the library are used. This is so that if you have modified the data in your library (changed the weight density, for example) your design will reflect the updated data. A match is determined by a unique identifier (UUID) that is maintained for each property, not by the name of the material.
If a match is not found for a material, then the properties which are stored in the 3dm file are used, and they become static (i.e., they cannot be changed). An advantage of this system is that if you send your model to another Orca3D user, the materials in your model will not be changed by the values in the other user's library, even if there are materials of the same name.
So, you find yourself with a 3dm file that contains Orca3D materials that you'd like to add to your library, either because your library was lost (e.g., in a hard disk crash), or you received a model from someone else with some useful material data in it. These are the steps to follow. Don't be intimidated by the number and detail of the steps; it's really quite simple.
- Open the model in Rhino, and generate an Orca3D weight report using all objects.
- From the weight report, export to an Excel file using the ReportViewer's built in export capability.
- Copy sheet 3 of that export to a new Excel workbook.
- The data in this new workbook must be edited to match the format required to import it into the Orca3D Material Library. The easiest way to do this is to export the current Material Library from Orca3D (you will probably want to make sure you have at least one material of each type in your Material Library before exporting, even if they are "dummy" materials, just so you have something in the export to use as a reference):
- In Rhino, in the Orca3D menu, select Weight/Cost -> Export Material Library
- In the Save As dialog, set the "Save as type" to CSV files, and save the file
Finally, if you ever want to back up your Orca3D Material Library, look for the file "StockMaterialLibrary.xml." In Windows 7 and later, it will be in c:\ProgramData\DRSC3ATC\Orca3D. In Windows XP and earlier it will be in C:\Documents and Settings\All Users\Application Data\DRSC3ATC\Orca3D. You'll see some other files here worth backing up as well, including your hull assistant definitions, in the file Orca3DHullAssistants.xml, and stability criteria (Orca3DStabilityCriteria.xml).