<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">


<book lang="en">
<!-- Please remark the "lang" attribute here -->

<bookinfo>
<title>AMATEUR SATELLITE XML Schema</title>
</bookinfo>
<chapter id="Overview">
<title>Overview</title>
 
<para>"AMATEUR SATELLITE XML Schema" project is to define a data structure in order to help Satellite hamradio people to share information about Amateur Satellites. </para>
<para> Amateur Satellites description is embedded in an XML file.  AMATEUR SATELLITE XML Schema defined the way to organise data. It could be used to validate an Amateur Satellites description. The project also maintains a reference Amateur Satellites description (XML format). It also provide some XLT file in order to build HTML file as a sample.</para>
 
</chapter>
<chapter id="Needs">
<title>Needs</title>
<section>
<title>Issue</title>
<para>When you want to exploit amateur satellite, you have a lot of information available on internet, but this information is often partial and spread. It is difficult to answer to some basic question like :  </para>
<itemizedlist>
<listitem><para>What is the current status of the satellite ?</para></listitem>
<listitem><para>What is the frequency, mode ... ?  </para></listitem>
<listitem><para>How to obtain QSL ? </para></listitem>
<listitem><para>What is the telemetry format ?  </para></listitem>
<listitem><para>Where to send report ?  </para></listitem>
</itemizedlist>
<para> Some ham radio people exploit amateur satellite outside. An off-line data referential is needed.  </para>
</section>
<section>
<title>requirements</title>
<para>From issue and main uses cases, the goal of the project is not to provide an application but a way to manage an amateur satellite data referential.
main requirements are :
</para>
<itemizedlist>
<listitem><para>[req-001] Amateur satellite data referential structure shall be defined </para></listitem>
<listitem><para>[req-002] Amateur satellite data referential shall be human readable (eg txt, html, pdf..)</para></listitem>
<listitem><para>[req-003] Amateur satellite data referential shall be extensible</para></listitem>
<listitem><para>[req-004] Amateur satellite data referential shall allows to exchange data with amateur radio application (eg prediction satellite tools) </para></listitem>
<listitem><para>[req-005] Amateur satellite data referential shall be used off-line</para></listitem>
<listitem><para>[req-006] Amateur satellite data referential shall be based on open sources tools and format</para></listitem>
</itemizedlist>
</section>
</chapter>
 
<chapter id="Technicalsolution">
<title>Technical solution</title>
<section>
<title>Technical choice</title>
<para>After different test and POC (proof of Concept), the final choice is a solution based on XML technology. In order to answer to the main requirements [req-001] to [req-006]. In detail, the technical solution is </para>
<itemizedlist>
<listitem><para> XML Schema file in order to define  data referential structure [req-001] [req-003]</para></listitem>
<listitem><para> XSLT in order to manipulate data [req-002] [req-004]</para></listitem>
<listitem><para> XML File for data [req-005]</para></listitem>
</itemizedlist>
<para>All artefact produce for this project are publish on open source licences [TBD] - [req-006] </para>
</section>
</chapter>
 
<chapter id="Deliverable">
<title>Deliverable</title>
<section>
<title>AMSATSaletlliteList XML Schema file </title>
<para> XML Schema file describe the definition of the data structure used for the satellite description. This definition is a guideline for anybody who want to describe a satellite in the XML database.
</para>
</section>
<section>
<title>AMSATSaletlliteList XML File </title>
<para>AMSATSaletlliteList XML File contents the description of the Amateur satellite. The syntax of the file is validated with the AMSATSaletlliteList XML Schema file. The file contents only satellite using frequency allocated to Hamradio.
</para>
</section>
<section>
<title>AMSATSaletlliteList XSD Files </title>
<para> AMSATSaletlliteList XSD Files give example in order to produce human readable output or configuration file for Ham radio tools (eg satellite prediction tools). With the current version, following XSD files is: </para>
<itemizedlist>
<listitem><para>HTML5.XSD :  generate one web page by satellite</para></listitem>
<listitem><para>Gpredict.XSD :  generate one configuration file by satellite for Gpredict</para></listitem>
</itemizedlist>
</section>
</chapter>
<chapter id="Tools">
<title>Tools</title>
<section>
<para> Following tools are used by the project: </para>
<itemizedlist>
<listitem><para><ulink url="http://www.ora.com/catalog/tex/"><citetitle>Notepad++</citetitle></ulink>.</para></listitem>
<listitem><para><ulink url="http://eclipse.org"><citetitle>Eclipse</citetitle></ulink></para></listitem>
<listitem><para><ulink url="http://eclipse.org"><citetitle>Eclipse</citetitle></ulink></para></listitem>
</itemizedlist>
</section>
<section>
<para> Following technology is used by the project:</para>
<itemizedlist>
<listitem><para><ulink url="http://www.w3.org/XML/"><citetitle>XML</citetitle></ulink>.</para></listitem>
<listitem><para><ulink url="http://www.w3.org/TR/xmlschema11-1"><citetitle>XML Schema</citetitle></ulink></para></listitem>
<listitem><para><ulink url="http://www.w3.org/Style/XSL/"><citetitle> Extensible Stylesheet Language Family (XSL)</citetitle></ulink></para></listitem>
 
</itemizedlist>
</section>
</chapter>
 
 
</book>
 