Power*Tools
for Windows
™
SPEL-SKM Data Exchange
Reference Manual
Electrical Engineering Analysis Software
for Windows
Copyright © 2016, SKM Systems Analysis, Inc.
All Rights Reserved.
SPEL-SKM Data
Exchange Users Guide
Intergraph SmartPlant Electrical (SPEL) Data Exchange Module
This SKM-SPEL Data Exchange module enables electrical engineers to import SPEL electrical
equipment and components data and connections into SKM projects conveniently and accurately.
They can then conduct various complex analyses using SKM’s calculation engine. The results are
saved in the project database and can be exported back to the SPEL database. This is a very useful
tool for electrical engineers planning, designing, maintaining and operating a complex electrical
distribution system.
SmartPlant Electrical (SPEL) is designed to meet specific needs of electrical engineers by
automating work processes, complying with corporate or project standards and manipulating
electrical data throughout the plant and project life cycle. The software allows you to create
electrical equipment and components, determine the load requirements in your plant, keep track of
your electrical inventory, size your plant cables, and establish the electrical relationships among the
different electrical components. You can use SPEL to generate and display single line diagrams,
schematic drawings, wiring drawings, and cable block diagrams.
SKM software provides powerful calculation engine to conduct various complex analyses of
electrical power systems, such as load flow analysis, fault analysis, harmonic analysis, transient
stability analysis, cable ampacity calculation, arc flash calculation, reliability evaluation, protective
device coordination etc.
Both software packages work complimentary to each other by supporting each other’s strengths.
The block diagram shown below illustrates the data flow process.
Data Exchange
SKM SKM User Interface SPEL SPEL
Project XML XML Project
The Data Exchange User Interface allows adding or modifying data fields as data is exchanged
between the software packages.
TABLE OF CONTENTS
SPEL-SKM DATA EXCHANGE USERS GUIDE
1.1 Activating and Starting Data Exchange 1-3
1.2 Data Mapping Table Editor 1-4
1.3 Importing SPEL XML into SKM Project 1-7
1.4 Exporting SKM Project into SPEL XML 1-9
1.5 Publishing Equipment from SmartPlant Electrical (Export XML) 1-10
1.6 Unsupported Components 1-12
1.7 Advanced Topics 1-13
SPEL-SKM Data Exchange Users Guide 1-3
1.1 Activating and Starting Data Exchange
The SKM-SPEL interface requires the purchase of the Data Exchange module. Contact SKM Sales
at sales@[Link] or 1-800-500-4SKM for pricing information if you require this module.
Once the Data Exchange module is activated, it can be accessed through the Project menu > Export
and Import, depending on whether you want to Export to SPEL or Import from SPEL.
To get started, an SKM project must be opened for the Export and Import selection to be active.
Then select Project menu > Export or Import as shown below.
Figure 1.1: Data Exchange Interface
1.2 Data Mapping Table Editor
Although defaults have been preconfigured, you must first verify that the component mapping
between both software project is accurate to your specifications. There are two levels of mapping –
component (equipment) and attribute (field) mapping.
Component mapping refers to mapping of various electrical equipment such as transformers, cables,
protective devices, etc.
Attribute mapping refers to mapping of component information such as motor size, transformer size,
cable lengths, etc.
The mapping between SKM Component and SPEL Equipment are predefined as shown in Table 1.
The left column lists the SPEL equipment currently supported by the Data Exchange program. The
second column displays the SKM components corresponding to the SPEL equipment. This table
may be changed by contacting SKM Technical Support.
SPEL Equipment SKM Component
2-Winding Transformer 2-Winding Transformer
3-Winding Transformer 3-Winding Transformer
Battery Bank Battery
Bus Bus
Junction Box Bus
Local Panel Bus
Cable Cable
Capacitor Capacitor
Fuse Fuse
HV Circuit Breaker HV Breaker
Induction Motor Induction Motor
LV Circuit Breaker LV Breaker
Cabinet Non-Motor Load (Cabinet)
Heater Non-Motor Load (Heat Trace)
HeatTrace Non-Motor Load (Heater)
Instrument Non-Motor Load (Instrument)
SPEL-SKM Data Exchange Users Guide 1-5
Light Fixture Non-Motor Load (Lighting)
Socket Outlet Non-Motor Load (Socket Outlet)
Welding Outlet Non-Motor Load (Welding Outlet)
Busway PI Equivalent
Recloser Recloser
Battery Charger Rectifier
Overload Heater Relay
Resister Resister
Current Limiting Reactor Series Reactor
Harmonic Filter Single Tune Filter
Contactor Specialty Device
Starter Specialty Device
Disconnect Switch Switch
Generator Synchronous Generator
Synchronous Motor Synchronous Motor
UPS UPS
OffSite Power Utility
Variable Frequency Drive VFD
Table 1: Mapping of SPEL Equipment to SKM Components
SPEL equipment attributes may be mapped to SKM component attributes using the data mapping
editor as shown in Figure 1.2. Predetermined default mappings are included for commonly used
attributes.
Figure 1.2: Data Mapping Editor showing Component mapping (left side) and Attribute mapping
(right side).
The table on the left is the mapping between SPEL Equipment vs SKM Components. The SPEL
Equipment column lists the SPEL equipment supported currently by the Data Exchange program.
The second column, SKM Component, displays the components corresponding to or mapping to the
SPEL equipment. This table is not editable, but may be changed through SKM Technical Support.
The table on the right is the mapping of SPEL Equipment attributes and SKM Component attributes.
The SKM data fields are predefined. Users can map SPEL data into SKM. The SPEL data fields
are selectable from a list. The predefined SKM data field list can also be changed and expanded
through SKM Technical Support.
SPEL-SKM Data Exchange Users Guide 1-7
1.3 Importing SPEL XML into SKM Project
SPEL equipment uses unique identifier (uid) and itemTag in for identification purposes. They are
mapped to SKM component AltID (Alternate UID in Datablock) and name (ComponentName in
Datablock) attributes respectively. The uid is used to check if the equipment has been already
imported.
Figure 1.3 shows the Import interface. Select SmartPlant Electrical XML Import Format and click
on the Browse button to find and select the SPEL XML file. Once an XML file is selected, click on
the Import button.
Figure 1.3: SPEL Data Import Interface
Figure 1.4: Sucessessful SPEL XML import.
During the import process, if the existing SKM project has a component with the same Alternate
UID, the software will prompt with options to overwrite the existing SKM component.
Figure 1.5: Duplicate Alternate UID
Note: One line drawings are not automatically created. However, the SKM Existing and Expand
functions can aid in creating a one line diagram. Create a new empty one line drawing. Right-click
on a blank area and select Existing. Select all of the components in the list and click the OK button.
Components and connections will appear on the one line drawing. Rearrange components based on
your requirements.
Figure 1.6: Existing Components
SPEL-SKM Data Exchange Users Guide 1-9
1.4 Exporting SKM Project into SPEL XML
Figure 1.7 shows the Export interface. Select SmartPlant Electrical XML Export Format. By
default, the exported XML file will be stored in the SKM project folder as [Link]. Make
changes as desired.
The Datablock Format section determines what information will be exported and saved with the
XML file. If more or less component information is required, modify the “All Input Data” format or
create your own format.
Click on the Export button. This XML file can now be used to import from within the SPEL
software.
Figure 1.7: SPEL Data Export Interface
1.5 Publishing Equipment from SmartPlant
Electrical (Export XML)
The following section is taken from SmartPlant Electrical User’s Guide Version 2009 SP5 (6.0.5) on
page 445. For additional details and configuration, please refer to SmartPlant’s documentation
and/or Technical Support.
SPEL-SKM Data Exchange Users Guide 1 - 11
1.6 Unsupported Components
The following SKM items are not supported by the SKM-SPEL interface:
• Instrumentation
• DC systems
• Multi-function relays
• Single-phase systems
• Wind turbine generator
• Transmission lines
• MG sets
• SVC
• HVDC
• Double through switches
• Panels
• Potential transformers
• Inverters
The following SmartPlant Electrical items are not supported by SKM-SPEL interface:
• Junction boxes
• When publishing junction boxes from SmartPlant Electrical to SKM, SKM
imports these items as buses. When publishing these bus nodes back to SmartPlant
Electrical, the software identifies them as junction boxes. Note that the software
disregards any existing circuits in the junction boxes and publishes them as black
boxes.
• Local panels
• Metering equipment (except for current transformers)
• DC items
• Single phase items
• Other disconnect equipment
• Potential transformers
• Other converting equipment
• Control stations (not exported at all)
• Circuits (not exported at all)
• Cells (not exported at all)
• Power distribution boards (not exported at all)
SPEL-SKM Data Exchange Users Guide 1 - 13
1.7 Advanced Topics
The files discussed in this section is for advanced users only and will change the behavior of the
Data Exchange functionality. If changes are desired, create backup copies of these files before
modifying them.
[Link] is used to facilitate the equipment data mapping between SPEL and SKM.
Figure 1.8: [Link]
It includes 16 component types. Each component type includes a name and altId attribute along
with data fields. Each data field contains an id and name. The id is currently not used while the
name will appear in the SKM field list in Figure 1.1. By changing the number of the data fields and
the field name, you will modify the SKM data field list.
This xml file is associated with [Link] as described below. If one xml file is changed, the
other xml has to be modified as well.
[Link] contains SKM components shown in Table 1 and all related data fields listed in
Figure 1. This XML file lists one component of each type and shows the available data from SKM
that may be mapped from a SPEL system.
Figure 1.9: [Link]
The above dialog box shows Capacitor under s:Filter. The s:name is for identifying the component
type. Under each data field (s:Field), it shows the id, the name and the value. The value serves as a
default value if the data field is not mapped.
SPEL-SKM Data Exchange Users Guide 1 - 15
[Link] contains all SPEL equipment types and is used to set default values for each
component. ItemTag is the equipment name and cannot be changed. Default values can be entered
for other data fields.
Figure 1.10: [Link]
This is the end of the reference manual for the SPEL SKM Data Exchange module.