Result queries allow for the designer to output results for specific queries related to particular structural elements. With the results, designers can use these to either link to their design calculations or guide updates to the structural analysis model for optimisation purposes.
Under the Solver tab for the structural analysis plug-in there will be a number of query options in-which can be input into the solver component.
In order to query structural analysis results there are three steps to follow:
Set-up the Query by providing the Element and the Case (or Combination) to query.
Provide the Query to the solver component which will 'Extract' the Query into its Result Set output. Read more below about Query to Result Conversion Output Types.
Decompose the Result to get values, positions etc.
Because result queries are typically dealing with one element which may contain many associated results some query processes have a one to one query to result.
Generally speaking, a query will only have one load case and will have an associated list of elements for which results will be obtained.
A one to one query means that only one Result Set will be provided from the solver component. The query components will only take a list of elements and a specific load case. Typically a one to one Query will have an associated Result Decompose component.
Some queries contain the ability to request a range of applicable results. You can select one of these or all of the results.
A one to many Query will have an associated Result Decompose component which will be applicable to each of the result sets which are extracted.
Some of the typical query items are listed below and their associated result Decompose Components:
A model query is a query which relates to the whole model. A model query does not relate to a specific element within the model and only a load case is required to be provided.
A model query can be decomposed by the corresponding decompose component or it may not require to be decomposed and directly provide a value.
Model Buckling Factor ggQuery Buckling Factor
All node queries have a one query to one result set relationship. All node result sets can be decomposed using the ggDecomposeNodeSet component. Some typical Node results which are available to be retrieved are:
Node Reaction Force ggQueryNodeReactionForce
Node Reaction Moments ggQueryNodeReactionMoment
Node Displacements ggQueryNodeDisplacement
Node Mass ggQueryNodeMass
Typically curve/1d element queries have a one query to many result set relationship. All resulting result sets can be decomposed using the ggDecompose1dSet component.
Some typical Curve/1d results which are available to be retrieved are:
Query Curve Element Forces ggQuery Curve Element Forces
Query Curve Element Strain ggQuery Curve Element Strain
Query Curve Element Stress ggQuery Curve Element Stress
Typically Area/Mesh element queries have a one query to many result set relationship. All resulting results sets can be decomposed using the ggDecompose2dSet component.
//Explain more about available options.
Once the solver has run and analysis results have extracted into the Grasshopper environment, The results will become available from the solver component output.
If you are happy with the output results you can centralise the results within Grasshopper to export into another GH document or use within the current document.
Once you have retrieved the desired the structural results there are a number of components which you can use to break down components of the results. (i.e the x, y , z force reactions of a Node reaction). Some of the decompose utilities are listed below: