18_03_XML_import

Import from XML open format

Hydrosystem provides the ability to import pipeline geometry and other parameters from Hydrosystem's own "open" (neutral) format (XML files). Using these files, the user can set up the integration of Hydrosystem with any other program (a 3D design system or another system that stores the parameters of the pipelines) by developing a special data converter that will load information from this program into XML format (with a structure and content "understandable" to Hydrosystem).

To run the import program, select the Import… option from the File menu and specify the corresponding file with the XML extension. Once the import program is finished, a new project will be created in the project tree. If errors are detected during the file syntax check, a list of them will be presented to the user in a dialog box.

The XML file schema is supplied with the program (the “OpenFormat.xsd” file in the Hydrosystem installation directory). The table of components codes and their corresponding properties is given below:

Component name	Code	Parameter 1	Parameter 2	Parameter 3	Parameter 4
Straight pipe	0	Length, m
Straight pipe entrance	1
Pipe enter at 45° angle	2
Straight pipe exit	22
Elbow	3	Radius, mm	Angle, deg.
Mitre bend, 90°	12	Radius, mm
Mitre bend R=1.5D, 60°	8
Mitre bend R=1.5D, 45°	9
Mitre bend R=1.5D, 30°	7
Flow turn	5	New inner diameter, mm	New outer diameter, mm
Flow turn in tee	6	New inner diameter, mm	New outer diameter, mm
Z-type flow turn	14
Expansion joint	21
U-type expansion loop	10	Depth, m	Width, m
Reducer	25	Length, mm	New inner diameter, mm	New outer diameter, mm
Sudden contraction/expansion	24		New inner diameter, mm	New outer diameter, mm
Gate valve	16	Valve opening	Kv
Pinch valve	17	Valve opening	Kv
Knife gate valve	15	Valve opening	Kv
Butterfly valve	19	Closing angle, deg.	Kv
Swing check valve	18		Kv
Lift check valve	20		Kv
Forged globe valve	33		Kv
Globe valve	31		Kv
Globe valve type rey	32		Kv
Angle valve	34		Kv
Ball valve	35		Kv
Control valve	36	Flow rate in user-specified units	Kv
Orifice	23	Orifice/pipe diameter ratio
Tee (side leg)	28
Tee (main leg)	29
Elevation change	100	Elevation difference, m
Component with known change of pressure and/or temperature	99	Change of pressure, MPa	Change of temperature, C	Density, kg/m3 (if fluid is specified by properties)	Viscosity, cSt (if fluid is specified by properties)
Component with known loss coefficient	98	Loss coefficient		Density, kg/m3 (if fluid is specified by properties)	Viscosity, cSt (if fluid is specified by properties)
Pump	97	New inner diameter, mm	New outer diameter, mm	Density, kg/m3 (if fluid is specified by properties)	Viscosity, cSt (if fluid is specified by properties)
Waterhammer damper	101	Orifice area, m2	Total volume, m3	Gas volume, m3
Reservoir	102	Liquid level, m	Nozzle connection angle, deg	Density, kg/m3 (if fluid is specified by properties)	Viscosity, cSt (if fluid is specified by properties)

Since the pipeline calculation model in Hydrosystem differs in structure and parameters from the pipeline model in the program from which this XML file was obtained, it is recommended that after importing, the resulting piping model be carefully checked, especially the types of valves and other parameters of the elements.

In addition, since pipes may be imported as a sequence of several individual pipe sections (for example, if they are modeled in this way in the system from which the imported XML file was obtained), it is recommended to merge such sections with each other after importing the piping model for a more convenient presentation of the pipeline model. To do this, select the imported pipeline in the Project Tree in the Hydrosystem and use the "Integrate Pipes" command of the Edit toolbar (or use the corresponding option in the "Edit" menu).