EditMaterial

Modifies an existing material.

UI Access

View/Edit Materials command in the material editor

Parameters

Name	Type	Description
<OriginalName>	String	Name of the material before editing.
<MatProperties>	Array	Structured array containing material properties: [ "NAME:<New material name>", "CoordinateSystemType:=", <string>, "BulkOrSurfaceType:=" , <integer>, [ "NAME:PhysicsTypes", "set:=" , <array containing string physics types> ], <Optional ModifierDataArray>, "permeability:=" , <string containing value>, "conductivity:=" , <string containing value>, "thermal_conductivity:=", <string containing value>, "mass_density:=" , <string containing value>, "specific_heat:=" , <string containing value>, "youngs_modulus:=" , <string containing value>, "poissons_ratio:=" , <string containing value>, "thermal_expansion_coefficient:=", <string containing value> ]
<ModifierDataArray>	Array	Optional structured array containing thermal or spatial modifiers: [ "NAME:ModifierData", [ "NAME:<ThermalModifierData or SpatialModifierData>", "modifier_data:=" , <"thermal_modifier_data" or "spatial_modifier_data">, [ "NAME:<all_thermal_modifiers or all_spatial_modifiers>", [ "NAME:<modifierName>", "Property::=" , <string property being modified>, "Index::=" , <integer>, "prop_modifier:=" , <"thermal_modifier" or "spatial_modifier">, "use_free_form:=" , <Boolean>, "free_form_value:=" , <string modifier value>, ] ] ] ]

Return Value

None.

Python Syntax

EditMaterial (<OriginalName>, <MatProperties>)

Python Example

Without Modifiers:

oDefinitionManager.EditMaterial("alumina_92pct", 
[
"NAME:alumina_92pct",
"CoordinateSystemType:=" , "Cartesian",
"BulkOrSurfaceType:=" , 1,
[
"NAME:PhysicsTypes",
"set:=" , ["Electromagnetic","Thermal","Structural"]
],
"permittivity:=" , "9.3",
"dielectric_loss_tangent:=" , "0.008",
"thermal_conductivity:=" , "26",
"mass_density:=" , "3720",
"specific_heat:=" , "790",
"youngs_modulus:=" , "267000000000",
"poissons_ratio:=" , "0.26",
"thermal_expansion_coeffcient:=", "7.2e-006"
]
)

With Thermal Modifier:


oDefinitionManager.EditMaterial("copper",
[
"NAME:copper",
"CoordinateSystemType:=", "Cartesian",
"BulkOrSurfaceType:=" , 1,
[
"NAME:PhysicsTypes",
"set:="	, ["Electromagnetic","Thermal","Structural"]
],
[
"NAME:ModifierData",
[
"NAME:ThermalModifierData",
"modifier_data:=" , "thermal_modifier_data",
[
"NAME:all_thermal_modifiers",
[
"NAME:one_thermal_modifier",
"Property::=" , "permittivity",
"Index::=" , 0,
"prop_modifier:=" , "thermal_modifier",
"use_free_form:=" , True,
"free_form_value:=" , "if(Temp > 1000cel, 1, if(Temp < -273.15cel, 1, 1))"
]
]
]
],
"permeability:=" , "0.999991",
"conductivity:=" , "58000000",
"thermal_conductivity:=" , "400",
"mass_density:=" , "8933",
"specific_heat:=" , "385",
"youngs_modulus:=" , "120000000000",
"poissons_ratio:=" , "0.38",
"thermal_expansion_coefficient:=" , "1.77e-05"
])
Transient Solve, Non-linear Drude Data Plasma 
import ScriptEnv
ScriptEnv.Initialize("Ansoft.ElectronicsDesktop")
oDesktop.RestoreWindow()
oProject = oDesktop.SetActiveProject("Drude_plasma_parameters_r231")
oDefinitionManager = oProject.GetDefinitionManager()
oDefinitionManager.EditMaterial("Drude",
[
"NAME:Drude",
"CoordinateSystemType:=", "Cartesian",
"BulkOrSurfaceType:="	, 1,
[
"NAME:PhysicsTypes",
"set:="			, ["Electromagnetic"]
],
[
"NAME:AttachedData",
[
"NAME:MatNonLinearDrudeFreqDepData",
"property_data:="	, "nonlinear_drude_data",
"EpsilonInfinity:="	, "1",
"PlasmaFrequency:="	, "4.62348462366278GHz",
"CollisionFrequency:="	, "0.00054491190162662GHz",
"FieldBreakdown:="	, "10000V_per_meter",
"PlasmaMaintainFrequency:=", "2.31174231183139GHz",
"NeutralDensity:="	, 2.65164580488373E+20,
"ElectronDensity:="	, 2.65164580488373E+17,
"CollisionRateConstant:=", 2.05499505485618E-15
]
]
])