[THIS] Time History Load Cases

    "THIS": {
        "COMMON": {
            "__DESC__": "Common Data",
            "__TYPE__": {
                "NAME": {
                    "__DESC__": "Time History Load Case Name",
                    "__TYPE__": "String"
                },
                "DESC": {
                    "__DESC__": "Description",
                    "__TYPE__": "String"
                },
                "iATYPE": {
                    "__DESC__": "Anlysis Type",
                    "__TYPE__": "Integer"
                },
                "iAMETHOD": {
                    "__DESC__": "Analysis Method",
                    "__TYPE__": "Integer"
                },
                "iTHTYPE": {
                    "__DESC__": "Time History Type",
                    "__TYPE__": "Integer"
                },
                "iGEOM": {
                    "__DESC__": "Geometric Nonlinearity Type (Nonlinear - Anlysis Type)",
                    "__TYPE__": "Integer"
                },
                "iISTEP": {
                    "__DESC__": "Increment Steps (Static - Analysis Method)",
                    "__TYPE__": "Integer"
                },
                "ENDTIME": {
                    "__DESC__": "End Time",
                    "__TYPE__": "Real"
                },
                "INC": {
                    "__DESC__": "Time Increment",
                    "__TYPE__": "Real"
                },
                "iOUT": {
                    "__DESC__": "Step Number Increment For Output",
                    "__TYPE__": "Integer"
                },
                "INITLOAD": {
                    "__DESC__": "Use initial load",
                    "__TYPE__": "Integer"
                },
                "INITMETHOD": {
                    "__DESC__": "Dynamic Load Type",
                    "__TYPE__": "String"
                },
                "bSUBSEQ": {
                    "__DESC__": "Subsequent to - Check Box",
                    "__TYPE__": "Bool"
                },
                "SUBSEQ": {
                    "__DESC__": "Subsequent to - Type",
                    "__TYPE__": "Integer"
                },
                "LCTYPE": {
                    "__DESC__": "Load Case Type",
                    "__TYPE__": "String"
                },
                "CASE": {
                    "__DESC__": "Load Case Name",
                    "__TYPE__": "String"
                },
                "bKEEP": {
                    "__DESC__": "Keep Final Step Loads Constant",
                    "__TYPE__": "Bool"
                },
                "bDVA": {
                    "__DESC__": "Cumulate D/V/A Results",
                    "__TYPE__": "Bool"
                },
                "iMDTYPE": {
                    "__DESC__": "Damping Method",
                    "__TYPE__": "Integer"
                }
            }
        },
        "iINCCTRL": {
            "__DESC__": "Increment method",
            "__TYPE__": "Integer"
        },
        "bCUMULATE": {
            "__DESC__": "Cumulate load increment history for output",
            "__TYPE__": "Bool"
        },
        "SCALE": {
            "__DESC__": "Control Option - Scale factor",
            "__TYPE__": "Integer"
        },
        "iCTRL": {
            "__DESC__": "Displacement control option",
            "__TYPE__": "Integer"
        },
        "TINC": {
            "__DESC__": "Maximum displacement",
            "__TYPE__": "Integer"
        },
        "MNODE": {
            "__DESC__": "Master node",
            "__TYPE__": "Integer"
        },
        "MDIR": {
            "__DESC__": "Master direction",
            "__TYPE__": "Integer"
        },
        "DALL": {
            "__DESC__": "Damping Ratio For All Modes",
            "__TYPE__": "Real"
        },
        "iCOEF": {
            "__DESC__": "Mass And Stiffness Coefficients Type",
            "__TYPE__": "Integer"
        },
        "bMASSP": {
            "__DESC__": "Mass Proportional - Check Box",
            "__TYPE__": "Bool"
        },
        "MASSC": {
            "__DESC__": "Mass Proportional - Value",
            "__TYPE__": "Real"
        },
        "bSTIFFP": {
            "__DESC__": "Stiffness Proportional - Check Box",
            "__TYPE__": "Bool"
        },
        "STIFFC": {
            "__DESC__": "Stiffness Proportional - Value",
            "__TYPE__": "Real"
        },
        "iCALC": {
            "__DESC__": "Coefficient Calculation Type, Frequency ), 1, Period ), 2",
            "__TYPE__": "Integer"
        },
        "FP1": {
            "__DESC__": "Frequency / Period - Mode1",
            "__TYPE__": "Integer"
        },
        "DR1": {
            "__DESC__": "Dampng Ratio - Mode1",
            "__TYPE__": "Integer"
        },
        "FP2": {
            "__DESC__": "Frequency / Period - Mode2",
            "__TYPE__": "Integer"
        },
        "DR2": {
            "__DESC__": "Dampng Ratio - Mode2",
            "__TYPE__": "Integer"
        },
        "iNMM": {
            "__DESC__": "Newmark Method Input Type",
            "__TYPE__": "Integer"
        },
        "GAMMA": {
            "__DESC__": "Gamma Value",
            "__TYPE__": "Integer"
        },
        "BETA": {
            "__DESC__": "Beta Value",
            "__TYPE__": "Integer"
        },
        "bITER": {
            "__DESC__": "Perform iteration - Check Box",
            "__TYPE__": "Bool"
        },
        "bCONV": {
            "__DESC__": "Permit convergence failure - Check Box",
            "__TYPE__": "Bool"
        },
        "MINSSS": {
            "__DESC__": "Minimum step size",
            "__TYPE__": "Real"
        },
        "iMSTEP": {
            "__DESC__": "Minimum step size",
            "__TYPE__": "Integer"
        },
        "iMAXITER": {
            "__DESC__": "Maximum iteration",
            "__TYPE__": "Integer"
        },
        "bDN": {
            "__DESC__": "Displacement norm - Check Box",
            "__TYPE__": "Bool"
        },
        "DN": {
            "__DESC__": "Displacement norm - value",
            "__TYPE__": "Real"
        },
        "bFN": {
            "__DESC__": "Force norm - Check Box",
            "__TYPE__": "Bool"
        },
        "FN": {
            "__DESC__": "Force norm - value",
            "__TYPE__": "Real"
        },
        "bEN": {
            "__DESC__": "Energy norm - Check Box",
            "__TYPE__": "Bool"
        },
        "EN": {
            "__DESC__": "Energy norm - value",
            "__TYPE__": "Real"
        },
        "DMUPDATE": {
            "__DESC__": "Damping matrix update",
            "__TYPE__": "Bool"
        },
        "iRKM": {
            "__DESC__": "Runge kutta method",
            "__TYPE__": "Integer"
        },
        "dTOL": {
            "__DESC__": "Tolerance",
            "__TYPE__": "Real"
        },
        "bULSM": {
            "__DESC__": "Use line search method",
            "__TYPE__": "Bool"
        },
        "ULSM": {
            "__DESC__": "Number of iteration to start line search",
            "__TYPE__": "Integer"
        },
        "aDAMP": {
            "__DESC__": "Mode ID, Damping List",
            "__TYPE__": [
                {
                    "iMODE": {
                        "__DESC__": "Modal damping overrides - Mode",
                        "__TYPE__": "Integer"
                    },
                    "DAMPING": {
                        "__DESC__": "Modal damping overrides - Damping ratio",
                        "__TYPE__": "Integer"
                    }
                }
            ]
        }
    }

Introduce Input Data Symbols

API - Value Type		Input Data

API - Value Type	Input Data
Integer	🔴	Essential
String	❌	Unnecessary
Boolean	🔺	Optional
Real

The required Input Data for defining Time History Load Case

NO.	Name	API - Key	API - Value Type	Default	TH. Load Case

NO.	Name	API - Key	Default	TH. Load Case
1	Time History Load Case No.	“KEY”		🔴
	Common Data
2	Common Data	"COMMON"		🔴
3	Time History Load Case Name	"NAME"		🔴
4	Description	"DESC"		🔺
5	Anlysis Type Linear : 1 Nonlinear : 2	"iATYPE"		🔴
6	Analysis Method Modal : 1 Direct Integration : 2 Static : 3 (Nonlinear only)	"iAMETHOD"		🔴
7	Time History Type Transient : (Linear - Modal & Direct Integration) (Nonlinear - Modal & Direct Integration) Periodic : (Linear - Modal only)	"iTHTYPE"		🔴
8	End Time	"ENDTIME"		🔴
9	Time Increment	"INC"		🔴
10	Step Number Increment For Output	"iOUT"		🔴
11	Increment Steps (Nonlinear - Static only)	"iISTEP"		🔴
12	Dynamic Load Type Initial Load (Global Control) : "INIT" (Nonlinear - Direct Integration & Static) Order in Sequential Loading : "ORDER"	"INITMETHOD"		🔴
	Geometric Nonlinearity Type
	(Nonlinear - Direct Integration & Static - Order in Sequential Loading)
13	Geometric Nonlinearity Type None : 0 Large Displacements : 1	"iGEOM"	0	🔺
	Order in Sequential Loading
14	Subsequent to - Check Box	"bSUBSEQ"	FALSE	🔺
15	Subsequent to - Type Load Case : 0 Initial Element Forces (Table) : 1 Initial Forces for Geometric Stiffness : 2 (Geometric Nonlinearity Type - Large Displacements)	"SUBSEQ"		🔺
16	Load Case Type Static Load : “ST” Construction Load : "CS" (Subsequent to - Load Case)	"LCTYPE"		🔺
17	Load Case Name	"CASE"		🔺
	Initial Load (Global Control)
18	Use initial load Use Initial Load : 0 Not use Initial Load : 1	"INITLOAD"	FALSE	🔺
19	Cumulate D/V/A Results	"bDVA"		🔺
20	Keep Final Step Loads Constant	"bKEEP"		🔺
21	Damping Method Modal : 1 Mass & Stiffness Proportional : 2 Strain Energy Proportional : 3 Element Mass & Stiffness Proportional : 4 (Direct Integration Method only)	"iMDTYPE"		🔴
	Damping
	Damping Method - Modal
22	Damping Ratio For All Modes	"DALL"		🔴
23	Mode ID Damping List	"aDAMP"		🔴
24	Modal damping overrides - Mode	"iMODE"		🔴
25	Modal damping overrides - Damping ratio	"DAMPING"		🔴
	Damping Method - Mass & Stiffness Proportional
26	Mass And Stiffness Coefficients Type Direct Specification : 1 Calculate from Modal Damping : 2	"iCOEF"		🔴
27	Mass Proportional - Check Box	"bMASSP"		🔴
28	Stiffness Proportional - Check Box	"bSTIFFP"		🔴
29	Mass Proportional - Value	"MASSC"		🔴
30	Stiffness Proportional - Value	"STIFFC"		🔴
31	Coefficient Calculation Type Frequency : 1 Period : 2	"iCALC"		🔴
32	Frequency / Period - Mode1	"FP1"		🔴
33	Dampng Ratio - Mode1	"DR1"		🔴
34	Frequency / Period - Mode2	"FP2"		🔴
35	Dampng Ratio - Mode2	"DR2"		🔴
	Time Integration Parameters
	(Linear & Nonlinear - Direct Integration only)
36	Newmark Method Input Type Constant Acceleration : 1 Linear Acceleration : 2 User Input : 3	"iNMM"		🔴
37	Gamma Value (User Input only)	"GAMMA"		🔺
38	Beta Value (User Input only)	"BETA"		🔺
	Nonlinear Analysis Control Parameters
39	Perform iteration (Nonlinear - Direct Integration & Static)	"bITER"	FALSE	🔺
40	Damping matrix update (Nonlinear - Direct Integration only)	"DMUPDATE"	FALSE	🔺
	Iteration Controls
	Iteration Parameters
41	Permit convergence failure - Check Box	"bCONV"	FALSE	🔺
42	Minimum step size	"MINSSS"		🔴
43	Max. Number of Substeps (Nonlinear - Static only)	"iMSTEP"		🔴
44	Maximum iteration	"iMAXITER"		🔴
45	Displacement norm - Check Box	"bDN"		🔺
46	Displacement norm - value	"DN"		🔺
47	Force norm - Check Box	"bFN"		🔺
48	Force norm - value	"FN"		🔺
49	Energy norm - Check Box	"bEN"		🔺
50	Energy norm - value	"EN"		🔺
51	Use line search method	"bULSM"	FALSE	🔺
52	Number of iteration to start line search	"ULSM"	0	🔺
	Boundary Nonlinear Analysis
53	Runge kutta method	"iRKM"	0	🔺
54	Tolerance	"dTOL"	0	🔺
	Nonlinear - Static Method
55	Increment method Load Control : 0 Displacement Control : 1	"iINCCTRL"	0	🔺
56	Cumulate load increment history for output	"bCUMULATE"	FALSE	🔺
	Load Control
57	Scale factor	"SCALE"	0	🔴
	Displacement Control
58	Displacement control option Global Control : 0 Master Node Control : 1	"iCTRL"		🔴
59	Maximum Translational Displacement	"TINC"		🔴
60	Master node No.	"MNODE"		🔴
61	Master direction DX : 1 DY : 2 DZ : 3	"MDIR"		🔴

The JSON format example for inputting Time History Load Case

    "THIS": {
        "1": {
            "COMMON": {
                "NAME": "LC",
                "DESC": "desc",
                "iATYPE": 2,
                "iAMETHOD": 2,
                "iTHTYPE": 1,
                "iGEOM": 0,
                "ENDTIME": 1.0,
                "INC": 1.0,
                "iOUT": 1,
                "INITLOAD": 1,
                "INITMETHOD": "INIT",
                "bSUBSEQ": false,
                "iMDTYPE": 2
            },
            "iCOEF": 2,
            "bMASSP": true,
            "bSTIFFP": true,
            "iCALC": 2,
            "FP1": 1,
            "DR1": 0,
            "FP2": 1,
            "DR2": 0,
            "iNMM": 3,
            "GAMMA": 0,
            "BETA": 0,
            "bITER": true,
            "bCONV": false,
            "MINSSS": 0.00001,
            "iMAXITER": 10,
            "bDN": true,
            "DN": 0.001,
            "bFN": true,
            "FN": 0.001,
            "bEN": true,
            "EN": 0.001,
            "DMUPDATE": false,
            "iRKM": 0,
            "dTOL": 1e-8,
            "bULSM": true,
            "ULSM": 5
        }
}

M-Suite Beta

[THIS] Time History Load Cases

Related content