]> Creatis software - gdcm.git/blobdiff - src/gdcmDicomDir.cxx
On the way to gdcm2 ...
[gdcm.git] / src / gdcmDicomDir.cxx
index e920abfe2464db1cd6dba1299aec3e3bfa574962..1226e49598d9b3ca02ef9a6a7d47d7f3d0d8f9ff 100644 (file)
@@ -3,12 +3,12 @@
   Program:   gdcm
   Module:    $RCSfile: gdcmDicomDir.cxx,v $
   Language:  C++
-  Date:      $Date: 2004/09/23 10:47:10 $
-  Version:   $Revision: 1.68 $
+  Date:      $Date: 2005/07/07 16:37:40 $
+  Version:   $Revision: 1.144 $
   
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
-  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.htm for details.
+  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
   
      This software is distributed WITHOUT ANY WARRANTY; without even
      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   
 =========================================================================*/
 
-#include <string>
-#include <algorithm>
-#include <sys/types.h>
-
-#ifdef _MSC_VER 
-   #include <direct.h>
-#else
-   #include <unistd.h>
-#endif
-
+//-----------------------------------------------------------------------------
+//  For full DICOMDIR description, see:
+//  PS 3.3-2003, pages 731-750
+//-----------------------------------------------------------------------------
 #include "gdcmDicomDir.h"
 #include "gdcmDicomDirStudy.h"
 #include "gdcmDicomDirSerie.h"
 #include "gdcmDicomDirImage.h"
+#include "gdcmDicomDirPatient.h"
+#include "gdcmDicomDirMeta.h"
+#include "gdcmDicomDirElement.h"
 #include "gdcmDirList.h"
 #include "gdcmUtil.h"
 #include "gdcmDebug.h"
 #include "gdcmGlobal.h"
-#include "gdcmHeader.h"
+#include "gdcmFile.h"
 #include "gdcmSeqEntry.h"
 #include "gdcmSQItem.h"
 #include "gdcmValEntry.h"
 
-//-----------------------------------------------------------------------------
-//  For full DICOMDIR description, see:
-//  PS 3.3-2003, pages 731-750
+#include <fstream>
+#include <string>
+#include <algorithm>
+#include <sys/types.h>
+
+#ifdef _MSC_VER
+#   define getcwd _getcwd
+#endif
+
+#if defined(_MSC_VER) || defined(__BORLANDC__)
+#   include <direct.h>
+#else
+#   include <unistd.h>
+#endif
+// ----------------------------------------------------------------------------
+//         Note for future developpers
+// ----------------------------------------------------------------------------
+//
+//  Dicom PS 3.3 describes the relationship between Directory Records, as follow
+//    (see also PS 4.3, 2004, page 50 for Entity-Relationship model)
+//
+//  Directory Record Type      Directory Record Types which may be included
+//                                in the next lower-level directory Entity
+//
+// (Root directory Entity)     PATIENT, TOPIC, PRIVATE
+//
+// PATIENT                     STUDY, PRIVATE
+//
+// STUDY                       SERIES, VISIT, RESULTS, STUDY COMPONENT, PRIVATE
+//
+// SERIES                      IMAGE, OVERLAYS, MODALITY LUT, VOI LUT,
+//                             CURVE, STORED PRINT, RT DOSE, RT STRUCTURE SET
+//                             RT PLAN, RT TREAT RECORD, PRESENTATION, WAVEFORM,
+//                             SR DOCUMENT, KEY OBJECT DOC, SPECTROSCOPY,
+//                             RAW DATA, REGISTRATION, FIDUCIAL, PRIVATE,
+//                             ENCAP DOC
+// IMAGE
+// OVERLAY
+// MODALITY LUT
+// VOI LUT
+// CURVE
+// STORED PRINT
+// RT DOSE
+// RT STRUCTURE SET
+// RT PLAN
+// RT TREAT RECORD
+// PRESENTATION
+// WAVEFORM
+// SR DOCUMENT
+// KEY OBJECT DOC
+// SPECTROSCOPY
+// RAW DATA
+// REGISTRATION
+// FIDUCIAL
+// PRIVATE
+// ENCAP DOC
+// 
+// ----------------------
+// The current gdcm version only deals with :
+//
+// (Root directory Entity)     PATIENT
+// PATIENT                     STUDY
+// STUDY                       SERIES 
+// SERIES                      IMAGE
+// IMAGE                       /
+//
+// DicomDir::CreateDicomDir will have to be completed
+// Treelike structure management will have to be upgraded
+// ----------------------------------------------------------------------------
+    
+namespace gdcm 
+{
 //-----------------------------------------------------------------------------
 // Constructor / Destructor
-
 /**
- * \ingroup gdcmDicomDir
- * \brief   Constructor : creates an empty gdcmDicomDir
+ * \brief   Constructor : creates an empty DicomDir
  */
-gdcmDicomDir::gdcmDicomDir()
-   :gdcmDocument( )
-{ 
+DicomDir::DicomDir()
+         :Document( )
+{
    Initialize();  // sets all private fields to NULL
-   std::string pathBidon = "Bidon"; // Sorry, NULL not allowed ...   
-   metaElems = NewMeta();
+   NewMeta();
 }
 
 /**
  * \brief Constructor Parses recursively the directory and creates the DicomDir
  *        or uses an already built DICOMDIR, depending on 'parseDir' value.
- * @param fileName        name 
+ * @param fileName  name 
  *                      - of the root directory (parseDir = true)
  *                      - of the DICOMDIR       (parseDir = false)
  * @param parseDir boolean
@@ -69,123 +132,159 @@ gdcmDicomDir::gdcmDicomDir()
  *                      - false if user passed an already built DICOMDIR file
  *                        and wants to use it 
  */
-gdcmDicomDir::gdcmDicomDir(std::string const & fileName, bool parseDir ):
-   gdcmDocument( fileName )
+DicomDir::DicomDir(std::string const &fileName, bool parseDir ):
+   Document( )
 {
-   // Whatever user passed (a root directory or a DICOMDIR)
-   // and whatever the value of parseDir was,
-   // gdcmDocument is already executed
-   Initialize();  // sets all private fields to NULL
+   // At this step, Document constructor is already executed,
+   // whatever user passed (either a root directory or a DICOMDIR)
+   // and whatever the value of parseDir was.
+   // (nothing is cheked in Document constructor, to avoid overhead)
+
+   ParseDir = parseDir;
+   SetLoadMode (0x00000000); // concerns only dicom files
+   Load( fileName );
+}
 
-   // if user passed a root directory, sure we didn't get anything
+/**
+ * \brief  Canonical destructor 
+ */
+DicomDir::~DicomDir() 
+{
+   SetStartMethod(NULL);
+   SetProgressMethod(NULL);
+   SetEndMethod(NULL);
 
-   if ( TagHT.begin() == TagHT.end() ) // when user passed a Directory to parse
+   ClearPatient();
+   if ( MetaElems )
    {
-      dbg.Verbose(0, "gdcmDicomDir::gdcmDicomDir : entry HT empty");
+      delete MetaElems;
+   }
+}
 
-      if ( fileName.size() == 1 && fileName[0] == '.' )
-      {
-         // user passed '.' as Name
-         // we get current directory name
-         char* dummy = new char[1000];
-         getcwd(dummy, (size_t)1000);
-         SetFileName( dummy ); // will be converted into a string
-         delete[] dummy;       // no longer needed   
-      }
+//-----------------------------------------------------------------------------
+// Public
 
-      if ( parseDir ) // user asked for a recursive parsing of a root directory
-      {
-         metaElems = NewMeta();
+/**
+ * \brief   Loader. use SetLoadMode(), SetFileName() before !  
+ * @return false if file cannot be open or no swap info was found,
+ *         or no tag was found.
+ */
+bool DicomDir::Load( ) 
+{
+   // We should clean out anything that already exists.
+   Initialize();  // sets all private fields to NULL
 
-         dbg.Verbose(0, "gdcmDicomDir::gdcmDicomDir : Parse directory"
-                        " and create the DicomDir");
-         ParseDirectory();
-      }
-      else
-      {
-         /// \todo if parseDir == false, it should be tagged as an error
-         // NON ! il suffit d'appeler ParseDirectory() 
-         // apres le constructeur
-      }
-   }
-   else // Only if user passed a DICOMDIR
+   if (!ParseDir)
    {
-      // Directory record sequence
-      gdcmDocEntry *e = GetDocEntryByNumber(0x0004, 0x1220);
-      if ( !e )
-      {
-         dbg.Verbose(0, "gdcmDicomDir::gdcmDicomDir : NO Directory record"
-                        " sequence (0x0004,0x1220)");
-         /// \todo FIXME : what do we do when the parsed file IS NOT a
-         ///       DICOMDIR file ?         
-      }
-      CreateDicomDir();
+      if ( ! this->Document::Load( ) )
+         return false;
    }
+    return DoTheLoadingJob( );   
 }
 
 /**
- * \brief  Canonical destructor 
+ * \brief   Loader. (DEPRECATED : not to break the API)
+ * @param   fileName file to be open for parsing
+ * @return false if file cannot be open or no swap info was found,
+ *         or no tag was found.
  */
-gdcmDicomDir::~gdcmDicomDir(
+bool DicomDir::Load(std::string const &fileName 
 {
-   SetStartMethod(NULL);
-   SetProgressMethod(NULL);
-   SetEndMethod(NULL);
-   for(ListDicomDirPatient::iterator cc = patients.begin();
-                                     cc!= patients.end();
-                                   ++cc)
-   {
-      delete *cc;
-   }
-   if ( metaElems )
+   // We should clean out anything that already exists.
+   Initialize();  // sets all private fields to NULL
+
+   SetFileName( fileName );
+   if (!ParseDir)
    {
-      delete metaElems;
+      if ( ! this->Document::Load( ) )
+         return false;
    }
+   return DoTheLoadingJob( );
 }
 
-//-----------------------------------------------------------------------------
-// Print
 /**
- * \brief  Canonical Printer 
+ * \brief   Does the Loading Job (internal use only)
+ * @return false if file cannot be open or no swap info was found,
+ *         or no tag was found.
  */
-void gdcmDicomDir::Print(std::ostream &os)
+bool DicomDir::DoTheLoadingJob( ) 
 {
-   if(metaElems)
+   // We should clean out anything that already exists.
+   Initialize();  // sets all private fields to NULL
+
+   if (!ParseDir)
    {
-      metaElems->SetPrintLevel(PrintLevel);
-      metaElems->Print(os);   
-   }   
-   for(ListDicomDirPatient::iterator cc  = patients.begin();
-                                     cc != patients.end();
-                                   ++cc)
+   // Only if user passed a DICOMDIR
+   // ------------------------------
+      Fp = 0;
+      if ( !OpenFile() )
+      {
+         return false;
+      }
+      if (!Document::Load() )
+      {
+         return false;
+      }
+
+      if ( GetFirstEntry() == 0 ) // when user passed a Directory to parse
+      {
+         gdcmWarningMacro( "Entry HT empty for file: "<< GetFileName());
+         return false;
+      }
+      // Directory record sequence
+      DocEntry *e = GetDocEntry(0x0004, 0x1220);
+      if ( !e )
+      {
+         gdcmWarningMacro( "NO 'Directory record sequence' (0x0004,0x1220)"
+                          << " in file " << GetFileName());
+         return false;
+      }
+      else
+         CreateDicomDir();
+   }
+   else
    {
-     (*cc)->SetPrintLevel( PrintLevel );
-     (*cc)->Print( os );
+   // Only if user passed a root directory
+   // ------------------------------------
+      if ( GetFileName() == "." )
+      {
+         // user passed '.' as Name
+         // we get current directory name
+         char dummy[1000];
+         getcwd(dummy, (size_t)1000);
+         SetFileName( dummy ); // will be converted into a string
+      }
+      NewMeta();
+      gdcmWarningMacro( "Parse directory and create the DicomDir : " 
+                         << GetFileName() );
+      ParseDirectory();
    }
+   return true;
 }
 
-//-----------------------------------------------------------------------------
-// Public
 /**
  * \brief  This predicate, based on hopefully reasonable heuristics,
- *         decides whether or not the current header was properly parsed
+ *         decides whether or not the current document was properly parsed
  *         and contains the mandatory information for being considered as
  *         a well formed and usable DicomDir.
- * @return true when gdcmDocument is the one of a reasonable DicomDir,
+ * @return true when Document is the one of a reasonable DicomDir,
  *         false otherwise. 
  */
-bool gdcmDicomDir::IsReadable()
+bool DicomDir::IsReadable()
 {
-   if( !gdcmDocument::IsReadable() )
+   if ( Filetype == Unknown )
    {
+      gdcmWarningMacro( "Wrong filetype");
       return false;
    }
-   if( !metaElems )
+   if ( !MetaElems )
    {
+      gdcmWarningMacro( "Meta Elements missing in DicomDir");
       return false;
    }
-   if( patients.size() <= 0 )
+   if ( Patients.size() <= 0 )
    {
+      gdcmWarningMacro( "NO Patient in DicomDir");
       return false;
    }
 
@@ -193,540 +292,419 @@ bool gdcmDicomDir::IsReadable()
 }
 
 /**
- * \brief Sets all fields to NULL
- */
+ * \brief   adds *the* Meta to a partially created DICOMDIR
+ */  
+DicomDirMeta *DicomDir::NewMeta()
+{
+   if ( MetaElems )
+      delete MetaElems;
+
+   DocEntry *entry = GetFirstEntry();
+   if ( entry )
+   { 
+      MetaElems = new DicomDirMeta(true); // true = empty
 
-void gdcmDicomDir::Initialize()
+      entry = GetFirstEntry();
+      while( entry )
+      {
+         if ( dynamic_cast<SeqEntry *>(entry) )
+            break;
+
+         RemoveEntryNoDestroy(entry);
+         MetaElems->AddEntry(entry);
+
+         entry = GetFirstEntry();
+      }
+   }
+   else  // after root directory parsing
+   {
+      MetaElems = new DicomDirMeta(false); // false = not empty
+   }
+   MetaElems->SetSQItemNumber(0); // To avoid further missprinting
+   return MetaElems;  
+}
+
+/**
+ * \brief   adds a new Patient (with the basic elements) to a partially created
+ *          DICOMDIR
+ */
+DicomDirPatient *DicomDir::NewPatient()
 {
-   startMethod             = NULL;
-   progressMethod          = NULL;
-   endMethod               = NULL;
-   startMethodArgDelete    = NULL;
-   progressMethodArgDelete = NULL;
-   endMethodArgDelete      = NULL;
-   startArg                = NULL;
-   progressArg             = NULL;
-   endArg                  = NULL;
+   DicomDirPatient *p = new DicomDirPatient();
+   AddPatientToEnd( p );
+   return p;
+}
 
-   progress = 0.0;
-   abort = false;
+/**
+ * \brief   Remove all Patients
+ */
+void DicomDir::ClearPatient()
+{
+   for(ListDicomDirPatient::iterator cc = Patients.begin();
+                                     cc!= Patients.end();
+                                   ++cc)
+   {
+      delete *cc;
+   }
+   Patients.clear();
+}
 
-   metaElems = 0;   
+/**
+ * \brief   Get the first entry while visiting the DicomDirPatients
+ * \return  The first DicomDirPatient if found, otherwhise NULL
+ */ 
+DicomDirPatient *DicomDir::GetFirstPatient()
+{
+   ItPatient = Patients.begin();
+   if ( ItPatient != Patients.end() )
+      return *ItPatient;
+   return NULL;
 }
 
+/**
+ * \brief   Get the next entry while visiting the DicomDirPatients
+ * \note : meaningfull only if GetFirstEntry already called
+ * \return  The next DicomDirPatient if found, otherwhise NULL
+ */
+DicomDirPatient *DicomDir::GetNextPatient()
+{
+   gdcmAssertMacro (ItPatient != Patients.end());
+
+   ++ItPatient;
+   if ( ItPatient != Patients.end() )
+      return *ItPatient;
+   return NULL;
+}
 
 /**
- * \ingroup gdcmDicomDir
  * \brief  fills the whole structure, starting from a root Directory
  */
-void gdcmDicomDir::ParseDirectory()
+void DicomDir::ParseDirectory()
 {
    CreateDicomDirChainedList( GetFileName() );
    CreateDicomDir();
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   Set the start method to call when the parsing of the directory starts
+ * \brief   Set the start method to call when the parsing of the
+ *          directory starts.
  * @param   method Method to call
  * @param   arg    Argument to pass to the method
  * @param   argDelete    Argument 
  * \warning In python : the arg parameter isn't considered
  */
-void gdcmDicomDir::SetStartMethod(gdcmMethod *method, void *arg, 
-                                  gdcmMethod *argDelete )
+void DicomDir::SetStartMethod( DicomDir::Method *method, void *arg, 
+                               DicomDir::Method *argDelete )
 {
-   if( startArg && startMethodArgDelete )
+   if ( StartArg && StartMethodArgDelete )
    {
-      startMethodArgDelete( startArg );
+      StartMethodArgDelete( StartArg );
    }
 
-   startMethod          = method;
-   startArg             = arg;
-   startMethodArgDelete = argDelete;
+   StartMethod          = method;
+   StartArg             = arg;
+   StartMethodArgDelete = argDelete;
 }
 
+
 /**
- * \ingroup gdcmDicomDir
- * \brief   Set the method to delete the argument
- *          The argument is destroyed when the method is changed or when the
- *          class is destroyed
- * @param   method Method to call to delete the argument
+ * \brief   Set the progress method to call when the parsing of the
+ *          directory progress
+ * @param   method Method to call
+ * @param   arg    Argument to pass to the method
+ * @param   argDelete    Argument  
+ * \warning In python : the arg parameter isn't considered
  */
-void gdcmDicomDir::SetStartMethodArgDelete(gdcmMethod *method) 
+void DicomDir::SetProgressMethod( DicomDir::Method *method, void *arg, 
+                                  DicomDir::Method *argDelete )
 {
-   startMethodArgDelete = method;
+   if ( ProgressArg && ProgressMethodArgDelete )
+   {
+      ProgressMethodArgDelete( ProgressArg );
+   }
+
+   ProgressMethod          = method;
+   ProgressArg             = arg;
+   ProgressMethodArgDelete = argDelete;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   Set the progress method to call when the parsing of the directory progress
+ * \brief   Set the end method to call when the parsing of the directory ends
  * @param   method Method to call
  * @param   arg    Argument to pass to the method
- * @param   argDelete    Argument  
+ * @param   argDelete    Argument 
  * \warning In python : the arg parameter isn't considered
  */
-void gdcmDicomDir::SetProgressMethod(gdcmMethod *method, void *arg, 
-                                     gdcmMethod *argDelete )
+void DicomDir::SetEndMethod( DicomDir::Method *method, void *arg, 
+                             DicomDir::Method *argDelete )
 {
-   if( progressArg && progressMethodArgDelete )
+   if ( EndArg && EndMethodArgDelete )
    {
-      progressMethodArgDelete( progressArg );
+      EndMethodArgDelete( EndArg );
    }
 
-   progressMethod          = method;
-   progressArg             = arg;
-   progressMethodArgDelete = argDelete;
+   EndMethod          = method;
+   EndArg             = arg;
+   EndMethodArgDelete = argDelete;
 }
 
 /**
- * \ingroup gdcmDicomDir
  * \brief   Set the method to delete the argument
- *          The argument is destroyed when the method is changed or when the 
- *          class is destroyed          
+ *          The argument is destroyed when the method is changed or when the
+ *          class is destroyed
  * @param   method Method to call to delete the argument
  */
-void gdcmDicomDir::SetProgressMethodArgDelete(gdcmMethod *method)
+void DicomDir::SetStartMethodArgDelete( DicomDir::Method *method ) 
 {
-   progressMethodArgDelete = method;
+   StartMethodArgDelete = method;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   Set the end method to call when the parsing of the directory ends
- * @param   method Method to call
- * @param   arg    Argument to pass to the method
- * @param   argDelete    Argument 
- * \warning In python : the arg parameter isn't considered
+ * \brief   Set the method to delete the argument
+ *          The argument is destroyed when the method is changed or when the 
+ *          class is destroyed          
+ * @param   method Method to call to delete the argument
  */
-void gdcmDicomDir::SetEndMethod(gdcmMethod *method, void *arg, 
-                                gdcmMethod *argDelete )
+void DicomDir::SetProgressMethodArgDelete( DicomDir::Method *method )
 {
-   if( endArg && endMethodArgDelete )
-   {
-      endMethodArgDelete( endArg );
-   }
-
-   endMethod          = method;
-   endArg             = arg;
-   endMethodArgDelete = argDelete;
+   ProgressMethodArgDelete = method;
 }
 
 /**
- * \ingroup gdcmDicomDir
  * \brief   Set the method to delete the argument
- *          The argument is destroyed when the method is changed or when the class
- *          is destroyed
+ *          The argument is destroyed when the method is changed or when
+ *          the class is destroyed
  * @param   method Method to call to delete the argument
  */
-void gdcmDicomDir::SetEndMethodArgDelete(gdcmMethod *method)
+void DicomDir::SetEndMethodArgDelete( DicomDir::Method *method )
 {
-   endMethodArgDelete = method;
+   EndMethodArgDelete = method;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   writes on disc a DICOMDIR
+ * \brief    writes on disc a DICOMDIR
  * \ warning does NOT add the missing elements in the header :
  *           it's up to the user doing it !
- * \todo : to be re-written using the DICOMDIR tree-like structure
- *         *not* the chained list
- *         (does NOT exist if the DICOMDIR is user-forged !)
  * @param  fileName file to be written to 
  * @return false only when fail to open
  */
  
-bool gdcmDicomDir::WriteDicomDir(std::string const & fileName) 
+bool DicomDir::WriteDicomDir(std::string const &fileName) 
 {  
+   int i;
    uint16_t sq[4] = { 0x0004, 0x1220, 0xffff, 0xffff };
    uint16_t sqt[4]= { 0xfffe, 0xe0dd, 0xffff, 0xffff };
 
-   FILE * fp = fopen(fileName.c_str(), "wb");
-   if( !fp ) 
+   std::ofstream *fp = new std::ofstream(fileName.c_str(),  
+                                         std::ios::out | std::ios::binary);
+   if ( !fp ) 
    {
-      printf("Failed to open(write) File [%s] \n", fileName.c_str());
+      gdcmWarningMacro("Failed to open(write) File: " << fileName.c_str());
       return false;
    }
 
-   uint8_t* filePreamble = new  uint8_t[128];
+   char filePreamble[128];
    memset(filePreamble, 0, 128);
-   fwrite(filePreamble,128,1,fp);
-   fwrite("DICM",4,1,fp);
-   delete[] filePreamble;
+   fp->write(filePreamble, 128);
+   binary_write( *fp, "DICM");
  
-   gdcmDicomDirMeta *ptrMeta = GetDicomDirMeta();
-   ptrMeta->Write(fp, gdcmExplicitVR);
+   DicomDirMeta *ptrMeta = GetMeta();
+   ptrMeta->WriteContent(fp, ExplicitVR);
    
-   // force writing 0004|1220 [SQ ], that CANNOT exist within gdcmDicomDirMeta
-   fwrite(&sq[0],8,1,fp);  // 0004 1220 ffff ffff
+   // force writing 0004|1220 [SQ ], that CANNOT exist within DicomDirMeta
+   for(i=0;i<4;++i)
+   {
+      binary_write(*fp, sq[i]);
+   }
         
-   for(ListDicomDirPatient::iterator cc = patients.begin();cc!=patients.end();++cc)
+   for(ListDicomDirPatient::iterator cc  = Patients.begin();
+                                     cc != Patients.end();
+                                   ++cc )
    {
-      (*cc)->Write( fp, gdcmExplicitVR );
+      (*cc)->WriteContent( fp, ExplicitVR );
    }
    
    // force writing Sequence Delimitation Item
-   fwrite(&sqt[0],8,1,fp);  // fffe e0dd ffff ffff 
+   for(i=0;i<4;++i)
+   {
+      binary_write(*fp, sqt[i]);  // fffe e0dd ffff ffff 
+   }
+
+   fp->close();
+   delete fp;
 
-   fclose( fp );
+   return true;
+}
+
+/**
+ * \brief    Anonymize a DICOMDIR
+ * @return true 
+ */
+bool DicomDir::AnonymizeDicomDir() 
+{
+   ValEntry *v;
+   // Something clever to be found to forge the Patient names
+   std::ostringstream s;
+   int i = 1;
+   for(ListDicomDirPatient::iterator cc = Patients.begin();
+                                     cc!= Patients.end();
+                                   ++cc)
+   {
+      s << i;
+      v = (*cc)->GetValEntry(0x0010, 0x0010) ; // Patient's Name
+      if (v)
+      {
+         v->SetValue(s.str());
+      }
+
+      v = (*cc)->GetValEntry(0x0010, 0x0020) ; // Patient ID
+      if (v)
+      {
+         v->SetValue(" ");
+      }
+
+      v = (*cc)->GetValEntry(0x0010, 0x0030) ; // Patient's BirthDate
+      if (v)
+      {
+         v->SetValue(" ");
+      }
+      s << "";
+      i++;
+   }
    return true;
 }
 
 //-----------------------------------------------------------------------------
 // Protected
-
 /**
- * \ingroup gdcmDicomDir
- * \brief create a gdcmDocument-like chained list from a root Directory 
+ * \brief create a Document-like chained list from a root Directory 
  * @param path entry point of the tree-like structure
  */
-void gdcmDicomDir::CreateDicomDirChainedList(std::string const & path)
+void DicomDir::CreateDicomDirChainedList(std::string const &path)
 {
    CallStartMethod();
-   gdcmDirList fileList(path,1); // gets recursively the file list
+   DirList dirList(path,1); // gets recursively the file list
    unsigned int count = 0;
    VectDocument list;
-   gdcmHeader *header;
+   File *f;
 
-   TagHT.clear();
-   patients.clear();
+   DirListType fileList = dirList.GetFilenames();
 
-   for( gdcmDirList::iterator it  = fileList.begin();
+   for( DirListType::iterator it  = fileList.begin();
                               it != fileList.end();
                               ++it )
    {
-      progress = (float)(count+1)/(float)fileList.size();
+      Progress = (float)(count+1)/(float)fileList.size();
       CallProgressMethod();
-      if( abort )
+      if ( Abort )
       {
          break;
       }
 
-      header = new gdcmHeader( it->c_str() );
-      if( !header )
-      {
-         dbg.Verbose( 1,
-                      "gdcmDicomDir::CreateDicomDirChainedList: "
-                      "failure in new Header ",
-                      it->c_str() );
-      }
+   f = new File( );
+   f->SetLoadMode(LoadMode); // we allow user not to load Sequences...
+   f->Load( it->c_str() );
+
+//     if ( !f )
+//     {
+//         gdcmWarningMacro( "Failure in new gdcm::File " << it->c_str() );
+//         continue;
+//      }
       
-      if( header->IsReadable() )
+      if ( f->IsReadable() )
       {
-         // Add the file header to the chained list:
-         list.push_back(header);
-         dbg.Verbose( 1,
-                      "gdcmDicomDir::CreateDicomDirChainedList: readable ",
-                      it->c_str() );
-
+         // Add the file to the chained list:
+         list.push_back(f);
+         gdcmWarningMacro( "Readable " << it->c_str() );
        }
        else
        {
-          delete header;
+          delete f;
        }
        count++;
    }
    // sorts Patient/Study/Serie/
-   std::sort(list.begin(), list.end(), gdcmDicomDir::HeaderLessThan );
+   std::sort(list.begin(), list.end(), DicomDir::HeaderLessThan );
    
-   std::string tmp = fileList.GetDirName();      
-   //for each Header of the chained list, add/update the Patient/Study/Serie/Image info
+   std::string tmp = dirList.GetDirName();      
+   //for each File of the chained list, add/update the Patient/Study/Serie/Image info
    SetElements(tmp, list);
    CallEndMethod();
-}
-
-/**
- * \ingroup gdcmDicomDir
- * \brief   adds *the* Meta to a partially created DICOMDIR
- */
-  
-gdcmDicomDirMeta * gdcmDicomDir::NewMeta()
-{
-   gdcmDicomDirMeta *m = new gdcmDicomDirMeta( &TagHT );
-  
-   if ( TagHT.begin() != TagHT.end() ) // after Document Parsing
-   { 
-      TagDocEntryHT::iterator lastOneButSequence = TagHT.end();
-      lastOneButSequence --;
-      // ALL the 'out of Sequence' Tags belong to Meta Elems
-      // (we skip 0004|1220 [Directory record sequence] )
-      for ( TagDocEntryHT::iterator cc  = TagHT.begin(); 
-                                    cc != lastOneButSequence;
-                                   ++cc)
-      {
-         m->AddDocEntry( cc->second );
-      }
-   }
-   else  // after root directory parsing
-   {
-     std::list<gdcmElement> elemList;
-     elemList=gdcmGlobal::GetDicomDirElements()->GetDicomDirMetaElements();
-     m->FillObject(elemList);
-    }
-   m->SetSQItemNumber(0); // To avoid further missprinting
-   return m;  
-}
-
-/**
- * \brief   adds a new Patient (with the basic elements) to a partially created DICOMDIR
- */
-gdcmDicomDirPatient * gdcmDicomDir::NewPatient()
-{
-   std::list<gdcmElement>::iterator it;
-   uint16_t tmpGr,tmpEl;
-   gdcmDictEntry *dictEntry;
-   gdcmValEntry *entry;
-
-   std::list<gdcmElement> elemList;   
-   elemList=gdcmGlobal::GetDicomDirElements()->GetDicomDirPatientElements(); 
-   gdcmSQItem *s = new gdcmSQItem(0);
 
-   // for all the DicomDirPatient Elements      
-   for( it = elemList.begin(); it != elemList.end(); ++it ) 
+   for(VectDocument::iterator itDoc=list.begin();
+       itDoc!=list.end();
+       ++itDoc)
    {
-      tmpGr     = it->group;
-      tmpEl     = it->elem;
-      dictEntry = GetPubDict()->GetDictEntryByNumber(tmpGr, tmpEl);
-      entry     = new gdcmValEntry( dictEntry );
-      entry->SetOffset(0); // just to avoid further missprinting
-      entry->SetValue( it->value );
-
-      // dealing with value length ...
-      
-      if( dictEntry->GetGroup() == 0xfffe)
-      {
-         entry->SetLength(entry->GetValue().length());
-      }
-      else if( dictEntry->GetVR() == "UL" || dictEntry->GetVR() == "SL" )
-      {
-         entry->SetLength( 4 );
-      } 
-      else if( dictEntry->GetVR() == "US" || dictEntry->GetVR() == "SS" )
-      {
-         entry->SetLength(2); 
-      } 
-      else if( dictEntry->GetVR() == "SQ" )
-      {
-         entry->SetLength( 0xffffffff );
-      }
-      else
-      {
-         entry->SetLength( entry->GetValue().length() );
-      }
-      s->AddDocEntry( entry );
+      delete dynamic_cast<File *>(*itDoc);
    }
-
-   gdcmDicomDirPatient *p = new gdcmDicomDirPatient(s, &TagHT);
-   patients.push_front( p );
-
-   return p;   
-}
-
-/**
- * \brief   adds to the HTable 
- *          the gdcmEntries (Dicom Elements) corresponding to the given type
- * @param   path full path file name (only used when type = GDCM_DICOMDIR_IMAGE
- * @param   type gdcmDicomDirObject type to create (GDCM_DICOMDIR_PATIENT,
- *          GDCM_DICOMDIR_STUDY, GDCM_DICOMDIR_SERIE ...)
- * @param   header gdcmHeader of the current file
- */
-void gdcmDicomDir::SetElement(std::string &path,gdcmDicomDirType type,
-                              gdcmDocument *header)
-{
-   std::list<gdcmElement> elemList;
-   std::list<gdcmElement>::iterator it;
-   uint16_t tmpGr, tmpEl;
-   gdcmDictEntry *dictEntry;
-   gdcmValEntry *entry;
-   std::string val;
-   gdcmSQItem *si = new gdcmSQItem(0); // all the items will be at level 1
-   switch( type )
-   {
-      case GDCM_DICOMDIR_IMAGE:
-         elemList = gdcmGlobal::GetDicomDirElements()->GetDicomDirImageElements();
-         break;
-
-      case GDCM_DICOMDIR_SERIE:
-         elemList = gdcmGlobal::GetDicomDirElements()->GetDicomDirSerieElements();
-         break;
-
-      case GDCM_DICOMDIR_STUDY:
-         elemList = gdcmGlobal::GetDicomDirElements()->GetDicomDirStudyElements();
-         break;
-
-      case GDCM_DICOMDIR_PATIENT:
-         elemList = gdcmGlobal::GetDicomDirElements()->GetDicomDirPatientElements();
-         break;
-  
-      case GDCM_DICOMDIR_META:
-         elemList = gdcmGlobal::GetDicomDirElements()->GetDicomDirMetaElements();
-         break;
-
-      default:
-         return;
-   }
-   // removed all the seems-to-be-useless stuff about Referenced Image Sequence
-   // to avoid further troubles
-   // imageElem 0008 1140 "" // Referenced Image Sequence
-   // imageElem fffe e000 "" // 'no length' item : length to be set to 0xffffffff later
-   // imageElem 0008 1150 "" // Referenced SOP Class UID    : to be set/forged later
-   // imageElem 0008 1155 "" // Referenced SOP Instance UID : to be set/forged later
-   // imageElem fffe e00d "" // Item delimitation : length to be set to ZERO later
-   // for all the relevant elements found in their own spot of the DicomDir.dic
-   // FIXME : troubles found when it's a SeqEntry
-
-   for( it = elemList.begin(); it != elemList.end(); ++it)
-   {
-      tmpGr     = it->group;
-      tmpEl     = it->elem;
-      dictEntry = GetPubDict()->GetDictEntryByNumber(tmpGr, tmpEl);
-
-      entry     = new gdcmValEntry( dictEntry ); // Be sure it's never a BinEntry !
-
-      entry->SetOffset(0); // just to avoid further missprinting
-      entry->SetLength(0); // just to avoid further missprinting
-
-      if( header ) // NULL when we Build Up (ex nihilo) a DICOMDIR
-                   //   or when we add the META elems
-         val = header->GetEntryByNumber(tmpGr, tmpEl);
-      else
-         val = GDCM_UNFOUND;
-
-      if( val == GDCM_UNFOUND) 
-      {
-         if( tmpGr == 0x0004 && tmpEl == 0x1130 ) // File-set ID
-         {
-           // force to the *end* File Name
-           val = GetName( path );
-         }
-         else if( tmpGr == 0x0004 && tmpEl == 0x1500 ) // Only used for image
-         {
-            if( header->GetFileName().substr(0, path.length()) != path )
-            {
-               dbg.Verbose(0, "gdcmDicomDir::SetElement : the base path"
-                              " of file name is incorrect");
-               val = header->GetFileName();
-            }
-            else
-               val = &(header->GetFileName().c_str()[path.length()]);
-         }
-         else
-            val = it->value;
-      }
-      else
-      {
-         if ( header->GetEntryLengthByNumber(tmpGr,tmpEl) == 0 )
-            val = it->value;
-      }
-
-     // GDCM_UNFOUND or not !
-
-      entry->SetValue( val ); // troubles expected when vr=SQ ...
-
-      if( dictEntry )
-      {
-         if( dictEntry->GetGroup() == 0xfffe )
-         {
-            entry->SetLength( entry->GetValue().length() ); // FIXME 
-         }
-         else if( dictEntry->GetVR() == "UL" || dictEntry->GetVR() == "SL" )
-         {
-            entry->SetLength(4);
-         }
-         else if( dictEntry->GetVR() == "US" || dictEntry->GetVR() == "SS" )
-         {
-            entry->SetLength(2); 
-         }
-         else if( dictEntry->GetVR() == "SQ" )
-         {
-            entry->SetLength( 0xffffffff );
-         }
-         else
-         {
-            entry->SetLength( entry->GetValue().length() );
-         }
-      }
-
-      if ( type == GDCM_DICOMDIR_META ) // fusible : should never print !
-      {
-         std::cout << "GDCM_DICOMDIR_META ?!? should never print that" 
-                   << std::endl;
-      }
-      si->AddEntry(entry);
-   }
-   switch( type )
-   {
-      case GDCM_DICOMDIR_IMAGE:
-         AddDicomDirImageToEnd(si);
-         break;
-
-      case GDCM_DICOMDIR_SERIE:
-         AddDicomDirSerieToEnd(si);
-         break;
-
-      case GDCM_DICOMDIR_STUDY:
-         AddDicomDirStudyToEnd(si);
-         break;
-
-      case GDCM_DICOMDIR_PATIENT:
-         AddDicomDirPatientToEnd(si);
-         break;
-
-      default:
-         return;
-   }
-   //int count=1;            // find a trick to increment
-   //s->AddEntry(si, count); // Seg Faults 
-
 }
 
 /**
  * \brief   CallStartMethod
  */
-void gdcmDicomDir::CallStartMethod()
+void DicomDir::CallStartMethod()
 {
-   progress = 0.0f;
-   abort    = false;
-   if( startMethod )
+   Progress = 0.0f;
+   Abort    = false;
+   if ( StartMethod )
    {
-      startMethod( startArg );
+      StartMethod( StartArg );
    }
 }
 
 /**
- * \ingroup gdcmDicomDir
  * \brief   CallProgressMethod
  */
-void gdcmDicomDir::CallProgressMethod()
+void DicomDir::CallProgressMethod()
 {
-   if( progressMethod )
+   if ( ProgressMethod )
    {
-      progressMethod( progressArg );
+      ProgressMethod( ProgressArg );
    }
 }
 
 /**
- * \ingroup gdcmDicomDir
  * \brief   CallEndMethod
  */
-void gdcmDicomDir::CallEndMethod()
+void DicomDir::CallEndMethod()
 {
-   progress = 1.0f;
-   if( endMethod )
+   Progress = 1.0f;
+   if ( EndMethod )
    {
-      endMethod( endArg );
+      EndMethod( EndArg );
    }
 }
 
 //-----------------------------------------------------------------------------
 // Private
 /**
- * \ingroup gdcmDicomDir
- * \brief create a 'gdcmDicomDir' from a DICOMDIR gdcmHeader 
+ * \brief Sets all fields to NULL
+ */
+void DicomDir::Initialize()
+{
+   StartMethod             = NULL;
+   ProgressMethod          = NULL;
+   EndMethod               = NULL;
+   StartMethodArgDelete    = NULL;
+   ProgressMethodArgDelete = NULL;
+   EndMethodArgDelete      = NULL;
+   StartArg                = NULL;
+   ProgressArg             = NULL;
+   EndArg                  = NULL;
+
+   Progress = 0.0;
+   Abort = false;
+
+   MetaElems = NULL;   
+}
+
+/**
+ * \brief create a 'gdcm::DicomDir' from a DICOMDIR Header 
  */
-void gdcmDicomDir::CreateDicomDir()
+void DicomDir::CreateDicomDir()
 {
-   // The list is parsed. 
+   // The SeqEntries of "Directory Record Sequence" are parsed. 
    //  When a DicomDir tag ("PATIENT", "STUDY", "SERIE", "IMAGE") is found :
    //  1 - we save the beginning iterator
    //  2 - we continue to parse
@@ -735,167 +713,187 @@ void gdcmDicomDir::CreateDicomDir()
    //       + loop to 1 -
 
    // Directory record sequence
-   gdcmDocEntry *e = GetDocEntryByNumber(0x0004, 0x1220);
+   DocEntry *e = GetDocEntry(0x0004, 0x1220);
    if ( !e )
    {
-      dbg.Verbose(0, "gdcmDicomDir::gdcmDicomDir : NO Directory record"
-                     " sequence (0x0004,0x1220)");
-      /// \todo FIXME: what to do when the parsed file IS NOT a DICOMDIR file ? 
+      gdcmWarningMacro( "No Directory Record Sequence (0004,1220) found");
       return;         
    }
    
-   gdcmSeqEntry* s = dynamic_cast<gdcmSeqEntry*>(e);
+   SeqEntry *s = dynamic_cast<SeqEntry *>(e);
    if ( !s )
    {
-      dbg.Verbose(0, "gdcmDicomDir::CreateDicomDir: no SeqEntry present");
-      // useless : (0x0004,0x1220) IS a Sequence !
+      gdcmWarningMacro( "Element (0004,1220) is not a Sequence ?!?");
       return;
    }
 
-   gdcmDicomDirType type = gdcmDicomDir::GDCM_DICOMDIR_META;
-   metaElems = NewMeta();
-
-   ListSQItem listItems = s->GetSQItems();
+   NewMeta();
    
-   gdcmDocEntry * d;
+   DocEntry *d;
    std::string v;
-   for( ListSQItem::iterator i = listItems.begin(); 
-                             i !=listItems.end(); ++i ) 
+   SQItem *si;
+
+   SQItem *tmpSI=s->GetFirstSQItem();
+   while(tmpSI)
    {
-      d = (*i)->GetDocEntryByNumber(0x0004, 0x1430); // Directory Record Type
-      if ( gdcmValEntry* ValEntry = dynamic_cast< gdcmValEntry* >(d) )
+      d = tmpSI->GetDocEntry(0x0004, 0x1430); // Directory Record Type
+      if ( ValEntry* valEntry = dynamic_cast<ValEntry *>(d) )
       {
-         v = ValEntry->GetValue();
+         v = valEntry->GetValue();
       }
       else
       {
-         dbg.Verbose(0, "gdcmDicomDir::CreateDicomDir: not a ValEntry.");
+         gdcmWarningMacro( "(0004,1430) not a ValEntry ?!?");
          continue;
       }
 
-      if( v == "PATIENT " )
+      // A decent DICOMDIR has much more images than series,
+      // more series than studies, and so on.
+      // This is the right order to preform the tests
+
+      if ( v == "IMAGE " ) 
       {
-         AddDicomDirPatientToEnd( *i );
-         type = gdcmDicomDir::GDCM_DICOMDIR_PATIENT;
+         si = new DicomDirImage(true);
+         if ( !AddImageToEnd( static_cast<DicomDirImage *>(si)) )
+         {
+            delete si;
+            si = NULL;
+            gdcmErrorMacro( "Add AddImageToEnd failed");
+         }
       }
-      else if( v == "STUDY " )
+      else if ( v == "SERIES" )
       {
-         AddDicomDirStudyToEnd( *i );
-         type = gdcmDicomDir::GDCM_DICOMDIR_STUDY;
+         si = new DicomDirSerie(true);
+         if ( !AddSerieToEnd( static_cast<DicomDirSerie *>(si)) )
+         {
+            delete si;
+            si = NULL;
+            gdcmErrorMacro( "Add AddSerieToEnd failed");
+         }
       }
-      else if( v == "SERIES" )
+      else if ( v == "STUDY " )
       {
-         AddDicomDirSerieToEnd( *i );
-         type = gdcmDicomDir::GDCM_DICOMDIR_SERIE;
+         si = new DicomDirStudy(true);
+         if ( !AddStudyToEnd( static_cast<DicomDirStudy *>(si)) )
+         {
+            delete si;
+            si = NULL;
+            gdcmErrorMacro( "Add AddStudyToEnd failed");
+         }
       }
-      else if( v == "IMAGE " ) 
+      else if ( v == "PATIENT " )
       {
-         AddDicomDirImageToEnd( *i );
-         type = gdcmDicomDir::GDCM_DICOMDIR_IMAGE;
+         si = new DicomDirPatient(true);
+         if ( !AddPatientToEnd( static_cast<DicomDirPatient *>(si)) )
+         {
+            delete si;
+            si = NULL;
+            gdcmErrorMacro( "Add PatientToEnd failed");
+         }
       }
       else
       {
-         // It was not a 'PATIENT', nor a 'STUDY', nor a 'SERIE',
-         // neither an 'IMAGE' SQItem. Skip to next item.
-         continue;
+         // It was neither a 'PATIENT', nor a 'STUDY', nor a 'SERIE',
+         // nor an 'IMAGE' SQItem. Skip to next item.
+         gdcmWarningMacro( " -------------------------------------------"
+         << "a non PATIENT/STUDY/SERIE/IMAGE SQItem was found : "
+         << v);
+
+        // FIXME : deal with other item types !
+        tmpSI=s->GetNextSQItem(); // To avoid infinite loop
+        continue;
       }
-   }
-}
+      if ( si )
+         MoveSQItem(si,tmpSI);
 
-/**
- * \ingroup gdcmDicomDir
- * \brief Well ... there is only one occurence  
- */
-void gdcmDicomDir::AddDicomDirMeta()
-{
-   if( metaElems )
-   {
-      delete metaElems;
+      tmpSI=s->GetNextSQItem();
    }
-   metaElems = new gdcmDicomDirMeta( &TagHT );
+   ClearEntry();
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief  AddDicomDirPatientToEnd 
- * @param   s SQ Item to enqueue to the DicomPatient chained List
+ * \brief  AddPatientToEnd 
+ * @param   dd SQ Item to enqueue to the DicomPatient chained List
  */
-void gdcmDicomDir::AddDicomDirPatientToEnd(gdcmSQItem *s)
+bool DicomDir::AddPatientToEnd(DicomDirPatient *dd)
 {
-   patients.push_back(new gdcmDicomDirPatient(s, &TagHT));
+   Patients.push_back(dd);
+   return true;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief  AddDicomDirStudyToEnd 
- * @param   s SQ Item to enqueue to the DicomDirStudy chained List
+ * \brief  AddStudyToEnd 
+ * @param   dd SQ Item to enqueue to the DicomDirStudy chained List
  */
- void gdcmDicomDir::AddDicomDirStudyToEnd(gdcmSQItem *s)
+bool DicomDir::AddStudyToEnd(DicomDirStudy *dd)
 {
-   if( patients.size() > 0 )
+   if ( Patients.size() > 0 )
    {
-      ListDicomDirPatient::iterator itp = patients.end();
+      ListDicomDirPatient::iterator itp = Patients.end();
       itp--;
-      (*itp)->AddDicomDirStudy(new gdcmDicomDirStudy(s, &TagHT));
+      (*itp)->AddStudy(dd);
+      return true;
    }
+   return false;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief  AddDicomDirSerieToEnd 
- * @param   s SQ Item to enqueue to the DicomDirSerie chained List
+ * \brief  AddSerieToEnd 
+ * @param   dd SQ Item to enqueue to the DicomDirSerie chained List
  */
-void gdcmDicomDir::AddDicomDirSerieToEnd(gdcmSQItem *s)
+bool DicomDir::AddSerieToEnd(DicomDirSerie *dd)
 {
-   if( patients.size() > 0 )
+   if ( Patients.size() > 0 )
    {
-      ListDicomDirPatient::iterator itp = patients.end();
+      ListDicomDirPatient::iterator itp = Patients.end();
       itp--;
 
-      if( (*itp)->GetDicomDirStudies().size() > 0 )
+      DicomDirStudy *study = (*itp)->GetLastStudy();
+      if ( study )
       {
-         ListDicomDirStudy::iterator itst=(*itp)->GetDicomDirStudies().end();
-         itst--;
-         (*itst)->AddDicomDirSerie(new gdcmDicomDirSerie(s, &TagHT));
+         study->AddSerie(dd);
+         return true;
       }
    }
+   return false;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   AddDicomDirImageToEnd
- * @param   s SQ Item to enqueue to the DicomDirImage chained List
+ * \brief   AddImageToEnd
+ * @param   dd SQ Item to enqueue to the DicomDirImage chained List
  */
- void gdcmDicomDir::AddDicomDirImageToEnd(gdcmSQItem *s)
+bool DicomDir::AddImageToEnd(DicomDirImage *dd)
 {
-   if( patients.size() > 0 )
+   if ( Patients.size() > 0 )
    {
-      ListDicomDirPatient::iterator itp = patients.end();
+      ListDicomDirPatient::iterator itp = Patients.end();
       itp--;
 
-      if( (*itp)->GetDicomDirStudies().size() > 0 )
+      DicomDirStudy *study = (*itp)->GetLastStudy();
+      if ( study )
       {
-         ListDicomDirStudy::iterator itst = (*itp)->GetDicomDirStudies().end();
-         itst--;
-
-         if( (*itst)->GetDicomDirSeries().size() > 0 )
+         DicomDirSerie *serie = study->GetLastSerie();
+         if ( serie )
          {
-            ListDicomDirSerie::iterator its = (*itst)->GetDicomDirSeries().end();
-            its--;
-            (*its)->AddDicomDirImage(new gdcmDicomDirImage(s, &TagHT));
+            serie->AddImage(dd);
+            return true;
          }
       }
    }
+   return false;
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief  for each Header of the chained list, add/update the Patient/Study/Serie/Image info 
+ * \brief  for each Header of the chained list, 
+ *         add/update the Patient/Study/Serie/Image info 
  * @param   path path of the root directory
  * @param   list chained list of Headers
  */
-void gdcmDicomDir::SetElements(std::string &path, VectDocument &list)
+void DicomDir::SetElements(std::string const &path, VectDocument const &list)
 {
+   ClearEntry();
+   ClearPatient();
+
    std::string patPrevName         = "", patPrevID  = "";
    std::string studPrevInstanceUID = "", studPrevID = "";
    std::string serPrevInstanceUID  = "", serPrevID  = "";
@@ -904,30 +902,36 @@ void gdcmDicomDir::SetElements(std::string &path, VectDocument &list)
    std::string studCurInstanceUID, studCurID;
    std::string serCurInstanceUID,  serCurID;
 
-   for( VectDocument::iterator it = list.begin();
-                              it != list.end(); ++it )
+   bool first = true;
+   for( VectDocument::const_iterator it = list.begin();
+                                     it != list.end(); 
+                                   ++it )
    {
       // get the current file characteristics
-      patCurName         = (*it)->GetEntryByNumber(0x0010,0x0010); 
-      patCurID           = (*it)->GetEntryByNumber(0x0010,0x0011); 
-      studCurInstanceUID = (*it)->GetEntryByNumber(0x0020,0x000d);            
-      studCurID          = (*it)->GetEntryByNumber(0x0020,0x0010);            
-      serCurInstanceUID  = (*it)->GetEntryByNumber(0x0020,0x000e);            
-      serCurID           = (*it)->GetEntryByNumber(0x0020,0x0011);
-
-      if( patCurName != patPrevName || patCurID != patPrevID)
+      patCurName         = (*it)->GetEntryValue(0x0010,0x0010);
+      patCurID           = (*it)->GetEntryValue(0x0010,0x0011);
+      studCurInstanceUID = (*it)->GetEntryValue(0x0020,0x000d);
+      studCurID          = (*it)->GetEntryValue(0x0020,0x0010);
+      serCurInstanceUID  = (*it)->GetEntryValue(0x0020,0x000e);
+      serCurID           = (*it)->GetEntryValue(0x0020,0x0011);
+
+      if ( patCurName != patPrevName || patCurID != patPrevID || first )
       {
          SetElement(path, GDCM_DICOMDIR_PATIENT, *it);
+         first = true;
       }
 
-      // if new Study Deal with 'STUDY' Elements   
-      if( studCurInstanceUID != studPrevInstanceUID || studCurID != studPrevID )
+      // if new Study, deal with 'STUDY' Elements   
+      if ( studCurInstanceUID != studPrevInstanceUID || studCurID != studPrevID 
+         || first )
       {
          SetElement(path, GDCM_DICOMDIR_STUDY, *it);
+         first = true;
       }
 
-      // if new Serie Deal with 'SERIE' Elements   
-      if( serCurInstanceUID != serPrevInstanceUID || serCurID != serPrevID )
+      // if new Serie, deal with 'SERIE' Elements   
+      if ( serCurInstanceUID != serPrevInstanceUID || serCurID != serPrevID
+         || first )
       {
          SetElement(path, GDCM_DICOMDIR_SERIE, *it);
       }
@@ -941,16 +945,202 @@ void gdcmDicomDir::SetElements(std::string &path, VectDocument &list)
       studPrevID          = studCurID;
       serPrevInstanceUID  = serCurInstanceUID;
       serPrevID           = serCurID;
+      first = false;
+   }
+}
+
+/**
+ * \brief   adds to the HTable 
+ *          the Entries (Dicom Elements) corresponding to the given type
+ * @param   path full path file name (only used when type = GDCM_DICOMDIR_IMAGE
+ * @param   type DicomDirObject type to create (GDCM_DICOMDIR_PATIENT,
+ *          GDCM_DICOMDIR_STUDY, GDCM_DICOMDIR_SERIE ...)
+ * @param   header Header of the current file
+ */
+void DicomDir::SetElement(std::string const &path, DicomDirType type,
+                          Document *header)
+{
+   ListDicomDirElem elemList;
+   ListDicomDirElem::const_iterator it;
+   uint16_t tmpGr, tmpEl;
+   DictEntry *dictEntry;
+   ValEntry *entry;
+   std::string val;
+   SQItem *si;
+
+   switch( type )
+   {
+      case GDCM_DICOMDIR_IMAGE:
+         elemList = Global::GetDicomDirElements()->GetDicomDirImageElements();
+         si = new DicomDirImage(true);
+         if ( !AddImageToEnd(static_cast<DicomDirImage *>(si)) )
+         {
+            delete si;
+            gdcmErrorMacro( "Add ImageToEnd failed");
+         }
+         break;
+      case GDCM_DICOMDIR_SERIE:
+         elemList = Global::GetDicomDirElements()->GetDicomDirSerieElements();
+         si = new DicomDirSerie(true);
+         if ( !AddSerieToEnd(static_cast<DicomDirSerie *>(si)) )
+         {
+            delete si;
+            gdcmErrorMacro( "Add SerieToEnd failed");
+         }
+         break;
+      case GDCM_DICOMDIR_STUDY:
+         elemList = Global::GetDicomDirElements()->GetDicomDirStudyElements();
+         si = new DicomDirStudy(true);
+         if ( !AddStudyToEnd(static_cast<DicomDirStudy *>(si)) )
+         {
+            delete si;
+            gdcmErrorMacro( "Add StudyToEnd failed");
+         }
+         break;
+      case GDCM_DICOMDIR_PATIENT:
+         elemList = Global::GetDicomDirElements()->GetDicomDirPatientElements();
+         si = new DicomDirPatient(true);
+         if ( !AddPatientToEnd(static_cast<DicomDirPatient *>(si)) )
+         {
+            delete si;
+            gdcmErrorMacro( "Add PatientToEnd failed");
+         }
+         break;
+      case GDCM_DICOMDIR_META:
+         elemList = Global::GetDicomDirElements()->GetDicomDirMetaElements();
+         si = new DicomDirMeta(true);
+         if ( MetaElems )
+         {
+            delete MetaElems;
+            gdcmErrorMacro( "MetaElements already exist, they will be destroyed");
+         }
+         MetaElems = static_cast<DicomDirMeta *>(si);
+         break;
+      default:
+         return;
+   }
+   // removed all the seems-to-be-useless stuff about Referenced Image Sequence
+   // to avoid further troubles
+   // imageElem 0008 1140 "" // Referenced Image Sequence
+   // imageElem fffe e000 "" // 'no length' item : length to be set to 0xffffffff later
+   // imageElem 0008 1150 "" // Referenced SOP Class UID    : to be set/forged later
+   // imageElem 0008 1155 "" // Referenced SOP Instance UID : to be set/forged later
+   // imageElem fffe e00d "" // Item delimitation : length to be set to ZERO later
+   // FIXME : troubles found when it's a SeqEntry
+
+   // for all the relevant elements found in their own spot of the DicomDir.dic
+   for( it = elemList.begin(); it != elemList.end(); ++it)
+   {
+      tmpGr     = it->Group;
+      tmpEl     = it->Elem;
+      dictEntry = GetPubDict()->GetEntry(tmpGr, tmpEl);
+
+      entry     = new ValEntry( dictEntry ); // Be sure it's never a BinEntry !
+
+      entry->SetOffset(0); // just to avoid further missprinting
+
+      if ( header )
+      {
+         // NULL when we Build Up (ex nihilo) a DICOMDIR
+         //   or when we add the META elems
+         val = header->GetEntryValue(tmpGr, tmpEl);
+      }
+      else
+      {
+         val = GDCM_UNFOUND;
+      }
+
+      if ( val == GDCM_UNFOUND) 
+      {
+         if ( tmpGr == 0x0004 && tmpEl == 0x1130 ) // File-set ID
+         {
+           // force to the *end* File Name
+           val = Util::GetName( path );
+         }
+         else if ( tmpGr == 0x0004 && tmpEl == 0x1500 ) // Only used for image
+         {
+            if ( header->GetFileName().substr(0, path.length()) != path )
+            {
+               gdcmWarningMacro( "The base path of file name is incorrect");
+               val = header->GetFileName();
+            }
+            else
+            {
+               val = &(header->GetFileName().c_str()[path.length()]);
+            }
+         }
+         else
+         {
+            val = it->Value;
+         }
+      }
+      else
+      {
+         if ( header->GetEntryLength(tmpGr,tmpEl) == 0 )
+            val = it->Value;
+      }
+
+      entry->SetValue( val ); // troubles expected when vr=SQ ...
+
+      if ( type == GDCM_DICOMDIR_META ) // fusible : should never print !
+      {
+         gdcmWarningMacro("GDCM_DICOMDIR_META ?!? should never print that");
+      }
+      si->AddEntry(entry);
    }
 }
 
 /**
- * \ingroup gdcmDicomDir
- * \brief   compares two dgcmHeaders
+ * \brief   Move the content of the source SQItem to the destination SQItem
+ *          Only DocEntry's are moved
+ * @param dst destination SQItem
+ * @param src source SQItem
  */
-bool gdcmDicomDir::HeaderLessThan(gdcmDocument *header1, gdcmDocument *header2)
+void DicomDir::MoveSQItem(DocEntrySet *dst,DocEntrySet *src)
+{
+   DocEntry *entry;
+
+   entry = src->GetFirstEntry();
+   while(entry)
+   {
+      src->RemoveEntryNoDestroy(entry);
+      dst->AddEntry(entry);
+      // we destroyed -> the current iterator is not longer valid
+      entry = src->GetFirstEntry();
+   }
+}
+
+/**
+ * \brief   compares two files
+ */
+bool DicomDir::HeaderLessThan(Document *header1, Document *header2)
 {
    return *header1 < *header2;
 }
 
 //-----------------------------------------------------------------------------
+// Print
+/**
+ * \brief  Canonical Printer 
+ * @param   os ostream we want to print in
+ * @param indent Indentation string to be prepended during printing
+ */
+void DicomDir::Print(std::ostream &os, std::string const & )
+{
+   if ( MetaElems )
+   {
+      MetaElems->SetPrintLevel(PrintLevel);
+      MetaElems->Print(os);   
+   }   
+   for(ListDicomDirPatient::iterator cc  = Patients.begin();
+                                     cc != Patients.end();
+                                   ++cc)
+   {
+     (*cc)->SetPrintLevel(PrintLevel);
+     (*cc)->Print(os);
+   }
+}
+
+//-----------------------------------------------------------------------------
+} // end namespace gdcm