/*========================================================================= Program: gdcm Module: $RCSfile: gdcmSerieHelper.h,v $ Language: C++ Date: $Date: 2005/12/21 14:48:09 $ Version: $Revision: 1.35 $ 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.html for details. This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the above copyright notices for more information. =========================================================================*/ #ifndef GDCMSERIEHELPER_H #define GDCMSERIEHELPER_H #include "gdcmRefCounter.h" #include "gdcmTagKey.h" #include "gdcmDebug.h" // for LEGACY #include #include #include namespace gdcm { class File; typedef std::vector FileList; /// \brief XCoherent stands for 'Extra Coherent', /// (The name 'Coherent' would be enough but it was used before; /// I don't want to put a bomb in the code) /// Any 'better name' is welcome ! typedef std::map XCoherentFileSetmap; typedef bool (*BOOL_FUNCTION_PFILE_PFILE_POINTER)(File *, File *); //----------------------------------------------------------------------------- /** * \brief * 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 'Single SerieUID Filesets' * - It allows : * - - to sort any of the 'Single SerieUID Fileset' on the image position. * - - to split any of the Single SerieUID Filesets (better use this name than * 'CoherentFileList' : it's NOT a std::list, files are NOT coherent ...) * into several XCoherent Filesets * XCoherent stands for 'Extra Coherent' (same orientation, or same position) */ class GDCM_EXPORT SerieHelper : public RefCounter { gdcmTypeMacro(SerieHelper); public: /// SingleSerieUIDFileSetmap replaces the former CoherentFileListmap /// ( List were actually std::vectors, and wher no coherent at all : /// They were only Single SeriesInstanceUID File sets) typedef std::map SingleSerieUIDFileSetmap; typedef std::vector FileVector; /// \brief Constructs a SerieHelper with a RefCounter static SerieHelper *New() {return new SerieHelper();} virtual ~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); bool IsCoherent(FileList *fileSet); void OrderFileList(FileList *fileSet); /// \brief Gets the FIRST Single SerieUID Fileset. /// Deprecated; kept not to break the API /// \note Caller must call OrderFileList first /// @return the (first) Single SerieUID Fileset const FileList &GetFileList() { return *SingleSerieUIDFileSetHT.begin()->second; } GDCM_LEGACY( FileList *GetFirstCoherentFileList() ); GDCM_LEGACY( FileList *GetNextCoherentFileList() ); GDCM_LEGACY( FileList *GetCoherentFileList(std::string serieUID) ); FileList *GetFirstSingleSerieUIDFileSet(); FileList *GetNextSingleSerieUIDFileSet(); FileList *GetSingleSerieUIDFileSet(std::string serieUID); /// brief returns the 'Series Instance UID' Single SerieUID FileSet std::string GetCurrentSerieUIDFileSetUID() { return (*ItFileSetHt).first; } /// All the following allow user to restrict DICOM file to be part /// of a particular serie /// \todo : find a trick to allow user to say the retrictetons are ored /// (not only anded) /// ex : keep the images whose SerieNumber is 101 or 102 or 103. void AddRestriction(TagKey const &key, std::string const &value, int op); void AddRestriction(uint16_t group, uint16_t elem, std::string const &value, int op); /// \brief Use additional series information such as ProtocolName /// and SeriesName to identify when a single SeriesUID contains /// multiple 3D volumes - as can occur with perfusion and DTI imaging void SetUseSeriesDetails( bool useSeriesDetails ) { m_UseSeriesDetails = useSeriesDetails;} bool GetUseSeriesDetails( ){ return m_UseSeriesDetails; } void AddSeriesDetail(uint16_t group, uint16_t elem, bool convert); std::string CreateUniqueSeriesIdentifier( File * inFile ); std::string CreateUserDefinedFileIdentifier( File * inFile ); /** * \brief Sets the LoadMode as a boolean string. * LD_NOSEQ, LD_NOSHADOW, LD_NOSHADOWSEQ * ... (nothing more, right now) * WARNING : before using LD_NOSHADOW, 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; } /// to allow user to give is own comparison function void SetUserLessThanFunction( BOOL_FUNCTION_PFILE_PFILE_POINTER userFunc ) { UserLessThanFunction = userFunc; } XCoherentFileSetmap SplitOnOrientation(FileList *fileSet); XCoherentFileSetmap SplitOnPosition(FileList *fileSet); XCoherentFileSetmap SplitOnTagValue(FileList *fileSet, uint16_t group, uint16_t elem); protected : SerieHelper(); private: void ClearAll(); bool UserOrdering(FileList *fileSet); bool ImagePositionPatientOrdering(FileList *fileSet); bool ImageNumberOrdering(FileList *fileSet); bool FileNameOrdering(FileList *fileSet); 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: SingleSerieUIDFileSetmap SingleSerieUIDFileSetHT; SingleSerieUIDFileSetmap::iterator ItFileSetHt; typedef std::pair Rule; typedef std::vector SerieRestrictions; SerieRestrictions Restrictions; // New style for (extented) Rules typedef struct { uint16_t group; uint16_t elem; std::string value; int op; } ExRule; typedef std::vector SerieExRestrictions; SerieExRestrictions ExRestrictions; typedef struct { uint16_t group; uint16_t elem; bool convert; } ExDetail; typedef std::vector SeriesExDetails; SeriesExDetails ExDetails; bool m_UseSeriesDetails; /// \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; /// \brief If user knows more about his images than gdcm does, /// he may supply his own comparison function. BOOL_FUNCTION_PFILE_PFILE_POINTER UserLessThanFunction; }; } // end namespace gdcm //----------------------------------------------------------------------------- #endif