[THGC] Time History Global Control

    "THGC": {
        "ENERGYRESULT": {
            "__DESC__": "Time history energy result",
            "__TYPE__": "Bool"
        },
        "SDVI": {
            "__DESC__": "Viscous damper / Oil damper result",
            "__TYPE__": "Bool"
        },
        "SDVE": {
            "__DESC__": "Viscoelastic damper result",
            "__TYPE__": "Bool"
        },
        "SDST": {
            "__DESC__": "Steel damper result",
            "__TYPE__": "Bool"
        },
        "SDHY": {
            "__DESC__": "Hysteretic isolator result",
            "__TYPE__": "Bool"
        },
        "SDIS": {
            "__DESC__": "Isolator result",
            "__TYPE__": "Bool"
        },
        "bMSSSTATUS": {
            "__DESC__": "MSS Model Yield status",
            "__TYPE__": "Bool"
        },
        "GNT": {
            "__DESC__": "Geometry nonlinearity type",
            "__TYPE__": "Integer"
        },
        "ILT": {
            "__DESC__": "Initial load type",
            "__TYPE__": "Integer"
        },
        "IEPI": {
            "__DESC__": "Consider ‘Ignore Elements for NL. Anslysis Initial Load’",
            "__TYPE__": "Bool"
        },
        "NSTEP": {
            "__DESC__": "Increment step [nstep]",
            "__TYPE__": "Integer"
        },
        "bROT": {
            "__DESC__": "Result output type",
            "__TYPE__": "Bool"
        },
        "SNIO": {
            "__DESC__": "Step number increment for output",
            "__TYPE__": "Integer"
        },
        "bPCF": {
            "__DESC__": "Permit convergence failure",
            "__TYPE__": "Bool"
        },
        "MAXNS": {
            "__DESC__": "Max. number of substeps",
            "__TYPE__": "Integer"
        },
        "MAXIT": {
            "__DESC__": "Maximum iteration",
            "__TYPE__": "Integer"
        },
        "bDN": {
            "__DESC__": "Displacement norm",
            "__TYPE__": "Bool"
        },
        "bFN": {
            "__DESC__": "Force norm",
            "__TYPE__": "Bool"
        },
        "bEN": {
            "__DESC__": "Energy Norm",
            "__TYPE__": "Bool"
        },
        "DN": {
            "__DESC__": "Displacement norm - Value",
            "__TYPE__": "Real"
        },
        "FN": {
            "__DESC__": "Force norm - Value",
            "__TYPE__": "Real"
        },
        "EN": {
            "__DESC__": "Energy Norm - Value",
            "__TYPE__": "Real"
        },
        "bULSM": {
            "__DESC__": "Use line search method",
            "__TYPE__": "Bool"
        },
        "ULSM": {
            "__DESC__": "Number of iteration to start line search",
            "__TYPE__": "Integer"
        },
        "aILL": {
            "__DESC__": "Init Load List",
            "__TYPE__": [
                {
                    "SLC": {
                        "__DESC__": "Static load case name",
                        "__TYPE__": "String"
                    },
                    "SF": {
                        "__DESC__": "Scale Factor",
                        "__TYPE__": "Real"
                    },
                    "LCT": {
                        "__DESC__": "Load Case Type",
                        "__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 Global Control

NO.	Name	API - Key	API - Value Type	Default	TH. Global Control

NO.	Name	API - Key	Default	TH. Global Control
1	Time History Global Control No.	“KEY”		🔴
	Geometric Nonlinearity Type
2	Geometric Nonlinearity Type None : 0 Large Displacements : 1	"GNT"		🔴
	Initial Load
3	Initial load type Perform Nonlinear Static Analysis for Initial load : 0 Import Static Analysis / Construction Stage Analsysis Result : 1	"ILT"		🔴
4	Consider ‘Ignore Elements for NL. Anslysis Initial Load’	"IEPI"	FALSE	🔺
5	Init Load List	"aILL"
6	Static load case name	"SLC"		🔴
7	Scale Factor	"SF"		🔴
8	Load Case Type Static Load Case : 1 Construction Load : 18	"LCT"		🔴
	Increment Step
9	Increment step [nstep]	"NSTEP"		🔺
10	Result output type Final Step Only : false Step Number Increment for Output : true	"bROT"	FALSE	🔺
11	Step number increment for output	"SNIO"	0	🔺
	Iteration Parameters
12	Permit convergence failure	"bPCF"		🔴
13	Max. number of substeps	"MAXNS"		🔴
14	Maximum iteration	"MAXIT"		🔴
15	Displacement norm	"bDN"	TRUE	🔺
16	Force norm	"bFN"	FALSE	🔺
17	Energy Norm	"bEN"	FALSE	🔺
18	Displacement norm - Value	"DN"	0.001	🔺
19	Force norm - Value	"FN"	0	🔺
20	Energy Norm - Value	"EN"	0	🔺
21	Use line search method	"bULSM"	FALSE	🔺
22	Number of iteration to start line search	"ULSM"	0	🔺
	Seismic Control Device Result
23	Time history energy result	"ENERGYRESULT"	FASLE	🔺
24	Viscous damper / Oil damper result	"SDVI"	FASLE	🔺
25	Viscoelastic damper result	"SDVE"	FASLE	🔺
26	Steel damper result	"SDST"	FASLE	🔺
27	Hysteretic isolator result	"SDHY"	FASLE	🔺
28	Isolator result	"SDIS"	FASLE	🔺
29	MSS Model Yield status	"bMSSSTATUS"	FASLE	🔺

The JSON format example for inputting Time History Global Control

    "THGC": {
        "1": {
            "ENERGYRESULT": true,
            "SDVI": true,
            "SDVE": true,
            "SDST": true,
            "SDHY": true,
            "SDIS": true,
            "bMSSSTATUS": true,

            "GNT": 0,
            "ILT": 0,
            "IEPI": false,
            "NSTEP": 3,
            "bROT": true,
            "SNIO": 4,

            "bPCF": true,
            "MAXNS": 10,
            "MAXIT": 11,
            "bDN": true,
            "bFN": false,
            "bEN": false,
            "DN": 0.001,
            "FN": 0.0,
            "EN": 0.0,
            "bULSM": true,
            "ULSM": 5,

            "aILL": [
                {
                    "SLC": "LC1",
                    "SF": 1.0,
                    "LCT": 1
                },
                {
                    "SLC": "LC2",
                    "SF": 1.0,
                    "LCT": 1
                }
            ]
        }
    }