XML templates for windPRO projects

Purpose

This paper describes an XML file used to set up initial data for a windPRO project

Disclaimer

This windPRO feature is still in an experimental stage. The XML format relies heavily on the internal structures of windPRO and can be changed from version to version.

Use

The XML template can be created or edited in any tool, either a simple text editor or specialized XML editor. The XML template can be used as argument to a command line launch of windPRO or selected in an open dialog.

Command line launch

windPRO can be launched from a command line (or batch file) as:

wpstart /P=xxxx.xml

Notice that windPRO must be shut down. There is currently no support for creating a new project in a running instance of windPRO.

Open XML template

From a running instance of windPRO, an XML template can be selected in the Open dialog. Note that XML can't be selected as file type, the user must either type the full file name or *.xml and search for the XML template

Format of XML template

The current supported format is described. The format may be enhanced or changed in the future.

Main structure

<?xml version="1.0" ?>
<WindPROProjectInitialize >
  <Filename>c:\Windpro data\projects\newtest.w32p</Filename>
  <Maindata/>
  <Layers/>
  <Objects/>
</WindPROProjectInitialize>

Filename

File name for the new project. <Filename>Full file name (*.w32p)</Filename>

Maindata

The Maindata tag contains the data from WindPRO project properties.

<Name>Project name</Name>
  <Country>2 letter country ID</Country>
  <SitePosEast>Site center longitude WGS 84 datum</SitePosEast>
  <SitePosNorth>Site center latitude WGS 84 datum</SitePosNorth>
  <TimeZone>Time zone in Windows notation (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones)</TimeZone>
  <DefaultSystem1>Coordinate system used in GUI</DefaultSystem1>
  <ViewDatum>Datum, only for geographical coordinate system </ViewDatum>
  <Zone>Zone for coordinate system, if needed</Zone>
  <LatNorth>true for latitude positive north, false for positive south</LatNorth>
  <LongEast> true for longitude positive east, false for positive west</LongEast>
  <SiteDescription >Site description </SiteDescription >
  <MapColl> Collection of background maps, two types are supported
  <Item>
    <MapID>Negative integer, must be unique for each map</MapID>
    <FormatID>For bitmap files with ESRI world file: 10003 </FormatID>
    <Path>Full file name for bitmap file (*.tif, *.jpg etc </Path>
    <ScaleInt>Scale of map as integer, e.g. 25000</ScaleInt>
    <Text>Map name</Text>
    <System>Coordinate system in world file</System>
    <Datum>Datum in world file</Datum>
    <Zone>Zone in world file</Zone>
  </Item>
  <Item>/
    <FormatID>For WindPRO *.bmi files: 10001</FormatID>
    <Path>Full file name for *.bmi file</Path>
    <Text>Map name</Text>
  </Item>
  </MapColl>

Layers

List of layers

<Layers>
  <Name>Layer 1</Name>
  <Name>Layer 2</Name>
  ...
</Layers> 

Objects

List of objects, only general properties are set

<Objects>
<Item>
<ObjTypeID>Object type, see appendix</ObjTypeID>
<UserDescription >Description</UserDescription >
<UserLabel >User label</UserLabel >
<X>Longitude in WGS 84</X>
<Y>Latitude in WGS 84</Y>
<Layer>Layer 1</Layer>
<PosLocked>true</PosLocked><SymbolLabelSetup>slUserLabel</SymbolLabelSetup>
</Item>
</Objects>

Object specific properties

On selected objects it is possible to set specific properties. Here is a few samples: Line object

<Item>
<ObjTypeID>HCData</ObjTypeID>
<UserDescription>Description</UserDescription >
<UserLabel>User label</UserLabel >
<X>Longitude in WGS 84</X>
<Y>Latitude in WGS 84</Y>
<SpecificData>
<Filename>Filename (*.wpo or *.map)</Filename>
<System>Rectangular coordinate system if *.map</System>
<Zone>Zone if needed</Zone>
<UseAsTIN>True</UseAsTIN>
</SpecificData>
</Item>

WTG object

<Item>
<ObjTypeID>NewWTG|ExistWTG</ObjTypeID>
<UserDescription >Description</UserDescription >
<UserLabel >User label</UserLabel >
<X>Longitude in WGS 84</X>
<Y>Latitude in WGS 84</Y>
<SpecificData>
<WTGUID>
<Filename>File name (*.wtg or *.xml Note: special xml WTG format</Filename>
<Hubheight>Hub height</Hubheight>
</WTGUID>
</SpecificData>
</Item>

Site data object (Statgen)

<Item>
<ObjTypeID>SiteData</ObjTypeID>
<UserDescription>SiteData</UserDescription>
<UserLabel>Site data object for Statgen</UserLabel>
<X>9.963361</X>
<Y>57.030325</Y>
<Layer>General data</Layer>
<SpecificData>
<ObjUse>ouStatgen</ObjUse>
<NoSectors>16</NoSectors>
</SpecificData>
</Item>Site data object (WAsP)
<Item>
<ObjTypeID>SiteData</ObjTypeID>
<UserDescription>SiteData</UserDescription>
<UserLabel>Site data object for WAsP</UserLabel>
<X>9.963361</X>
<Y>57.030325</Y>
<Layer>General data</Layer>
<SpecificData>
<ObjUse>ouWasp</ObjUse>
<Windstatistics>
<Item>
<Name>c:\tmp\AutoTest\DK MetStationName2 - 42,00 m.wws</Name>
</Item>
</Windstatistics>
</SpecificData>
</Item>