Universal Dive Data Format
UDDF

Version 2.2.0

Raimundo Fernandez Diez (rai at virtual-sub.org)

Steffen Reith (streit at streit.cc)

Kai Schröder (kai at streit.cc) (please, send suggestions, critics etc. to this address)

Stephan Veigl (stephan.veigl at aquadivelog.org)

   

Boris Boesler (borisboesler at users.sourceforge.net) (UDDF schema documentation, general XML suggestions)

Pierre Mareschal (pmareschal at yahoo.com) (general XML suggestions)

Sandra Sterner (sandra.sterner at gmx.net) (ecology section)

   

September 20th, 2007

Table of Contents

1. Introduction
2. Motivation — data exchange between programs (of different manufacturers)
3. UDDF — standardized, open, free to use
General
Possibilities of use of UDDF
Example scenario 1 (dive buddy, equipment, dive spot, logbook)
Example scenario 2 (dive profile)
Example scenario 3 (dive planning)
Example scenario 4 (dive trip)
Example scenario 5 (documentation of an expedition)
4. Units used
5. General structure of an UDDF file
Comments
6. Cross-referencing
7. The different sections, and their elements
<generator>
<diver>
<divesite>
<gasdefinitions>
<profiledata>
<tablegeneration>
<divetrip>
<divecomputercontrol>
8. Example UDDF files
A Database — Diver's data, descriptions of dive spots etc.
Diver's data
Descriptions of dive spots
Biological population inventories
Breathing gases used
Dive profiles
Generation of ascent profiles, dive tables, and "maximum bottom time tables"
Calculation of ascent profiles
Calculation of dive tables
Computation of a "maximum bottom time table"
Configuration of, and reading data from dive computers
Configuration of a dive computer
Reading recorded data from a dive computer
9. Elements of UDDF (in alphabetical order)
abundance
accommodation
acknowledge/
address
age
airtemperature
alarm
alarmtype
altitude
amphibia
aperture
applicationdata
ar
arealength
areawidth
ascent
ascidiacea
audio
audioref/
averagevisibility
beam
birthdate
boattrip/
body
bodyref/
boots
bootsref/
bottom
bottomtimemaximum
bottomtimeminimum
bottomtimestepbegin
bottomtimestepend
bottomtimetable
bottomtimetablescope
breathingconsumptionvolume
breathingconsumptionvolumebegin
breathingconsumptionvolumeend
breathingconsumptionvolumestep
bryozoa
buddy
buddyref/
built
buoyancycontroldevice
buoyancycontroldeviceref/
calculatebottomtimetable
calculateprofile
calculatetable
camera
cameraref/
category
cave
certification
chlorophyceae
chondrichthyes
city
cnidaria
cns
coelenterata
compass
compassref/
compressor
compressorref/
contact
country
crustacea
ctenophora
date
day
dayofweek
dcalarm
dcalarmdepth
decomodel
deepstoptime
density
depth
descent
difficulty
displacement
dive
divebase
divecomputer
divecomputercontrol
divecomputerref/
divedepthbegin
divedepthend
divedepthstep
diveduration
diveinsurances
divenumber
divepermissions
diver
diveref/
divesite
divetime
divetrip
doctor
doctorref/
dominance
draught
echinodermata
ecology
education
email
enddate
equipment
equipmentused
equivalentairdepth
examination
examinationresult
exposurecompensation
fauna
fax
fileformat
filename
filmspeed
fins
finsref/
firstname
flash
flashref/
flora
floravarious
focallength
focusingdistance
gasdefinitions
generator
geography
getdcalldata/
getdcbuddydata/
getdcdata
getdcdivesitedata/
getdcdivetripdata/
getdcgasdefinitionsdata/
getdcgeneratordata/
getdcownerdata/
getdcprofiledata/
globallightintensity
gloves
glovesref/
greatestdepth
guide
h2
he
headline
homepage
hoteltrip/
hour
housing
housingref/
image
imagedata
imageref/
individualtrip/
indoor
infinity/
inputprofile
instructor
insurance
invertebrata
invertebratavarious
issuedate
knife
kniferef/
lake
language
lastname
latitude
launchingdate
lead
leadref/
length
lens
lensref/
level
lifestage
light
lightref/
lightintensity
lingo
location
longitude
lowesttemperature
mammalia
manufacturer
manufacturerref/
marina
mask
maskref/
maximumascendingrate
maximumdepth
maximumoperationdepth
maximumpo2
maximumvisibility
medical
meteringmethod
middlename
minimumdepth
minimumvisibility
minute
mix
mixchange
mixref/
mobilephone
model
mollusca
month
n2
name
nationality
nextservicedate
notes
o2
objectname
observations
operator
organization
organizedtrip/
osteichthyes
otu
output
owner
para
passedtime
passport
period
permit
personal
phaeophyceae
phone
phoronidea
plathelminthes
porifera
postcode
price
pricedivepackage
priceperdive
priceperlitre
profile
profiledata
program
province
purchase
rating
rebreather
rebreatherref/
region
regulator
regulatorref/
relateddives
remark
repetitiongroup
repetitiongroupref/
reptilia
rhodophyceae
river
samples
scientificname
scooter
scooterref/
serialnumber
serviceinterval
setdcalarmtime
setdcaltitude
setdcbuddydata/
setdcdata
setdcdate
setdcdecomodel
setdcdivedepthalarm
setdcdivepo2alarm
setdcdivesitedata/
setdcdivetimealarm
setdcendndtalarm
setdcgasdefinitionsdata/
setdcownerdata/
setdcpassword
setdcgeneratordata/
setdctime
setpo2
sex
shipdimension
shiptype
shipyard
shop
shopref/
shore
shutterspeed
site
sitedata
size
specialty
species
spermatophyta
startdate
street
student/
suit
suitref/
sunk
surfaceinterval
switchmix/
table
tableref/
tablegeneration
tablescope
tank
tankdata
tankdataref/
tankmaterial
tankpressurebegin
tankpressureend
tankpressurereserve
tankref/
tankvolume
tankvolumebegin
tankvolumeend
tankvolumestep
tausim
temperature
terrain
text
time
timezone
title
tonnage
trip
tripmembership
trivialname
uddf
validdate
variouspieces
variouspiecesref/
version
vertebrata
vertebratavarious
vessel
videocamera
videocameraref/
video
videoref/
visibility
watch
watchref/
wayaltitude
waypoint
wreck
year
10. Changes
Version 2.2.0
Altered functionality
Renamed elements
Removed elements
New elements
Version 2.1.0
Renamed elements
Removed elements
New elements
11. UDDF XML Schema, and Document type definition (DTD)
12. GNU Free Documentation License
0. Preamble
1. APPLICABILITY AND DEFINITIONS
2. VERBATIM COPYING
3. COPYING IN QUANTITY
4. MODIFICATIONS
5. COMBINING DOCUMENTS
6. COLLECTIONS OF DOCUMENTS
7. AGGREGATION WITH INDEPENDENT WORKS
8. TRANSLATION
9. TERMINATION
10. FUTURE REVISIONS OF THIS LICENSE
ADDENDUM: How to use this License for your documents

List of Figures

3.1. UDDF's role as an agent