Skip to main content
JSON Manual Created Edited

Nonlinear Analysis Control Data

Input URI

{base url} + db/NLCT



Active Methods

POST, GET, PUT, DELETE



JSON Schema

Details

{
    "NLCT": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
            "NONLINEAR_TYPE": {
                "description": "NonlinearType",
                "type": "string"
            },
            "ITERATION_METHOD": {
                "description": "IterationMethod",
                "type": "string"
            },
            "NUMBER_STEPS": {
                "description": "NumberofLoad/DisplacementSteps",
                "type": "integer"
            },
            "MAX_ITERATIONS": {
                "description": "MaximumNumberofIterations/LoadStep",
                "type": "integer"
            },
            "INITIAL_FORCE_RATIO_ARC_LEN": {
                "description": "InitialForceRatioforUnitArc-Length",
                "type": "number"
            },
            "MASTER_NODE": {
                "description": "MasterNode",
                "type": "integer"
            },
            "DIRECTION": {
                "description": "Direction",
                "type": "integer"
            },
            "MAXIMUM_DISPLACEMENT": {
                "description": "MaximumDisplacement",
                "type": "number"
            },
            "OPT_ENERGY_NORM": {
                "description": "EnergyNormBoolean",
                "type": "boolean"
            },
            "ENERGY_NORM": {
                "description": "EnergyNorm",
                "type": "number"
            },
            "OPT_DISPLACEMENT_NORM": {
                "description": "DisplacementNormBoolean",
                "type": "boolean"
            },
            "DISPLACEMENT_NORM": {
                "description": "DisplacementNorm",
                "type": "number"
            },
            "OPT_FORCE_NORM": {
                "description": "ForceNormBoolean",
                "type": "boolean"
            },
            "FORCE_NORM": {
                "description": "ForceNorm",
                "type": "number"
            },
            "NEWTON_ITEMS": {
                "description": "NewtonItems",
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "ITERATION_METHOD": {
                            "description": "IterationMethod",
                            "type": "string"
                        },
                        "LCNAME": {
                            "description": "LoadCaseName",
                            "type": "string"
                        },
                        "NUMBER_STEPS": {
                            "description": "NumberofDisplacementSteps",
                            "type": "number"
                        },
                        "MAX_ITERATIONS": {
                            "description": "MaximimNumberofIterations/IncrementStep",
                            "type": "integer"
                        },
                        "LOAD_FACTORS": {
                            "description": "MasterNodeDisplacementList",
                            "type": "array",
                            "items": {
                                "type": "number"
                            }
                        }
                    }
                }
            },
            "ARCLEN_ITEMS": {
                "description": "ArclenItems",
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "ITERATION_METHOD": {
                            "description": "IterationMethod",
                            "type": "string"
                        },
                        "LCNAME": {
                            "description": "LoadCaseName",
                            "type": "string"
                        },
                        "INITIAL_FORCE_RATIO_ARC_LEN": {
                            "description": "InitialForceRatioforUnitArc-Length",
                            "type": "number"
                        },
                        "NUMBER_STEPS": {
                            "description": "NumberofDisplacementSteps",
                            "type": "number"
                        },
                        "MAX_ITERATIONS": {
                            "description": "MaximimNumberofIterations/IncrementStep",
                            "type": "integer"
                        },
                        "MAXIMUM_DISPLACEMENT": {
                            "description": "MaximumDisplacement",
                            "type": "number"
                        }
                    }
                }
            },
            "DISPCT_ITEMS": {
                "description": "DispctItems",
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "ITERATION_METHOD": {
                            "description": "IterationMethod",
                            "type": "string"
                        },
                        "LCNAME": {
                            "description": "LoadCaseName",
                            "type": "string"
                        },
                        "NUMBER_STEPS": {
                            "description": "NumberofDisplacementSteps",
                            "type": "number"
                        },
                        "MAX_ITERATIONS": {
                            "description": "MaximimNumberofIterations/IncrementStep",
                            "type": "integer"
                        },
                        "MASTER_NODE": {
                            "description": "MasterNode",
                            "type": "integer"
                        },
                        "DIRECTION": {
                            "description": "Direction",
                            "type": "integer"
                        },
                        "MAXIMUM_DISPLACEMENT": {
                            "description": "MaximumDisplacement",
                            "type": "number"
                        },
                        "LOAD_FACTORS": {
                            "description": "MasterNodeDisplacementList",
                            "type": "array",
                            "items": {
                                "type": "number"
                            }
                        }
                    }
                }
            }
        }
    }
}


Examples

Iteration Method : Newton-Raphson

{
    "Assign": {
        "1": {
            "NONLINEAR_TYPE": "GEOM+MATL",
            "ITERATION_METHOD": "NEWTON",
            "NUMBER_STEPS": 1,
            "MAX_ITERATIONS": 30,
            "OPT_ENERGY_NORM": true,
            "ENERGY_NORM": 0.001,
            "OPT_DISPLACEMENT_NORM": true,
            "DISPLACEMENT_NORM": 0.001,
            "OPT_FORCE_NORM": true,
            "FORCE_NORM": 0.001,
            "NEWTON_ITEMS": [
                {
                    "ITERATION_METHOD": "NEWTON",
                    "LCNAME": "A",
                    "NUMBER_STEPS": 1,
                    "MAX_ITERATIONS": 30,
                    "LOAD_FACTORS": [
                        1
                    ]
                }
            ],
            "DISPCT_ITEMS": [
                {
                    "ITERATION_METHOD": "DISP",
                    "LCNAME": "B",
                    "NUMBER_STEPS": 1,
                    "MAX_ITERATIONS": 10,
                    "MASTER_NODE": 1,
                    "DIRECTION": 0,
                    "MAXIMUM_DISPLACEMENT": 0.1,
                    "LOAD_FACTORS": [
                        1
                    ]
                }
            ]
        }
    }
}

Iteration Method : Arc-Length

{
    "Assign": {
        "1": {
            "NONLINEAR_TYPE": "GEOM+MATL",
            "ITERATION_METHOD": "ARC",
            "NUMBER_STEPS": 100,
            "MAX_ITERATIONS": 10,
            "INITIAL_FORCE_RATIO_ARC_LEN": 5,
            "MAXIMUM_DISPLACEMENT": 0,
            "OPT_ENERGY_NORM": true,
            "ENERGY_NORM": 0.001,
            "OPT_DISPLACEMENT_NORM": true,
            "DISPLACEMENT_NORM": 0.001,
            "OPT_FORCE_NORM": true,
            "FORCE_NORM": 0.001,
            "ARCLEN_ITEMS": [
                {
                    "ITERATION_METHOD": "ARC",
                    "LCNAME": "A",
                    "INITIAL_FORCE_RATIO_ARC_LEN": 5,
                    "NUMBER_STEPS": 100,
                    "MAX_ITERATIONS": 10,
                    "MAXIMUM_DISPLACEMENT": 1
                }
            ]
        }
    }
}

Iteration Method : Displacement-Control

{
    "Assign": {
        "1": {
            "NONLINEAR_TYPE": "GEOM+MATL",
            "ITERATION_METHOD": "DISP",
            "NUMBER_STEPS": 1,
            "MAX_ITERATIONS": 10,
            "MASTER_NODE": 1,
            "DIRECTION": 0,
            "MAXIMUM_DISPLACEMENT": 0.1,
            "OPT_ENERGY_NORM": true,
            "ENERGY_NORM": 0.001,
            "OPT_DISPLACEMENT_NORM": true,
            "DISPLACEMENT_NORM": 0.001,
            "OPT_FORCE_NORM": true,
            "FORCE_NORM": 0.001,
            "NEWTON_ITEMS": [
                {
                    "ITERATION_METHOD": "NEWTON",
                    "LCNAME": "A",
                    "NUMBER_STEPS": 1,
                    "MAX_ITERATIONS": 30,
                    "LOAD_FACTORS": [
                        1
                    ]
                }
            ],
            "DISPCT_ITEMS": [
                {
                    "ITERATION_METHOD": "DISP",
                    "LCNAME": "B",
                    "NUMBER_STEPS": 1,
                    "MAX_ITERATIONS": 10,
                    "MASTER_NODE": 1,
                    "DIRECTION": 0,
                    "MAXIMUM_DISPLACEMENT": 0.1,
                    "LOAD_FACTORS": [
                        1
                    ]
                }
            ]
        }
    }
}


Specifications

No. Description Key Value Type Default Required

1

Nonlinear Type

 • Geometry Nonlinear: "GEOM"

 • Material Nonlinear: "MATL"

 • Geometry/Material Nonlinear: "GEOM+MATL"

"NONLINEAR_TYPE"

String

"GEOM"

Optional

2

Iteration Method

 • Newton-Raphson: "NEWTON"

 • Arc-Length: "ARC"

 • Displacement-Control: "DISP"

"ITERATION_METHOD"

String

"NEWTON"

Optional

3

Energy Norm

 • Active/Inactive

"OPT_ENERGY_NORM"

Boolean

false

Optional

4

Energy Norm

"ENERGY_NORM"

Number

-

Required

5

Displacement Norm

 • Active/Inactive

"OPT_DISPLACEMENT_NORM"

Boolean

false

Optional

6

Displacement Norm

"DISPLACEMENT_NORM"

Number

-

Required

7

Force Norm

 • Active/Inactive

"OPT_FORCE_NORM"

Boolean

false

Optional

8

Force Norm

"FORCE_NORM"

Number

-

Required

Iteration Method: Newton-Raphson

9

Number of Load Steps

"NUMBER_STEPS"

Integer

-

Required

10

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

11

Load Case Specific Nonlinear Analysis Control Data - Newton-Raphson

 • Insert the data as an object

"NEWTON_ITEMS"

Array
[Object]

-

Required

(1)

Iteration Method

 • Newton-Raphson: "NEWTON"

"ITERATION_METHOD"

String

"NEWTON"

Optional

(2)

Load Case Name

"LCNAME"

String

-

Required

(3)

Number of Load Steps

"NUMBER_STEPS"

Number

-

Required

(4)

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

(5)

Load Factor

 • Index: Step

"LOAD_FACTORS"

Array
[Number]

1

Optional

12

Load Case Specific Nonlinear Analysis Control Data - Displacement-Control

 • Insert the data as an object

"DISPCT_ITEMS"

Array
[Object]

-

Required

(1)

Iteration Method

 • Newton-Raphson: "DISP"

"ITERATION_METHOD"

String

"DISP"

Optional

(2)

Load Case Name

"LCNAME"

String

-

Required

(3)

Number of Displacement Steps

"NUMBER_STEPS"

Integer

-

Required

(4)

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Number

-

Required

(5)

Master Node ID Number

"MASTER_NODE"

Integer

-

Required

(6)

Direction

 • Dx: 0

 • Dy: 1

 • Dz: 2

"DIRECTION"

Integer

0

Optional

(7)

Maximum Displacement

"MAXIMUM_DISPLACEMENT"

Number

-

Required

(8)

Master Node Displacement

 • Index: Step

"LOAD_FACTORS"

Array
[Number]

1

Optional

Iteration Method: Arc-Length

9

Number of Load Steps

"NUMBER_STEPS"

Integer

-

Required

10

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

11

Initial Force Ratio for Unit Arc-Length

"INITIAL_FORCE_RATIO_ARC_LEN"

Integer

-

Required

12

Maximum Displacement Boundary

"MAXIMUM_DISPLACEMENT"

Number

0

Optional

13

Load Case Specific Nonlinear Analysis Control Data - Arc-Length

 • Insert the data as an object

"ARCLEN_ITEMS"

Array
[Object]

-

Required

(1)

Iteration Method

 • Arc-Length: "ARC"

"ITERATION_METHOD"

String

"ARC"

Optional

(2)

Load Case Name

"LCNAME"

String

-

Required

(3)

Number of Load Steps

"NUMBER_STEPS"

Number

-

Required

(4)

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

(5)

Initial Force Ratio for Unit Arc-Length

"INITIAL_FORCE_RATIO_ARC_LEN"

Number

0

Optional

(6)

Maximum Displacement Boundary

"MAXIMUM_DISPLACEMENT"

Number

0

Optional

Iteration Method: Displacement-Control

9

Number of Load Steps

"NUMBER_STEPS"

Integer

-

Required

10

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

11

Master Node ID Number

"MASTER_NODE"

Integer

-

Required

12

Direction

 • Dx: 0

 • Dy: 1

 • Dz: 2

"DIRECTION"

Integer

0

Optional

13

Maximum Displacement

"MAXIMUM_DISPLACEMENT"

Number

-

Required

14

Load Case Specific Nonlinear Analysis Control Data - Newton-Raphson

 • Insert the data as an object

"NEWTON_ITEMS"

Array
[Object]

-

Required

(1)

Iteration Method

 • Newton-Raphson: "NEWTON"

"ITERATION_METHOD"

String

"NEWTON"

Optional

(2)

Load Case Name

"LCNAME"

String

-

Required

(3)

Number of Load Steps

"NUMBER_STEPS"

Number

-

Required

(4)

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Integer

-

Required

(5)

Load Factor

 • Index: Step

"LOAD_FACTORS"

Array
[Number]

1

Optional

15

Load Case Specific Nonlinear Analysis Control Data - Displacement-Control

 • Insert the data as an object

"DISPCT_ITEMS"

Array
[Object]

-

Required

(1)

Iteration Method

 • Newton-Raphson: "DISP"

"ITERATION_METHOD"

String

"DISP"

Optional

(2)

Load Case Name

"LCNAME"

String

-

Required

(3)

Number of Displacement Steps

"NUMBER_STEPS"

Integer

-

Required

(4)

Maximum Number of Iterations/Load Step

"MAX_ITERATIONS"

Number

-

Required

(5)

Master Node ID Number

"MASTER_NODE"

Integer

-

Required

(6)

Direction

 • Dx: 0

 • Dy: 1

 • Dz: 2

"DIRECTION"

Integer

0

Optional

(7)

Maximum Displacement

"MAXIMUM_DISPLACEMENT"

Number

-

Required

(8)

Master Node Displacement

 • Index: Step

"LOAD_FACTORS"

Array
[Number]

1

Optional



0
Was this article helpful?