Program: gdcm
Module: $RCSfile: gdcmSerieHelper.h,v $
Language: C++
- Date: $Date: 2005/02/05 01:25:03 $
- Version: $Revision: 1.4 $
+ Date: $Date: 2005/07/17 04:26:57 $
+ Version: $Revision: 1.12 $
Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
l'Image). All rights reserved. See Doc/License.txt or
#include "gdcmCommon.h"
-#include <list>
#include <vector>
+#include <iostream>
#include <map>
namespace gdcm
{
class File;
-typedef std::vector<File* > GdcmFileList;
+typedef std::vector<File* > FileList;
//-----------------------------------------------------------------------------
/**
* - 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::map<std::string, GdcmFileList *> CoherentFileListmap;
- typedef std::vector<File* > GdcmFileVector;
+ typedef std::map<std::string, FileList *> CoherentFileListmap;
+ typedef std::vector<File* > FileVector;
SerieHelper();
~SerieHelper();
- void Print(std::ostream &os = std::cout, std::string const & indent = "" );
+ 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 SetDirectory(std::string const &dir, bool recursive=false);
- void OrderGdcmFileList(GdcmFileList *CoherentGdcmFileList);
+ 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; }
- GdcmFileList *GetFirstCoherentFileList();
- GdcmFileList *GetNextCoherentFileList();
- GdcmFileList *GetCoherentFileList(std::string SerieUID);
+ 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
+ void AddRestriction(TagKey const &key, std::string const &value);
+
+/**
+ * \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; }
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);
static bool ImageNumberLessThan(File *file1, File *file2);
static bool FileNameLessThan(File *file1, File *file2);
- CoherentFileListmap CoherentGdcmFileListHT;
+
+//Attributes:
+ CoherentFileListmap CoherentFileListHT;
CoherentFileListmap::iterator ItListHt;
+
+ typedef std::pair<TagKey, std::string> Rule;
+ typedef std::vector<Rule> SerieRestrictions;
+ SerieRestrictions Restrictions;
+
+ /// \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;
};
} // end namespace gdcm