Open Tools · Plystack

Plystack user guide

Use Plystack for laminate stiffness, coupled response, ply stresses, first-ply failure and Nx-Ny envelopes from your own material data: inputs, units, files and stated limits. To use the tool itself, open Plystack.

Professional use. Results are for education and preliminary design. They must be checked by a qualified professional, and they are not a substitute for code-compliant design or licensed engineering judgement.

Plystack calculates the linear elastic response of thin, perfectly bonded composite laminates in your browser. This page is the reference for the tool: what to enter, what each panel shows, the conventions, the limits and how the results are checked.

Getting started

Open the tool and you start from an illustrative laminate. Everything you see is editable, and every change recalculates.

First laminate in two minutes:

  1. Open the Materials tab and enter the properties of one ply: E1, E2, G12, ν12 and the two expansion coefficients α1 and α2. Values must come from a source you are entitled to use; the numbers in the built-in examples are round demonstration values, not a datasheet.
  2. Open the Plies tab, type a stacking code such as [0/45/-45/90]s, set a ply thickness and choose Replace stack. The figure shows the stack from the top face down.
  3. Open the Loads tab and enter the force and moment resultants per unit width and, if needed, a temperature change.
  4. Read the Stiffness tab for the A, B and D matrices and the effective constants. Use Ply stresses to see the stress in every ply at both of its faces.
  5. To get failure checks, switch on Include strengths in a material and enter your own allowables, then open Failure.

Use Save to write the project to a JSON file and Open to bring it back. Examples loads a ready-made laminate.

The workspace

The left column defines the laminate; the right column shows the results of one solve.

  • Laminate stack: a cross-section of the stack. Colour shows the fibre angle; a line marks 0°, dots mark 90° and slanted strokes mark other angles. The top face is drawn at the top. A long stack labels only some plies and says so.
  • Plies: a stacking-code builder and the ply table (material, angle in degrees, thickness). Rows can be moved, duplicated and deleted, and the whole stack can be mirrored about the mid-plane or reversed. Long stacks page through the table.
  • Materials: one card per material with its six elastic and thermal properties and an optional set of strengths. ν21 is derived, never entered. A material not used by any ply is kept while you work but is not written to a project file.
  • Loads: Nx, Ny, Nxy in force per unit width, Mx, My, Mxy in moment per unit width and a uniform temperature change.
  • Results tabs: Stiffness, Response, Ply stresses, Failure, Envelope and Directional. Alt+1 to Alt+6 switch between them.

The results always belong to the inputs on screen. While you type, or while the solver is running, the results area says so and shows no numbers; a result computed for other inputs is never displayed next to new ones. If a field holds text that is not a valid number, results pause and the field is marked until you fix it.

Stacking codes

A stacking code lists ply angles in degrees from the bottom ply to the top ply, separated by slashes: [0/45/-45/90]. Square brackets are optional.

  • ±45 stands for the pair +45, −45 (and ∓45 for −45, +45).
  • 0_2 means two plies at 0°.
  • A trailing s mirrors the list about the mid-plane: [0/45/-45/90]s has eight plies.
  • A number after the bracket repeats the group before mirroring: [0/90]_2s is [0/90/0/90] mirrored, eight plies.

The builder uses the material and thickness you choose; Replace stack sets the list and Append to stack adds to it. Angles are limited to ±180° in the editor. A stack can have at most 200 plies.

Units and conventions

Plystack stores every value in SI (pascal, metre, 1/K, N/m for forces per width, N for moments per width) and radians. The SI and US switch only changes how values are shown and typed: SI shows GPa, MPa, mm, N/mm and kelvin; US shows Msi, ksi, in, lbf/in and °F differences. Switching units does not change the laminate, and a value you typed returns unchanged when you switch back.

  • Axes: x and y lie in the plane of the laminate and z is through the thickness. Plies are listed from the bottom face (negative z) to the top face (positive z). The reference plane is the geometric mid-plane, including for unsymmetric stacks.
  • Ply angle: the fibre direction (material axis 1) is turned from the x axis toward the y axis by the angle; it is counterclockwise when x points right and y points up. Material axis 2 lies across the fibres.
  • Shear: gxy is the engineering shear strain, twice the tensor shear strain.
  • Signs: tension is positive. Curvature is positive when the strain grows with z: strain at height z is ε⁰ + z·κ.
  • Moments: Mx and My are bending moments per unit width and Mxy is the twisting moment per unit width, in force units (N, equivalently N·m per m).
  • ν21 equals ν12·E2/E1. Compliance must be positive definite; an admissible input is not evidence that a real material has those properties.

Stiffness and response

Q is the plane-stress reduced stiffness of one ply in material axes and Qbar is the same stiffness in laminate axes. A is the extensional stiffness (force per width per strain), B couples bending and extension, and D is the bending stiffness. The 6 by 6 ABD block matrix relates the mid-plane strains and the curvatures to the applied resultants plus the thermal resultants.

The solver always uses the full coupled system. A stack that is not symmetric has B different from zero, so an in-plane load makes it curve; dropping B would describe a different constraint.

The effective Ex, Ey, Gxy, νxy and νyx come from the upper compliance block of the coupled system under zero applied moments. They therefore allow free bending and are not the constants of a laminate held flat.

The Response tab lists the mid-plane strains, the curvatures and the thermal resultants. Its equilibrium table integrates the face stresses back through the thickness and must return the applied loads. Thermal resultants are the integral of Qbar times the rotated thermal strain; the recovered stress subtracts the free thermal strain of each ply, so a uniformly heated homogeneous slab expands without mechanical stress, up to rounding.

Ply stresses

The Ply stresses tab plots stress or strain through the thickness and tabulates every ply at its bottom and top faces. Three plots are offered: stress in laminate axes (σx, σy, τxy), stress in material axes (σ1 along the fibres, σ2 across them, τ12) and strain in laminate axes.

Within a ply the stress varies linearly, and each ply is drawn as its own straight segment from face to face. Stress generally jumps at an interface, so the table keeps the two adjacent plies separate rather than averaging them. No interlaminar stress is calculated and free-edge effects are not modelled.

Failure checks

Strengths Xt, Xc, Yt, Yc and S are positive allowable magnitudes in material axes (tension and compression along the fibres, tension and compression across them, and in-plane shear). They are USER-ENTERED: Plystack supplies no material database, no design-code table, no safety factor and no environmental knockdown. The interaction coefficient, equal to F12 divided by √(F11·F22), is also USER-ENTERED and must lie strictly between −1 and 1; 0 switches the interaction term off. There is no assumed default.

  • Maximum stress checks the tensile, compressive and shear inequalities independently. The index is the largest ratio of a stress to its allowable.
  • Tsai-Wu fits a convex quadratic surface through the five allowable intercepts with your interaction coefficient. Its index can be negative well inside the surface; that is not a negative stress.

Both faces of every ply are checked. A face status reads below the limit or at or above the limit; neither is a pass certificate. The reserve factor is the first positive intersection along a proportional loading ray: ALL loads AND deltaT are scaled together from zero. It is not spare capacity at a fixed thermal state, and a zero load has no reserve factor. The ply with the highest index is not always the ply with the lowest reserve factor for Tsai-Wu, so the tab reports both.

A ply without a complete strength set is not checked. The tab says how many plies were skipped and never shows them as safe; if no ply has strengths there is no failure result at all.

Nx-Ny envelope

The Envelope tab computes the first-ply failure boundary in the Nx-Ny plane for the criterion you select, with Nxy, all moments and the temperature change set to zero (the load case of the other tabs is not used). Every ply needs a strength set. The number of directions is an integer from 8 to 180; the default is 72.

Each point is the exact first-failure load along one direction, so the result is labelled angular-samples: the outline joins neighbouring points as a drawing aid and does not prove the shape between them. Increase the number of directions to see more detail. The cross marks the applied Nx and Ny only when the other loads and ΔT are zero. A run can be cancelled; the points can be downloaded as CSV.

Directional stiffness

The Directional tab plots the effective modulus along a direction φ from the x axis, in steps of 5° from 0° to 175°, as a polar curve. It rotates every ply by −φ and solves the full coupled laminate once for each direction, so each point is the same free-bending Ex as on the Stiffness tab. Directions φ and φ + 180° are the same, so the curve is mirrored. A quasi-isotropic laminate gives a circle.

Files and exports

Save writes a project JSON file: format plystack, schema version 1, a notice, the title and the model (plies with their material data, the six loads and ΔT), in SI and radians. Material labels A, B, C… are assigned by order of first use when a file is opened, and plies with identical material data share one material. View settings such as the display unit and the failure criterion are not part of the file. Unknown fields, a different schema version and invalid values are refused with a message, and no physical default is ever inserted. A project must be under 1 MiB.

Export offers the results as CSV (a six-column UTF-8 table with the matrices, strains, face stresses and failure indices; unavailable values read n/a and text that could be read as a spreadsheet formula is neutralised), each figure as SVG or PNG, and a printed report through the browser. Every exported file carries the footer "Made with Plystack · simulations4all.com" and the professional-use notice. Autosave keeps the current laminate in this browser only.

Keyboard shortcuts

  • Ctrl/Cmd + Z undo, Ctrl/Cmd + Shift + Z or Ctrl + Y redo (outside text fields, where the field's own undo applies).
  • Ctrl/Cmd + S save the project, Ctrl/Cmd + O open a project.
  • Alt + 1 to 6 switch the results tab; ←, →, Home, End move between tabs once a tab has focus.
  • Esc closes a menu or dialog and, in a field, discards an unsent edit. ? lists the shortcuts.

Limitations and numerical limits

Up to 200 plies are supported. Each ply thickness is 1e-9 to 1 m; the total is at most 10 m and each thickness divided by the total must be at least 1e-9. E, G and strength magnitudes are 1e-3 to 1e15 Pa. Loads are at most 1e15 in their SI units, the temperature change at most 1e4 K and each expansion coefficient at most 1e-2 per kelvin. Ply angles are limited to ±2π radians in a file, and ν12 to a magnitude of 10 subject to positive definiteness. Inputs outside these windows are refused with a message, never clamped.

These are arithmetic admission limits, not statements about physical validity. Classical laminate theory further assumes thin plies, small strains and rotations, linear elastic behaviour and perfect bonding. The tool cannot judge whether a particular part meets those assumptions, because span, width and supports are outside the model.

The solve works in normalised thickness coordinates with a diagonally equilibrated Cholesky factorisation. It refuses an equilibrated condition estimate above 1e12 or a backward residual above 1e-9, and the status line shows the values for the current solve. Work grows linearly with the number of plies, and an envelope with 200 plies and 180 directions needs a conservative estimate of well under the 64 MiB budget. Calculation runs in a worker; the only network request is the exchange of the site run token.

Not modelled: progressive damage, buckling, fatigue, sandwich or core shear, interlaminar and free-edge stresses, moisture, temperature-dependent properties, thermal gradients, finite-element models and design-code compliance.

How we verify this tool

The Verify page runs the engine's own reference ledger in your browser through the same gated worker: 71 checks, each showing the case, its independent reference, the computed value, the difference, the tolerance and PASS or FAIL. 46 are verification checks against closed forms: for a homogeneous slab the stiffness, the strains, the stresses and the failure indices follow from hand derivation. 25 are validation checks against a published worked example (the public NASA reference publication on laminated plate mechanics) whose inputs and results were read from the report itself; the report rounds some intermediate values, and the tolerance documents that.

A published strength benchmark is Pending source: no reference number has been entered and it earns no pass. That report explicitly excludes strength, so the failure checks are mathematical verification, not material validation. The automated test suite adds 240 seeded mixed-material laminates compared with an independent method (stress probes on the compliance and a numerical energy integral) and 240 independent bisections of the failure criteria, as well as edge-case, scaling, file and worker checks.

The "checks pass" badge on the Verify page is earned only by a complete run in which every ready check passed. A passing suite does not validate your material data or certify a design.

Troubleshooting

  • Results paused: a field holds text that is not a plain number or is out of range. The field is outlined and states the problem.
  • To calculate, complete the laminate: a material field is empty, a ply has no thickness, or there are no plies. The message names each missing item.
  • No result (INPUT): a value breaks a numerical or physical rule, for example ν12²·E2/E1 of 1 or more.
  • SIZE: a count, file size or stack-thickness limit was exceeded.
  • CONDITION or RESIDUAL: the stiffness cannot support a trustworthy solve. Check the stiffness ratios and near-singular Poisson values.
  • Strengths need…: a strength set is partly filled. Complete all six values or switch the strengths off.
  • GATE: the tool runs only on simulations4all.com; reconnect to continue. Editing, saving, opening files and this guide keep working without a run token.

Compared with other tools

Plystack is a local laminate bench for elastic stiffness, coupled response, ply stresses and two first-ply criteria, with open files and a verification page you can run yourself. Dedicated composite engineering suites can include validated material libraries, environmental reductions, progressive damage, buckling, fatigue, sandwich shear, impact, manufacturing models, design-code workflows, automatic sizing and finite-element exchange. Those capabilities are outside this tool, and no compatibility with any other product's project files is claimed.

Frequently asked questions

Why does an unsymmetric laminate bend under in-plane load?

Its B matrix couples mid-plane strain and curvature. The full ABD solve accounts for that coupling; solving only A would describe a different constraint.

What units and stacking order should I use?

Type values in whichever display unit you prefer; they are stored in SI. List plies from the bottom face to the top face and give angles in degrees.

Does a failure index certify a laminate?

No. It evaluates one idealised criterion against the allowables you entered. It does not cover every failure mechanism and it does not establish regulatory acceptance.

Can I use thermal residual stress with a reserve factor?

The reported reserve factor scales ALL loads AND deltaT together. It does not describe extra mechanical load at a fixed thermal state. The Nx-Ny envelope requires zero temperature change.

Where do the material numbers come from?

From you. Plystack contains no material database; the example laminates use round demonstration values, and one example uses the inputs printed in a public NASA report.

Professional use

Results are for education and preliminary design. They must be checked by a qualified professional and are not a substitute for code-compliant design or licensed engineering judgement.

Plystack user guide: enter a stack, apply loads and read the laminate response | Simulations4All