====== Orbit XML File ======

An Orbit XML File (*.oxf) is Orbit's xml vector file storage format: XML stands for 'Extensible Markup Language' which is a markup language that defines a set of rules for encoding documents in a format that is both human-readable and machine-readable. More information can be found at [[http://en.wikipedia.org/wiki/XML|wikipedia]] or [[http://www.w3.org/XML/|W3]]. \\ An OXF stores both spatial information (geometry) and attribute information. 
\\ \\ 
===== Structure =====

An Orbit XML File is similar to an Orbit Vector File: 
  * one Dataset contains one or more Models
  * each Model has a unique Spatial Component (points, lines, or areas) and unique Attribute Component
  * each Attribute Component contains one or more Attributes grouped by one or more Attribute Sets
  * each Attribute can have one or more values

\\ 

===== Reasons to use =====

  * uses the XML format which is both human and machine readable
  * takes advantage of the extended structure capabilities of the original OVF

===== Create =====

On OXF file can be created by exporting a dataset, see [[112:orbit_desktop:datasetlist:dataset:context_menu|]].


===== Legend and Georeference =====

The OXF can be accompanied by 
  * an [[112:technologies:resources:other:olg|Orbit Legend file]] (*.olg) to define the legend or presentation of the resource in Orbit.
  * an [[112:technologies:resources:other:ord|Orbit Resource Description file]] (*.ord) or a [[112:technologies:resources:other:prj|projection file]] (*.prj) to define the coordinate reference system of the resource in Orbit.
\\ \\ 
===== Example =====

<code bash>
 <?xml version="1.0" encoding="utf-8" standalone="yes"?>
 <root>
  <models>
   <model id="1" name="model1">
    <modeldefinition datatype="Point/Line/Area" dimensions="2D/3D">
     <attributes>
      <attributetable id="1" name="table1">
       <attribute id="1" name="attributename1" datatype="String/Boolean/Integer1/Integer2/Integer4/Integer8/Float4/Float8" />
       <attribute id="2" name="attributename2" datatype="String/Boolean/Integer1/Integer2/Integer4/Integer8/Float4/Float8" />
      </attributetable>
      <attributetable id="2" name="table2">
       <attribute id="1" name="attributename1" datatype="String/Boolean/Integer1/Integer2/Integer4/Integer8/Float4/Float8" />
       <attribute id="2" name="attributename2" datatype="String/Boolean/Integer1/Integer2/Integer4/Integer8/Float4/Float8" />
       <attribute id="3" name="attributename3" datatype="String/Boolean/Integer1/Integer2/Integer4/Integer8/Float4/Float8" />
      </attributetable>
     </attributes>
    </modeldefinition>
   </model>
   <model id="2" name="model2">
    ...
   </model>
   </model>
   <model id="3" name="model3">
    ...
   </model>  
  </models>
  <objects modelid="1">
   <object id="objectid">
     <spatial>
      <part>
       <point x="X" y="Y" / x="X" y="Y" z="Z"/>
       <point x="X" y="Y" / x="X" y="Y" z="Z"/>
        ...
       <point x="X" y="Y" / x="X" y="Y" z="Z"/>            
      </part>
     </spatial>
     <attributerow tableid="1" rowid="0">
      <attribute id="1" value="columnvalue1" />
      <attribute id="2" value="columnvalue2" />
     </attributerow>
     <attributerow tableid="2" rowid="0">
      <attribute id="1" value="columnvalue1" />
      <attribute id="2" value="columnvalue2" />
      <attribute id="3" value="columnvalue3" />     
     </attributerow>
   </object>
  </objects>
  <objects modelid="...">
   ...
  </objects>
  <objects modelid="...">
   ...
  </objects>
  <objects modelid="...">
   ...
  </objects>
 </root>
</code>