ReferenceAvailable
Piezoelectricity
div(sigma)+F=rho*d2u/dt2; div(D)=rho_q; sigma=C:strain-e^T E; D=e:strain+eps E
Reference
| Field | Value | Description |
|---|---|---|
| area | Structural Mechanics / AC/DC | — |
| boundaryFeatures | [{"assemblyRole":"essential","displayName":"Fixed Constraint","entityDimensions":["domain","boundary","edge","point"],"fields":[{"default":["0[m]","0[m]","0[m]"],"name":"value","required":true,"unit":"m","valueType":"vector"},{"default":[true,true,true],"name":"components","required":true,"valueType":"vector"}],"kind":"Fixed Constraint","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"u"},{"assemblyRole":"flux","displayName":"Boundary Load","entityDimensions":["boundary"],"fields":[{"default":["0[N/m^2]","0[N/m^2]","0[N/m^2]"],"name":"value","required":true,"unit":"N/m^2","valueType":"vector"}],"kind":"Boundary Load","multiple":true,"parentCategory":"physics","role":"contributing","targetField":"u"},{"assemblyRole":"essential","displayName":"Prescribed Displacement","entityDimensions":["boundary","edge","point"],"fields":[{"default":"0[m]","name":"ux","required":true,"unit":"m","valueType":"scalar"},{"default":"0[m]","name":"uy","required":true,"unit":"m","valueType":"scalar"},{"default":"0[m]","name":"uz","required":true,"unit":"m","valueType":"scalar"},{"default":[true,true,true],"name":"components","required":true,"valueType":"vector"}],"kind":"Prescribed Displacement","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"u"},{"assemblyRole":"flux","displayName":"Edge Load","entityDimensions":["edge"],"fields":[{"default":["0[N/m]","0[N/m]","0[N/m]"],"name":"value","required":true,"unit":"N/m","valueType":"vector"}],"kind":"Edge Load","multiple":true,"parentCategory":"physics","role":"contributing","targetField":"u"},{"assemblyRole":"point-source","displayName":"Point Load","entityDimensions":["point"],"fields":[{"default":["0[N]","0[N]","0[N]"],"name":"value","required":true,"unit":"N","valueType":"vector"}],"kind":"Point Load","multiple":true,"parentCategory":"physics","role":"contributing","targetField":"u"},{"assemblyRole":"essential","displayName":"Ground","entityDimensions":["boundary","point"],"fields":{},"kind":"Ground","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"V"},{"assemblyRole":"essential","displayName":"Electric Potential","entityDimensions":["boundary","point"],"fields":[{"default":"0[V]","name":"value","required":true,"unit":"V","valueType":"expression"}],"kind":"Electric Potential","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"V"},{"assemblyRole":"essential","displayName":"Terminal","entityDimensions":["boundary","domain"],"fields":[{"default":"Terminal 1","name":"name","required":true,"valueType":"string"},{"default":"0[V]","name":"value","required":true,"unit":"V","valueType":"expression"},{"default":"","name":"circuitNode","required":false,"valueType":"string"}],"kind":"Terminal","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"V"},{"assemblyRole":"flux","displayName":"Surface Charge Density","entityDimensions":["boundary"],"fields":[{"default":"0[C/m^2]","name":"value","required":true,"unit":"C/m^2","valueType":"expression"}],"kind":"Surface Charge Density","multiple":true,"parentCategory":"physics","role":"contributing","targetField":"V"}] | — |
| childCategories | ["physics.domain","physics.boundary"] | — |
| defaultMaterial | PZT-5H | — |
| displayName | Piezoelectricity | — |
| domainFeatures | [{"assemblyRole":"material","displayName":"Piezoelectric Material","entityDimensions":["domain"],"fields":[{"default":"","name":"Material","required":true,"valueType":"material"},{"default":[[1.0,0.0,0.0],[0.0,1.0,0.0],[0.0,0.0,1.0]],"name":"Material orientation","required":true,"valueType":"matrix"}],"kind":"Piezoelectric Material","multiple":true,"parentCategory":"physics","required":true},{"assemblyRole":"volume-source","displayName":"Body Load and Charge","entityDimensions":["domain"],"fields":[{"default":[0.0,0.0,0.0,0.0],"name":"value","required":false,"valueType":"vector"}],"kind":"Body Load and Charge","multiple":true,"parentCategory":"physics","required":false},{"assemblyRole":"volume-source","displayName":"Body Load","entityDimensions":["domain"],"fields":[{"default":["0[N/m^3]","0[N/m^3]","0[N/m^3]"],"name":"value","required":false,"unit":"N/m^3","valueType":"vector"}],"kind":"Body Load","multiple":true,"parentCategory":"physics","required":false,"targetField":"u"},{"assemblyRole":"none","displayName":"Damping","entityDimensions":["domain"],"fields":[{"default":"0[1/s]","name":"Mass proportional coefficient","required":true,"unit":"1/s","valueType":"expression"},{"default":"0[s]","name":"Stiffness proportional coefficient","required":true,"unit":"s","valueType":"expression"},{"default":"[]","name":"Viscous constitutive matrix","required":false,"unit":"Pa*s","valueType":"matrix"}],"kind":"Damping","multiple":true,"parentCategory":"physics","required":false,"targetField":"u"},{"assemblyRole":"none","displayName":"Rotating Frame","entityDimensions":["domain"],"fields":[{"default":["0[rad/s]","0[rad/s]","0[rad/s]"],"name":"Angular velocity","required":true,"unit":"rad/s","valueType":"vector"},{"default":["0[rad/s^2]","0[rad/s^2]","0[rad/s^2]"],"name":"Angular acceleration","required":true,"unit":"rad/s^2","valueType":"vector"},{"default":["0[m/s^2]","0[m/s^2]","0[m/s^2]"],"name":"Translational acceleration","required":true,"unit":"m/s^2","valueType":"vector"},{"default":["0[m]","0[m]","0[m]"],"name":"Rotation origin","required":true,"unit":"m","valueType":"vector"}],"kind":"Rotating Frame","multiple":true,"parentCategory":"physics","required":false,"targetField":"u"},{"assemblyRole":"none","displayName":"Space Charge Density","entityDimensions":["domain"],"fields":[{"default":"0[C/m^3]","name":"value","required":true,"unit":"C/m^3","valueType":"expression"}],"kind":"Space Charge Density","multiple":true,"parentCategory":"physics","required":false}] | — |
| kind | Piezoelectricity | — |
| materialSchema | [{"default":"7500[kg/m^3]","name":"rho","rank":"scalar","required":true,"unit":"kg/m^3"},{"default":"6x6 matrix","name":"cE","rank":"matrix","required":true,"unit":"Pa"},{"default":"3x6 matrix","name":"e","rank":"matrix","required":true,"unit":"C/m^2"},{"default":"3x3 matrix","name":"epsS","rank":"matrix","required":true,"unit":"F/m"}] | — |
| publishedFields | [{"components":3,"displayName":"Displacement","expression":"pze.u","name":"pze.u","plottable":true,"rank":"vector","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"X displacement","expression":"component(pze.u,0)","name":"pze.ux","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"Y displacement","expression":"component(pze.u,1)","name":"pze.uy","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"Z displacement","expression":"component(pze.u,2)","name":"pze.uz","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"Displacement magnitude","expression":"norm(pze.u)","name":"pze.disp","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"Electric potential","expression":"pze.V","name":"pze.V","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"V"},{"components":1,"displayName":"Coupled energy","expression":"energy","name":"pze.energy","plottable":true,"rank":"scalar","studies":["stationary"],"unit":"J"},{"components":1,"displayName":"Coupled compliance","expression":"2*pze.energy","name":"pze.compliance","plottable":true,"rank":"scalar","studies":["stationary"],"unit":"J"},{"components":1,"displayName":"Mechanical strain energy","expression":"integral(0.5*inner(strain(pze.u),cE:strain(pze.u)))","name":"pze.strainEnergy","plottable":true,"rank":"scalar","studies":["stationary"],"unit":"J"},{"components":1,"displayName":"Mechanical compliance","expression":"2*pze.strainEnergy","name":"pze.mechanicalCompliance","plottable":true,"rank":"scalar","studies":["stationary"],"unit":"J"},{"components":1,"displayName":"Stored electric energy","expression":"integral(0.5*dot(pze.E,epsS*pze.E))","name":"pze.electricEnergy","plottable":true,"rank":"scalar","studies":["stationary","transient"],"unit":"J"},{"components":1,"displayName":"von Mises stress","expression":"von_mises(pze.stress)","name":"pze.mises","plottable":true,"rank":"scalar","studies":["stationary","transient"],"unit":"Pa"},{"components":6,"displayName":"Strain","expression":"strain(pze.u)","name":"pze.strain","plottable":true,"rank":"vector","studies":["stationary","transient"],"unit":"1"},{"components":6,"displayName":"Stress","expression":"cE:strain(pze.u)-transpose(e)*pze.E","name":"pze.stress","plottable":true,"rank":"vector","studies":["stationary","transient"],"unit":"Pa"},{"components":3,"displayName":"Electric field","expression":"-grad(pze.V)","name":"pze.E","plottable":true,"rank":"vector","studies":["stationary","transient"],"unit":"V/m"},{"components":3,"displayName":"Electric displacement","expression":"e:strain(pze.u)+epsS*pze.E","name":"pze.D","plottable":true,"rank":"vector","studies":["stationary","transient"],"unit":"C/m^2"},{"components":3,"displayName":"Velocity","expression":"d(pze.u,t)","name":"pze.velocity","plottable":true,"rank":"vector","studies":["transient"],"unit":"m/s"},{"components":3,"displayName":"Acceleration","expression":"d(pze.velocity,t)","name":"pze.acceleration","plottable":true,"rank":"vector","studies":["transient"],"unit":"m/s^2"},{"components":1,"displayName":"Electromechanical coupling energy","expression":"integral(strain(pze.u):transpose(e)*grad(pze.V))","name":"pze.couplingEnergy","plottable":true,"rank":"scalar","studies":["stationary"],"unit":"J"}] | — |
| status | certified | — |
| studies | ["Stationary","Eigenfrequency","Eigenvalue","Parametric Sweep","Sensitivity","Optimization","Transient"] | — |
| studyCapabilities | [{"certified":true,"differentiability":"exact-ad","kind":"stationary","reason":"september-2026-classroom verified contract: constitutive Jacobian finite-difference agreement and linear displacement scaling with applied voltage"},{"certified":true,"differentiability":"exact-ad","kind":"eigenfrequency","reason":"september-2026-classroom verified contract: coupled mechanical/electrical residuals and monotone spatial refinement"},{"certified":false,"differentiability":"exact-ad","kind":"eigenvalue","reason":"Use Eigenfrequency for physical resonance frequencies."},{"certified":true,"differentiability":"exact-ad","kind":"parametric-sweep","reason":"september-2026-classroom verified contract: two-point body-load sweep publishes distinct linearly scaled coupled fields on one unchanged mesh"},{"certified":false,"differentiability":"exact-ad","kind":"sensitivity","reason":"Sensitivity is unavailable for this physics interface."},{"certified":false,"differentiability":"exact-ad","kind":"optimization","reason":"Optimization is unavailable for this physics interface."},{"certified":true,"differentiability":"exact-ad","kind":"transient","reason":"september-2026-classroom verified contract: second-order coupled modal time convergence with distinct variable-step operators"}] | — |
| tag | pze | — |
| visible | true | — |
div(sigma)+F=rho*d2u/dt2; div(D)=rho_q; sigma=C:strain-e^T E; D=e:strain+eps E
Contract
| Property | Value |
|---|---|
| area | Structural Mechanics / AC/DC |
| boundaryFeatures | [{"assemblyRole":"essential","displayName":"Fixed Constraint","entityDimensions":["domain","boundary","edge","point"],"fields":[{"default":["0[m]","0[m]","0[m]"],"name":"value","required":true,"unit":"m","valueType":"vector"},{"default":[true,true,true],"name":"components","required":true,"valueType":"vector"}],"kind":"Fixed Constraint","multiple":true,"parentCategory":"physics","role":"exclusive","targetField":"u"},{"assemblyRole":"flux","displayName":"Boundary Load","entityDimensions":["bou... |
| childCategories | ["physics.domain","physics.boundary"] |
| defaultMaterial | PZT-5H |
| displayName | Piezoelectricity |
| domainFeatures | [{"assemblyRole":"material","displayName":"Piezoelectric Material","entityDimensions":["domain"],"fields":[{"default":"","name":"Material","required":true,"valueType":"material"},{"default":[[1.0,0.0,0.0],[0.0,1.0,0.0],[0.0,0.0,1.0]],"name":"Material orientation","required":true,"valueType":"matrix"}],"kind":"Piezoelectric Material","multiple":true,"parentCategory":"physics","required":true},{"assemblyRole":"volume-source","displayName":"Body Load and Charge","entityDimensions":["domain"],"fi... |
| kind | Piezoelectricity |
| materialSchema | [{"default":"7500[kg/m^3]","name":"rho","rank":"scalar","required":true,"unit":"kg/m^3"},{"default":"6x6 matrix","name":"cE","rank":"matrix","required":true,"unit":"Pa"},{"default":"3x6 matrix","name":"e","rank":"matrix","required":true,"unit":"C/m^2"},{"default":"3x3 matrix","name":"epsS","rank":"matrix","required":true,"unit":"F/m"}] |
| publishedFields | [{"components":3,"displayName":"Displacement","expression":"pze.u","name":"pze.u","plottable":true,"rank":"vector","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"},{"components":1,"displayName":"X displacement","expression":"component(pze.u,0)","name":"pze.ux","plottable":true,"rank":"scalar","studies":["stationary","eigenfrequency","eigenvalue","parametric-sweep","sensitivity","optimization","transient"],"unit":"m"... |
| status | certified |
| studies | ["Stationary","Eigenfrequency","Eigenvalue","Parametric Sweep","Sensitivity","Optimization","Transient"] |
| studyCapabilities | [{"certified":true,"differentiability":"exact-ad","kind":"stationary","reason":"september-2026-classroom verified contract: constitutive Jacobian finite-difference agreement and linear displacement scaling with applied voltage"},{"certified":true,"differentiability":"exact-ad","kind":"eigenfrequency","reason":"september-2026-classroom verified contract: coupled mechanical/electrical residuals and monotone spatial refinement"},{"certified":false,"differentiability":"exact-ad","kind":"eigenvalu... |
| tag | pze |
| visible | true |