CAMEA

Introduction

With the Characterization Editor tool one can load, visualize, edit, save and even create from scratch some XML Characterization data. It uses the Characterization librarie presented in the next section.

Characterization library

Before developping the tool itself, a "Characterization data takedown" java library has been developped. Its main functionnalities are:

• Defines an object model to represent XML Characterization data in memory
• Implements the methods to convert XML to object model
• Implements the methods to convert object model to XML

User interface

General working

The user can visualize and edit Characterization data thanks to a dynamic form containing one tab per axis. Each axis contains the following sections:

• General axis informations (name, UCD, errors...)
• Coverage
• Resolution
• Sampling Precision

Required fields

According to the Characterization XML schema, some fields are required (otherwise the produced XML document wouldn't be valid). For easier identification they are simply written in bold.

Fields inheritance

The Characterization schema is hierarchically constructed. Indeed, one axis contains three sections: coverage, resolution and sampling precision, and each of them contains 4 levels of measure. The unit and coordinate system information can be added to all these sections and so a hierarchy appears. For example, if the unit is defined on the top level (the axis level) it is supposed that it is inherited for all the underlying levels, unless the unit is redefined.

To represent this concept on the CAMEA's form, an inherited value will be automatically written in grey to show it won't be part of the data but just here to show the inheritance This system is dynamic, so if the user edits a value that can be inherited, all the inherited value that were not redefined by the user will be updated.

Add an axis

The user can add an axis by clicking on the "Add axis" item in the "Axis" menu. Then a window appears:

The user must choose a type for the axis. Five types are possible:

• Spatial
• Time
• Spectral
• Flux
• Misc

A type fixes the value of the UCD and the name of an axis.

The user must also give a name to the axis. If one of the four predefined type (Spatial, Time, Spectral or Flux) has been selected, the name is fixed according to the type. If the Misc type is selected, any name that doesn't already exists in the current characterization will be accepted.

Load Characterization data

The user can load an existing XML Characterization file by clicking on the "Load Characterization file" item in the "File" menu. The form is then updated thanks to the input data and can be edited.

Save Characterization data

The user can save the current Characterization data in the form by clicking on the "Save Characterization data" or "Save as Characterization data" item on the "File" menu.

Download

Current release

The current release of CAMEA is 1.2.1, released on August 6th, 2008.

Package	Release	Date	Release notes	Download
camea	1.2.1	August 6, 2008	release notes	Camea-v1.2.1.tar.gz

Older releases

Package	Release	Date	Release notes	Download
camea	1.2	June 19, 2008	release notes	Camea-v1.2.tar.gz
camea	1.1.2	May 16, 2008	release notes	Camea-v1.1.2.tar.gz
camea	1.1.1	April 30, 2008	release notes	Camea-v1.1.1.tar.gz
camea	1.1	April 30, 2008	release notes	Camea-v1.1.tar.gz
camea	1.0.1	April 9, 2008	release notes	Camea-v1.0.1.tar.gz
camea	1.0	April 3, 2008	release notes	camea-v1.0.tar.gz

Characterisation XML file

You can download a ready to use Characterisation XML file: characterisationSample.xml

Webstart

CAMEA can also be launched with java Webstart: CAMEA Webstart

Release notes and changelog

1.2.1

Changes:

• Enhanced the management of coordinate systems : the text field has been replaced by a selection list to avoid errors from the user and the produced coordsystem XML element has now both an id and a href attribut.

1.2

Changes:

• Add a Webstart version
• Add a "New document" item in the menu
• Better management of the state of CAMEA when no document is loaded: "untitled document" is written, modified state is managed and save button redirects to the save as popup to choose a name for the file
• Boolean radio buttons are set by default to true
• Filter for save as dialog window is now set dynamically according to the selected output format (XML or UType)
• Better handling of the state of the tool when there is no axis (check and save as functionnalities become disabled, ...)
• Last visited directory when saving or loading data is now memorised for next load or save actions
• The creation of an axis with no name is now forbidden
• Modify the introductive text on the main page
• Integration of the release 1.0.4 of the Characterisation library
• Bug correction:
  • Red coloration is now correctly removed after error correction and re-check of the form
  • Now when a new axe is added and no document is loaded, the modified state of the tool is correctly set to true
  • A desactivated part of the form is not checked anymore

1.1.2

Changes:

• A combo box has been added for each axis to show the coordinate order : (lon,lat) or (lat,lon). Indeed, the release 1.0.3 of the Characterisation library can manage the coordinate order using "names" STC elements.
• "modified" state of the tool now also reacts to changement in radio buttons and combo boxes.
• Integration of the release 1.0.3 of the Characterisation library

1.1.1

Changes:

• Bug correction:
  • Now the dialog window closes correctly when loading characterisation data from an URL

1.1

Important release: better ergonomics and robustness of the application.

Changes:

• Include the version 1.0.2 of the Characterisation library
• Implementation of the MVC model
• Add icons and keystroke to the menu items
• Add a toolbar
• New "Help" menu with 3 items: "CAMEA documentation", "IVOA Characterisation document" and "About"
• Enhanced status bar with 4 sections:
  • Status message
  • Loaded data format (XML or UType)
  • Status of the last "Check data" operation (tells if there are errors or not in the form and if yes how many)
  • Plastic icon refleting the state of Plastic (connected or not, applications connected or not, message sending or receiving, ...)
• Data format can now be chosen when loading or saving Characterisation data independently from the file extension
• New centralized interface for loading Characterisation data (by URL or by file)
• JDIC library is used to open a Web browser on the client desktop whatever OS is used
• Bug correction:
  • The fields of the form are now correctly colored after a "check data" operation
  • The dialog window appearing when closing the tool and data state is "modified" now reacts correctly when clicking on the "Cancel" button

1.0.1

Changes:

• Include the version 1.0.1 of the Characterisation library

1.0

First release of CAMEA

Changes:

-- BriceGassmann - 06 Aug 2008