X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmSerieHelper.h;h=6921df6ad927e781ee40116d06ceda4ffc56a826;hb=a08cf53dc69fa5e4b9e2dd4fbbfc3d476b963aa0;hp=45fcd4f42b2eff14e116ec89a68d639cdab8b046;hpb=262bd420b44791777972b1d574fe94827da54e03;p=gdcm.git diff --git a/src/gdcmSerieHelper.h b/src/gdcmSerieHelper.h index 45fcd4f4..6921df6a 100644 --- a/src/gdcmSerieHelper.h +++ b/src/gdcmSerieHelper.h @@ -3,8 +3,8 @@ Program: gdcm Module: $RCSfile: gdcmSerieHelper.h,v $ Language: C++ - Date: $Date: 2005/02/02 15:12:09 $ - Version: $Revision: 1.1 $ + Date: $Date: 2005/07/30 18:13:24 $ + Version: $Revision: 1.16 $ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or @@ -20,11 +20,16 @@ #define GDCMSERIEHELPER_H #include "gdcmCommon.h" -#include +#include "gdcmDebug.h" // for LEGACY + +#include +#include #include + namespace gdcm { class File; +typedef std::vector FileList; //----------------------------------------------------------------------------- /** @@ -32,41 +37,96 @@ class File; * - This class should be used for a stack of 2D dicom images. * It allows to explore (recursively or not) a directory and * makes a set of 'Coherent Files' list (coherent : same Serie UID) - * It allows to sort any of the Coherent File list on the image postion + * It allows to sort any of the Coherent File list on the image position */ class GDCM_EXPORT SerieHelper { public: - typedef std::list GdcmFileList; - typedef std::map CoherentFileListmap; + typedef std::map CoherentFileListmap; + typedef std::vector FileVector; - SerieHelper(); - ~SerieHelper(); - void Print(); + SerieHelper(); + ~SerieHelper(); + void Print(std::ostream &os = std::cout, std::string const &indent = "" ); /// \todo should return bool or throw error ? void AddFileName(std::string const &filename); + void AddGdcmFile(File *header); + void SetDirectory(std::string const &dir, bool recursive=false); - void OrderGdcmFileList(GdcmFileList *CoherentGdcmFileList); + bool IsCoherent(FileList *coherentFileList); + void OrderFileList(FileList *coherentFileList); /// \brief Gets the FIRST *coherent* File List. /// Deprecated; kept not to break the API - /// \note Caller must call OrderGdcmFileList first + /// \note Caller must call OrderFileList first /// @return the (first) *coherent* File List - const GdcmFileList &GetGdcmFileList() { return - *CoherentGdcmFileListHT.begin()->second; } + const FileList &GetFileList() { return *CoherentFileListHT.begin()->second; } + + FileList *GetFirstCoherentFileList(); + FileList *GetNextCoherentFileList(); + FileList *GetCoherentFileList(std::string serieUID); + + /// All the following allow user to restrict DICOM file to be part + /// of a particular serie + GDCM_LEGACY( void AddRestriction(TagKey const &key, std::string const &value) ); + void AddRestriction(uint16_t group, uint16_t elem, + std::string const &value, int op); - GdcmFileList *GetFirstCoherentFileList(); - GdcmFileList *GetNextCoherentFileList(); - GdcmFileList *GetCoherentFileList(std::string SerieUID); +/** + * \brief Sets the LoadMode as a boolean string. + * NO_SEQ, NO_SHADOW, NO_SHADOWSEQ + ... (nothing more, right now) + * WARNING : before using NO_SHADOW, be sure *all* your files + * contain accurate values in the 0x0000 element (if any) + * of *each* Shadow Group. The parser will fail if the size is wrong ! + * @param mode Load mode to be used + */ + void SetLoadMode (int mode) { LoadMode = mode; } + +/// Brief User wants the files to be sorted Direct Order (default value) + void SetSortOrderToDirect() { DirectOrder = true; } + +/// Brief User wants the files to be sorted Reverse Order + void SetSortOrderToReverse() { DirectOrder = false; } private: - bool ImagePositionPatientOrdering(GdcmFileList *CoherentGdcmFileList); - bool ImageNumberOrdering(GdcmFileList *CoherentGdcmFileList); - bool FileNameOrdering(GdcmFileList *CoherentGdcmFileList); + bool ImagePositionPatientOrdering(FileList *coherentFileList); + bool ImageNumberOrdering(FileList *coherentFileList); + bool FileNameOrdering(FileList *coherentFileList); - CoherentFileListmap CoherentGdcmFileListHT; + static bool ImageNumberLessThan(File *file1, File *file2); + static bool ImageNumberGreaterThan(File *file1, File *file2); + static bool FileNameLessThan(File *file1, File *file2); + static bool FileNameGreaterThan(File *file1, File *file2); + +//Attributes: + CoherentFileListmap CoherentFileListHT; CoherentFileListmap::iterator ItListHt; + + typedef std::pair Rule; + typedef std::vector SerieRestrictions; + SerieRestrictions Restrictions; + + // New style for (extented) Rules (Moreover old one doesn't compile) + typedef struct { + uint16_t group; + uint16_t elem; + std::string value; + int op; + } ExRule; + typedef std::vector SerieExRestrictions; + SerieExRestrictions ExRestrictions; + + /// \brief Bit string integer (each one considered as a boolean) + /// Bit 0 : Skip Sequences, if possible + /// Bit 1 : Skip Shadow Groups if possible + /// Probabely, some more to add + int LoadMode; + + /// \brief whether we want to sort in direct order or not (reverse order). + /// To be used by aware user only + bool DirectOrder; }; } // end namespace gdcm