Architecture

Generalities

• cvs : creatis/creaImageIO

  • cvs co -D :PROTOCOL:USERNAME@cvs.creatis.insa-lyon.fr:/cvs/creatis creaImageIO

• 09/02/09 :
  • new sources in src : create a lib called creaImageIO
  • command line app : appli/gimmick
  • cmake option : BUILD_V2 to build the new version
• All C++ files begin with creaImageIO
• All creaImageIO classes are in a namespace creaImageIO

General stucture

• The main data structure : attributed tree
  • all related files are of the form : creaImageIOTree
  • all related classes are in a namespace : creaImageIO::tree

• The abstract 'Model' : TreeHandler = manages a data source (read-only; read/write)

  • Concrete models : now SQLiteTreeHandler; future IRodsTreeHandler, FavoritesTreeHandler?

• The controller 'Gimmick' : controls different TreeHandlers:

  • Local database handler
  • Favorites handler
  • Other which are open on user demand
• The Views:

  • Abstract GimmickView : Dialog

  • Concrete GimmickView : now WxGimmickView; future QGimmickView ?

  • Do we need to have abstract classes for GimmickView components ?

    • TreeView : is associated with a TreeHandler to visualize its Tree

    • AttributeView : visualizes a set of attributes (only one for a GimmickView)

    • ImageView : preview of images

Classes

Data structure: Attributed tree

in namespace creaImageIO::tree

• Tree
  • Attributed tree structure
  • inherits Node

  • holds a vector of root TreeNode

• TreeData

  • Abstract class to store user data on a tree
• Node
  • belong to a Tree,
  • holds a pointer on parent Node,
  • holds a vector of children Node

• NodeData

  • Abstract class to store user data on a tree node
• Descriptor
  • Descriptor of the structure a tree (number of levels, descriptors of each level, ...)

  • holds a vector of LevelDescriptor

• LevelDescriptor

  • holds a vector of TreeAttributeDescriptor

• AttributeDescriptor

  • stores name, dicom group/elem, flags
• Comparator
  • Abstract definition of a comparator of Node

  • Comparison is done by operator()(Node* const &, Node* const &)

• ComparatorWithOrder

  • Abstract Comparator whose order can be reversed

  • Concrete comparison is done by method compare(Node* const &, Node* const &)

• LexicographicalComparator

  • A Comparator which stores a vector of Comparators and which performs lexicographical comparison

• IntComparator : Compares the values of a given Attribute of the Nodes which is decoded as an int value

• FloatComparator : Compares the values of a given Attribute of the Nodes which is decoded as a float value

• StringComparator : Compares the values of a given Attribute of the Nodes which is decoded as a string value

Models : TreeHandler and descendants

• TreeHandler : Abstract class which 'handles' a Tree structure.

  • Can: Load the children of a given Node

• SQLiteTreeHandler : Concrete TreeHandler which manages a tree stored in a sqlite database

• CppSQLite3.h / CppSQLite3.cpp : C++ interface to sqlite db

...

• ImageFinder : Parses (recursively) a part of a filesystem to look for known images and load their attributes in order to add the images to a Tree (submission via a TreeHandler::AddBranch)

Image handling

• creaImageIOImageReader.h/cpp :

  • SpecificImageReader

  • ImageReader

• creaImageIOMultiThreadImageReader.h/cpp
• creaImageIOIndexedHeap.h/txx

Controller

• Gimmick

Views

• GimmickView : Abstract

• WxGimmickView

  • WxTreeView

  • WxAttributeView

  • WxImageView

• QGimmickView
  • ...