Skip to main content
JSON Manual Created Edited

MIDAS API Online Manual

ICON_CIVIL JSON.png

 

INTRODUCTION

This page provides the MIDAS API JSON Structure manual relative to MIDAS CIVIL NX. MIDAS API works based on the RESTFul API, and the manual offers each function's endpoint, method, JSON structure, and examples.
The manual has five sections of End Point, each with its characteristics. The user can find more details on each section.

 

 

DOC

This section of End Point works on the Document part. Only working with the POST Method, and The body starts with the "Argument" Key. In the case of the body being empty under the "Argument," the API is designed to work with the empty body such as "{}".



No. End Point Details

1

/doc/NEW

New Project ↗

2

/doc/OPEN

Open Project ↗

3

/doc/CLOSE

Close Project ↗

4

/doc/SAVE

Save ↗

5

/doc/SAVEAS

Save As ↗

6

/doc/IMPORT

Import to Json ↗

7

/doc/IMPORTMXT

Import to mct/mgt ↗

8

/doc/EXPORT

Export to Json ↗

9

/doc/EXPORTMXT

Export to mct/mgt ↗

10

/doc/ANAL

Perform Analysis ↗



DB

The DB End Point is data saved in a MIDAS CIVIL NX file. It is comparable to the MCT function.

Generally, it consists of the POST/GET/PUT/DELETE Method; however, some essential data when the user creates a new file, such as Unit, Structure Type, etc., only work GET/PUT Method.

When using the GET Method, the first Key indicates the endpoint, and it must start with "Assign" for the first Key using the POST/PUT method.

After that, the JSON body begins with the number Key, which has different meanings depending on the data. For example, the number Key indicates the Section ID Number in the Section, and in the Load Combinations, it indicates created sequences. The unique data, such as Unit, has only "1" data.

After the number Key, the user can check the JSON body structure under the table.

 

Project

No. End Point Details

1

/db/PJCF

Project Information ↗

2

/db/UNIT

Unit System ↗

3

/db/STYP

Structure Type ↗

4

/db/GRUP

Structure Group ↗

5

/db/BNGR

Boundary Group ↗

6

/db/LDGR

Load Group ↗

7

/db/TDGR

Tendon Group ↗

 

View

No. End Point Details

1

/db/NPLN

Named Plane ↗

2

/db/CO_M

Material Color ↗

3

/db/CO_S

Section Color ↗

4

/db/CO_T

Thickness Color ↗

5

/db/CO_F

Floor Load Color ↗

 

Structure

No. End Point Details

1

/db/SPAN

Span Information ↗

 

Node/Element

No. End Point Details

1

/db/NODE

Node ↗

2

/db/ELEM

Element ↗

3

/db/SKEW

Node Local Axis ↗

4

/db/MADO

Define Domain ↗

5

/db/SBDO

Define Sub-Domain ↗

6

/db/DOEL

Domain-Element ↗

 

Properties

No. End Point Details

1

/db/MATL

Material Properties ↗

2

/db/IMFM

Inelastic Material Properties for Fiber Model ↗

3

/db/TDMF

Time Dependent Material Properties - User Defined ↗

4

/db/TDMT

Time Dependent Material Properties - Creep/Shrinkage ↗

5

/db/TDME

Time Dependent Material Properties - Compressive Strength ↗

6

/db/EDMP

Change Property ↗

7

/db/TMAT

Time Dependent Material Link ↗

8

/db/EPMT

Plastic Material ↗

9

/db/SECT

Section Properties - Common ↗

Section Properties - DB/User ↗

Section Properties - Value ↗

Section Properties - SRC ↗

Section Properties - Combined ↗

Section Properties - PSC ↗

Section Properties - PSC Value ↗

Section Properties - Composite - PSC ↗

Section Properties - Composite - Steel ↗

Section Properties - Steel Girder ↗

Section Properties - Tapered - DB/User ↗

Section Properties - Tapered - Value ↗

Section Properties - Tapered - PSC ↗

Section Properties - Tapered - PSC Value ↗

Section Properties - Tapered - Composite PSC ↗

Section Properties - Tapered - Composite Steel ↗

Section Properties - Tapered - Steel Girder ↗

10

/db/THIK

Thickness - Value ↗

Thickness - Stiffened DB ↗

Thickness - Stiffened User ↗

Thickness - Stiffened Value ↗

11

/db/TSGR

Tapered Group ↗

12

/db/SECF

Section Manager - Stiffness ↗

13

/db/RPSC

Section Manager - Reinforcements ↗

14

/db/STRPSSM

Section Manager - Stress Points ↗

15

/db/PSSF

Section Manager - Plate Stiffness Scale Factor ↗

16

/db/VBEM

Section Manager - Section for Resultant Forces - Virtual Beam ↗

17

/db/VSEC

Section Manager - Section for Resultant Forces - Virtual Section ↗

18

/db/EWSF

Effective Width Scale Factor ↗

19

/db/IEHC

Inelastic Hinge Control Data ↗

20

/db/IEHG

Assign Inelastic Hinge Properties ↗

21

/db/FIMP

Inelastic Material Properties ↗

22

/db/FIBR

Fiber Division of Section ↗

23

/db/GRDP

Group Damping ↗

 

Boundary

 

Static Loads

 

Temperature Loads

No. End Point Details

1

/db/ETMP

Element Temperature ↗

2

/db/GTMP

Temperature Gradient ↗

3

/db/BTMP

Beam Section Temperature ↗

4

/db/STMP

System Temperature ↗

5

/db/NTMP

Nodal Temperature ↗

 

Prestress Loads

 

Moving Loads

No. End Point Details

1

/db/MVCD

Moving Load Code ↗

2

/db/LLAN

Traffic Line Lanes ↗

3

/db/LLANch

Traffic Line Lanes - China ↗

4

/db/LLANid

Traffic Line Lanes - India ↗

5

/db/LLANtr

Traffic Line Lanes - Transverse ↗

6

/db/LLANop

Traffic Line Lanes - Moving Load Optimizaion ↗

7

/db/SLAN

Traffic Surface Lanes ↗

8

/db/SLANch

Traffic Surface Lanes - China ↗

9

/db/SLANop

Traffic Surface Lanes - Moving Load Optimization ↗

10

/db/MVHL

Vehicles - AASHTO Standard ↗

Vehicles - AASHTO LRFD ↗

Vehicles - PENNDOT ↗

Vehicles - Canada ↗

Vehicles - BS ↗

Vehicles - Eurocode ↗

Vehicles - Australia ↗

Vehicles - Poland ↗

Vehicles - Russia ↗

Vehicles - South Africa ↗

Vehicles - Korea ↗

Vehicles - KSCE-LSD15 ↗

Vehicles - China ↗

Vehicles - India ↗

Vehicles - Taiwan ↗

11

/db/MVHLtr

Vehicles - Transverse ↗

12

/db/MVLD

Moving Load Cases ↗

13

/db/MVLDch

Moving Load Cases - China ↗

14

/db/MVLDid

Moving Load Cases - India ↗

15

/db/MVLDbs

Moving Load Cases - BS ↗

16

/db/MVLDeu

Moving Load Cases - Eurocode ↗

17

/db/MVLDpl

Moving Load Cases - Poland ↗

18

/db/MVLDtr

Moving Load Cases - Transverse ↗

19

/db/CRGR

Concurrent Reaction Group ↗

20

/db/CJFG

Concurrent Joint Force Group ↗

21

/db/MVHC

Vehicle Classes ↗

22

/db/SINF

Plate Element for Influence Surface ↗

23

/db/MLSP

Lane Support - Negative Moments at Interior Piers ↗

24

/db/MLSR

Lane Support - Reactions at Interior Piers ↗

25

/db/DYLA

Dynamic Load Allowance ↗

26

/db/IMPF

Additional Impact Factor ↗

27

/db/DYFG

Railway Dynamic Factor ↗

28

/db/DYNF

Railway Dynamic Factor by Element ↗

 

Dynamic Loads

 

Construction Stage Loads

 

Heat of Hydration Loads

 

Settlement Loads

No. End Point Details

1

/db/SMPT

Settlement Group ↗

2

/db/SMLC

Settlement Load Cases ↗

 

Miscellaneous Loads

 

Grid Model Analysis Loads

No. End Point Details

1

/db/GALD ᴶ⁾

Grid Analysis Load ↗

ᴶ⁾ MIDAS CIVIL NX JP Version only

 

Analysis

 

Analysis Results

 

Bridge Specialization Results

 

Time History Analysis Results

 

Heat of Hydration Results

No. End Point Details

1

/db/HHND

Heat of Hydaration Result Graph ↗

 

Pushover

 

Design



OPE

OPE indicates operation functions. It contains application functions that can be controlled using a GUI or checked for pre-process values that do not save in the database(DB).

No. End Point Details

1

/ope/PROJECTSTATUS

Project Status ↗

2

/ope/DIVIDEELEM

Divide Elements ↗

3

/ope/SECTPROP

Section Properties Calculation Results ↗

4

/ope/USLC

Using Load Combinations ↗

5

/ope/LINEBMLD

Line Beam Load ↗

6

/ope/AUTOMESH

Auto-Mesh Planar Area ↗

7

/ope/SSPS

Surface Spring ↗

8

/ope/EDMP

Change Property ↗



VIEW

It works in a Model view. Each function can be used independently, however, Capture function can be use d Angle, Active, Display, and Resultgraphic together.

 

No. End Point Details

1

/view/SELECT

Select ↗

2

/view/CAPTURE

Capture ↗

3

/view/PRECAPTURE

Dialog Capture ↗

4

/view/ANGLE

Viewpoint ↗

5

/view/ACTIVE

Active ↗

6

/view/DISPLAY

Display ↗

7

/view/RESULTGRAPHIC

Type of Display ↗

Reaction Forces/Moments - Result Display ↗

Soil Pressure - Result Display ↗

Deformed Shape - Result Display ↗

Displacement Contour - Result Display ↗

Truss Forces - Result Display ↗

Beam Forces/Moments - Result Display ↗

Beam Diagrams - Result Display ↗

Plate Forces/Moments - Result Display ↗

Plate Cutting Line Diagram - Result Display ↗

Truss Stresses - Result Display ↗

Beam Stresses - Result Display ↗

Beam Stresses Diagram - Result Display ↗

Beam Stresses (Equivalent) - Result Display ↗

Beam Stresses Diagram (Equivalent) - Result Display ↗

Beam Stresses (PSC) - Result Display ↗

Plane-Stress/Plate Stresses - Result Display ↗

Plane Strain Stresses - Result Display ↗

Axisymmetric Stresses - Result Display ↗

Solid Stresses - Result Display ↗

Reactions - Moving Tracer Display ↗

Displacements - Moving Tracer Display ↗

Truss Forces - Moving Tracer Display ↗

Beam Forces/Moments - Moving Tracer Display ↗

Plate Forces/Moments - Moving Tracer Display ↗

Beam Stresses - Moving Tracer Display ↗

Vibration Mode Shapes - Mode Shapes Display ↗

Buckling Mode Shapes - Mode Shapes Display ↗

Stress - Heat of Hydration Display ↗

Temperature - Heat of Hydration Display ↗

Displacements - Heat of Hydration Display ↗

Allowable Tensile Stress - Heat of Hydration Display ↗

Crack Ratio - Heat of Hydration Display ↗



POST

The POST is used to extract the pre/post-processing table generated by calculations.

 

Pre-Process Table

No. Table Type Details

1

Element Weight

Element Weight Table ↗

2

Nodal Body Force

Nodal Body Force Table ↗

3

Mass Summary

Mass Summary Table ↗

4

Load Summary

Load Summary Table ↗

 

Analysis Result Table

No. Table Type Details

1

Reaction-Local

Reaction-Global

Reaction-Local-Surface Spring

Reaction - Analysis Result Table ↗

2

Displacement-Local

Displacement-Global

Displacements - Analysis Result Table ↗

3

Truss Force

Truss Force - Analysis Result Table ↗

Truss Stress

Truss Stress - Analysis Result Table ↗

4

Cable Force

Cable Force - Analysis Result Table ↗

Cable Configuration

Cable Configuration - Analysis Result Table ↗

Cable Efficiency

Cable Efficiency - Analysis Result Table ↗

5

Beam Force

Beam Force-View by Max Value Item

Beam Force - Analysis Result Table ↗

Beam Static Prestress

Beam Force (Static Prestress) - Analysis Result Table ↗

Beam Stress

Beam Stress-View by Max Value Item

Beam Stress-7DOF

Beam Stress - Analysis Result Table ↗

Beam Stress-Equivalent

Beam Stress (Equivalent) - Analysis Result Table ↗

Beam Stress-PSC

Beam Stress-PSC 7DOF

Beam Stress (PSC) - Analysis Result Table ↗

6

Plate Force-Local

Plate Force (Local) - Analysis Result Table ↗

Plate Force-Global

Plate Force (Global) - Analysis Result Table ↗

Plate Force-Unit Length(Local)

Plate Force-Unit Length(Local-View by Max Value Items)

Plate Force-Unit Length(UCS)

Plate Force-Unit Length(UCS-View by Max Value Items)

Plate Force-Unit Length(W-A Moment)

Plate Force (Unit Length) - Analysis Result Table ↗

Plate Stress-Local

Plate Stress (Local) - Analysis Result Table ↗

Plate Stress-Global

Plate Stress (Global) - Analysis Result Table ↗

Plate Total Strain-Local

Plate Plastic Strain-Local

Plate Strain (Local) - Analysis Result Table ↗

Plate Total Strain-Global

Plate Plastic Strain-Global

Plate Strain (Global) - Analysis Result Table ↗

7

Plane Stress Force-Local

Plane Force (Local) - Analysis Result Table ↗

Plane Stress Force-Global

Plane Force (Global) - Analysis Result Table ↗

Plane Stress Stress-Local

Plane Stress (Local) - Analysis Result Table ↗

Plane Stress Stress-Global

Plane Stress (Global) - Analysis Result Table ↗

8

Plane Strain Force-Local

Plane Strain Force (Local) - Analysis Result Table ↗

Plane Strain Force-Global

Plane Strain Force (Global) - Analysis Result Table ↗

Plane Strain Stress-Local

Plane Strain Stress (Local) - Analysis Result Table ↗

Plane Strain Stress-Global

Plane Strain Stress (Global) - Analysis Result Table ↗

9

Axisymmetric Force-Local

Axisymmetric Force (Local) - Analysis Result Table ↗

Axisymmetric Force-Global

Axisymmetric Force (Global) - Analysis Result Table ↗

Axisymmetric Stress-Local

Axisymmetric Stress (Local) - Analysis Result Table ↗

Axisymmetric Stress-Global

Axisymmetric Stress (Global) - Analysis Result Table ↗

10

Solid Force-Local

Solid Force (Local) - Analysis Result Table ↗

Solid Force-Global

Solid Force (Global) - Analysis Result Table ↗

Solid Stress-Local

Solid Stress (Local) - Analysis Result Table ↗

Solid Stress-Global

Solid Stress (Global) - Analysis Result Table ↗

Solid Total Strain-Local

Solid Plastic Strain-Local

Solid Strain (Local) - Analysis Result Table ↗

Solid Total Strain-Global

Solid Plastic Strain-Global

Solid Strain (Global) - Analysis Result Table ↗

11

Elastic Link

View by Max Value Item

Elastic Link - Analysis Result Table ↗

12

General Link Force

General Link Force-View by Max Value Item

General Link Deformation

General Link - Analysis Result Table ↗

13

Resultant Force

Resultant Force-View by Max Value Item

Resultant Forces - Analysis Result Table ↗

14

Vibartion Mode-Eigenvalue

Vibartion Mode-Participation Vector

Vibration Mode Shape - Analysis Result Table ↗

15

Buckling Mode

Buckling Mode Shape - Analysis Result Table ↗

16

Effective Span Length-Truss

Effective Span Length-Beam

Effective Span Length-Plate

Effective Span Length - Analysis Result Table ↗

17

Nodal Results of RS-Inertia Force

Nodal Results of RS-Acceleration

Nodal Results of RS - Analysis Result Table ↗

18

Tendon Coordinates

Tendon Coordinates - Analysis Result Table ↗

Tendon Elongation

Tendon Elongation - Analysis Result Table ↗

Tendon Arrangement

Tendon Arrangement - Analysis Result Table ↗

Tendon Loss-Stress

Tendon Loss-Force

Tendon Loss - Analysis Result Table ↗

Tendon Weight-Profile

Tendon Weight-Property

Tendon Weight-Group

Tendon Weight - Analysis Result Table ↗

Tendon Stress Limit Check

Tendon Stress Limit Check - Analysis Result Table ↗

Tendon Approximate Loss-Stress

Tendon Approximate Loss-Force

Tendon Approximate Loss - Analysis Result Table ↗

19

Composite Section for C.S. Force

Composite Section for C.S. Stress

Composite Section for C.S. (Force and Stress) - Analysis Result Table ↗

Composite Section for C.S. Self-Constraint Force

Composite Section for C.S. Self-Constraint Stress

Composite Section for C.S. (Self-Constraint Force and Stress) - Analysis Result Table ↗

20

Element Properties at Each Stage

Element Properties at Each Stage - Analysis Result Table ↗

Beam Section Properties at Last Stage

Beam Section Properties at Last Stage - Analysis Result Table ↗

21

Lack of Fit Force-Truss

Lack of Fit Force (Truss) - Analysis Result Table ↗

Lack of Fit Force-Beam

Lack of Fit Force (Beam) - Analysis Result Table ↗

Lack of Fit Force-Plate

Lack of Fit Force (Plate) - Analysis Result Table ↗

22

Equilibrium Element Nodal Force

Equilibrium Element Nodal Force - Analysis Result Table ↗

23

Initial Element Force

Initial Element Force - Analysis Result Table ↗

 

Time History Result Table

No. Table Type Details

1

Displacement

Velocity

Absolute Acceleration

Relative Acceleration

Displacement/Velocity/Acceleration - TH Result Table ↗

2

Beam Force

Beam Force - TH Result Table ↗

3

Truss Force

Truss Force - TH Result Table ↗

4

General Link Force

Deformation

General Link - TH Result Table ↗

5

Event Time-Lumped

Event Time-Distributed

Event Time-Wall

Event Time-Truss

Event Time-Spring

Inelastic Hinge Event Time - TH Result Table ↗

6

Beam Summary-DX

Beam Summary-DY

Beam Summary-DZ

Beam Summary-RY

Beam Summary-RZ

Inelastic Hinge Beam Summary - TH Result Table ↗

7

Truss Summary-DX

Inelastic Hinge Truss Summary - TH Result Table ↗

8

General Link Summary-DX

General Link Summary-DY

General Link Summary-DZ

General Link Summary-RX

General Link Summary-RY

General Link Summary-RZ

Inelastic Hinge General Link Summary - TH Result Table ↗

9

Force-Lumped

Force-Distributed

Force-Wall

Force-Truss

Force-Spring

Inelastic Hinge Force - TH Result Table ↗

10

Deformation-Lumped

Deformation-Distributed

Deformation-Wall

Deformation-Truss

Deformation-Spring

Inelastic Hinge Deformation - TH Result Table ↗

11

Element Rotation-Beam

Element Rotation-Wall

Inelastic Hinge Element Rotation - TH Result Table ↗

12

Ductility Factor(D/D1)-Lumped

Ductility Factor(D/D1)-Distributed

Ductility Factor(D/D1)-Wall

Ductility Factor(D/D1)-Truss

Ductility Factor(D/D1)-Spring

Inelastic Hinge Ductility Factor(D/D1) - TH Result Table ↗

13

Ductility Factor(D/D2)-Lumped

Ductility Factor(D/D2)-Distributed

Ductility Factor(D/D2)-Wall

Ductility Factor(D/D2)-Truss

Ductility Factor(D/D2)-Spring

Inelastic Hinge Ductility Factor(D/D2) - TH Result Table ↗

14

Estimate Yield Strength

Fiber Section Estimate Yield Strength - TH Result Table ↗

15

Elastic Modulus Retention Rate ᴶ⁾

Fiber Section Elastic Modulus Retention Rate - TH Result Table ↗

16

Maximum Strain of The Cell ᴶ⁾

Fiber Section Maximum Strain of The Cell - TH Result Table ↗

17

Event Step ᴶ⁾

Fiber Section Event Step - TH Result Table ↗

18

Average Compression Strain ᴶ⁾

Fiber Section Average Compression Strain - TH Result Table ↗

ᴶ⁾ MIDAS CIVIL NX JP Version only

 

Heat of Hydration Result Table

No. Table Type Details

1

Stress-Local

Stress-Global

Stress - HY Result Table ↗

2

Temperature

Temperature - HY Result Table ↗

3

Displacement

Displacement - HY Result Table ↗

4

Tensile Stress

Tensile Stress - HY Result Table ↗

5

Pipe Cooling Nodal Temperature

Pipe Cooling Nodal Temperature - HY Result Table ↗

 

Time History Text

No. Text Type Details

1

Node Results

Time History Text - Node Results ↗

2

Element Result(Truss, Beam, Plane Stress/Strain, Solid)

Time History Text - Element Result(Truss, Beam, Plane Stress/Strain, Solid) ↗

3

Element Result(Plate)

Time History Text - Element Result(Plate) ↗

4

Element Result(Wall)

Time History Text - Element Result(Wall) ↗

5

General Link Result

Time History Text - General Link Result ↗

 

Pushover Text

No. Text Type Details

1

Displacement Result

Pushover Text - Displacement Result ↗

2

Element Result(Beam, Truss)

Pushover Text - Element Result(Beam, Truss) ↗

3

Element Result(Wall)

Pushover Text - Element Result(Wall) ↗

4

General Link Result

Pushover Text - General Link Result ↗

5

Elastic Link Result

Pushover Text - Elastic Link Result ↗

 

Design

No. End Point Details

1

/post/PM

P-M Interaction Diagram ↗



0
Was this article helpful?