The XML structure format was designed to remediate some of the shortcomings of the flat-file format. By use of XML, issues related to extra fields in the file or columns merging together can easily be remedied. Additionally, APBS will only parse the necessary information from the XML file and will ignore all other information, so users wishing to store extra data related to a residue or atom can do so inline without affecting APBS.

This data format has the following form:

   # Comments	
   <roottag>
       <residue>
           <atom>
               <x>x</x>
               <y>y</y>
               <z>z</z>
               <charge>charge</charge>
               <radius>radius</radius>
           </atom>
           ...
       </residue>
       ...
   </roottag>

The variables in this example are:

Comments

Any number of comment lines, each line starting with the "#" symbol. Yes, we know this isn't valid XML syntax... this will be fixed in future versions...'

roottag

This is the root element of the XML file. The value is not important to APBS - APBS simply checks that it is closed at the end of the file.

x

A float giving the x-coordinate of the atom in Å.

y

A float giving the y-coordinate of the atom in Å.

z

A float giving the z-coordinate of the atom in Å.

charge

A float giving the atomic charge (in electrons).

atomradius

A float giving the atomic Radius (in Å).