ome-xml  5.6.0
Channel.h
1 /*
2  * #%L
3  * OME-XML C++ library for working with OME-XML metadata structures.
4  * %%
5  * Copyright © 2006 - 2016 Open Microscopy Environment:
6  * - Massachusetts Institute of Technology
7  * - National Institutes of Health
8  * - University of Dundee
9  * - Board of Regents of the University of Wisconsin-Madison
10  * - Glencoe Software, Inc.
11  * %%
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions are met:
14  *
15  * 1. Redistributions of source code must retain the above copyright notice,
16  * this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright notice,
18  * this list of conditions and the following disclaimer in the documentation
19  * and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  * The views and conclusions contained in the software and documentation are
34  * those of the authors and should not be interpreted as representing official
35  * policies, either expressed or implied, of any organization.
36  * #L%
37  */
38 
39 /*─────────────────────────────────────────────────────────────────────────────
40  *
41  * THIS IS AUTOMATICALLY GENERATED CODE. DO NOT MODIFY.
42  *
43  *─────────────────────────────────────────────────────────────────────────────
44  */
45 
46 #ifndef OME_XML_MODEL_CHANNEL_H
47 #define OME_XML_MODEL_CHANNEL_H
48 
49 #include <algorithm>
50 #include <list>
51 #include <stdexcept>
52 #include <string>
53 #include <vector>
54 
55 #include <ome/common/log.h>
56 
57 #include <ome/common/xml/dom/Document.h>
58 #include <ome/common/xml/dom/Element.h>
59 #include <ome/common/xml/dom/Node.h>
60 
61 #include <ome/xml/model/primitives/Quantity.h>
62 
63 #include <ome/xml/model/DetectorSettings.h>
64 #include <ome/xml/model/FilterSet.h>
65 #include <ome/xml/model/LightPath.h>
66 #include <ome/xml/model/LightSourceSettings.h>
67 #include <ome/xml/model/Pixels.h>
68 #include <ome/xml/model/detail/OMEModelObject.h>
69 #include <ome/xml/model/enums/AcquisitionMode.h>
70 #include <ome/xml/model/enums/ContrastMethod.h>
71 #include <ome/xml/model/enums/IlluminationType.h>
72 #include <ome/xml/model/enums/UnitsLength.h>
73 #include <ome/xml/model/primitives/Color.h>
74 #include <ome/xml/model/primitives/PositiveFloat.h>
75 #include <ome/xml/model/primitives/PositiveInteger.h>
76 
77 namespace ome
78 {
79  namespace xml
80  {
81  namespace model
82  {
83 
84  // Forward declarations.
85  class Annotation;
86  class OMEModel;
87 
92  {
93  private:
94  class Impl;
96  std::shared_ptr<Impl> impl;
97 
98  public:
100  Channel();
101 
107  Channel (const Channel& copy);
108 
110  virtual
111  ~Channel ();
112 
127  static std::shared_ptr<Channel>
128  create(const common::xml::dom::Element& element,
130 
131  // Documented in superclass.
132  const std::string&
133  elementName() const;
134 
135  // Documented in superclass.
136  bool
137  validElementName(const std::string& name) const;
138 
140  Channel&
141  operator= (const Channel&) = delete;
143 
144  // -- OMEModelObject API methods --
145 
147  virtual void
148  update(const common::xml::dom::Element& element,
150 
151  public:
152  // -- Channel API methods --
153 
155  bool
156  link (std::shared_ptr<Reference>& reference,
157  std::shared_ptr<ome::xml::model::OMEModelObject>& object);
158 
164  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength > >&
165  getPinholeSize ();
166 
172  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength > >&
173  getPinholeSize () const;
174 
180  void
182 
188  std::shared_ptr<std::string>
189  getName ();
190 
196  const std::shared_ptr<std::string>
197  getName () const;
198 
204  void
205  setName (std::shared_ptr<std::string>& name);
206 
212  std::shared_ptr<ome::xml::model::enums::AcquisitionMode>
214 
220  const std::shared_ptr<ome::xml::model::enums::AcquisitionMode>
221  getAcquisitionMode () const;
222 
228  void
229  setAcquisitionMode (std::shared_ptr<ome::xml::model::enums::AcquisitionMode>& acquisitionMode);
230 
236  std::shared_ptr<ome::xml::model::primitives::Color>
237  getColor ();
238 
244  const std::shared_ptr<ome::xml::model::primitives::Color>
245  getColor () const;
246 
252  void
253  setColor (std::shared_ptr<ome::xml::model::primitives::Color>& color);
254 
260  std::shared_ptr<ome::xml::model::enums::ContrastMethod>
262 
268  const std::shared_ptr<ome::xml::model::enums::ContrastMethod>
269  getContrastMethod () const;
270 
276  void
277  setContrastMethod (std::shared_ptr<ome::xml::model::enums::ContrastMethod>& contrastMethod);
278 
284  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
286 
292  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
293  getExcitationWavelength () const;
294 
300  void
302 
308  std::shared_ptr<ome::xml::model::enums::IlluminationType>
310 
316  const std::shared_ptr<ome::xml::model::enums::IlluminationType>
317  getIlluminationType () const;
318 
324  void
325  setIlluminationType (std::shared_ptr<ome::xml::model::enums::IlluminationType>& illuminationType);
326 
332  std::shared_ptr<std::string>
333  getFluor ();
334 
340  const std::shared_ptr<std::string>
341  getFluor () const;
342 
348  void
349  setFluor (std::shared_ptr<std::string>& fluor);
350 
356  std::shared_ptr<int32_t>
358 
364  const std::shared_ptr<int32_t>
365  getPockelCellSetting () const;
366 
372  void
373  setPockelCellSetting (std::shared_ptr<int32_t>& pockelCellSetting);
374 
380  std::shared_ptr<double>
381  getNDFilter ();
382 
388  const std::shared_ptr<double>
389  getNDFilter () const;
390 
396  void
397  setNDFilter (std::shared_ptr<double>& ndFilter);
398 
404  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
406 
412  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
413  getEmissionWavelength () const;
414 
420  void
422 
428  const std::string&
429  getID () const;
430 
436  void
437  setID (const std::string& id);
438 
444  std::shared_ptr<ome::xml::model::primitives::PositiveInteger>
446 
452  const std::shared_ptr<ome::xml::model::primitives::PositiveInteger>
453  getSamplesPerPixel () const;
454 
460  void
461  setSamplesPerPixel (std::shared_ptr<ome::xml::model::primitives::PositiveInteger>& samplesPerPixel);
462 
468  std::shared_ptr<ome::xml::model::LightSourceSettings>
470 
476  const std::shared_ptr<ome::xml::model::LightSourceSettings>
477  getLightSourceSettings () const;
478 
484  void
485  setLightSourceSettings (std::shared_ptr<ome::xml::model::LightSourceSettings>& lightSourceSettings);
486 
492  std::shared_ptr<ome::xml::model::DetectorSettings>
494 
500  const std::shared_ptr<ome::xml::model::DetectorSettings>
501  getDetectorSettings () const;
502 
508  void
509  setDetectorSettings (std::shared_ptr<ome::xml::model::DetectorSettings>& detectorSettings);
510 
517  std::weak_ptr<ome::xml::model::FilterSet>
519 
526  const std::weak_ptr<ome::xml::model::FilterSet>
527  getLinkedFilterSet () const;
528 
534  void
535  linkFilterSet (std::shared_ptr<ome::xml::model::FilterSet>& filterSet);
536 
546  void
547  unlinkFilterSet (std::shared_ptr<ome::xml::model::FilterSet>& filterSet);
548 
556 
563  getLinkedAnnotationList () const;
564 
572  const std::weak_ptr<ome::xml::model::Annotation>&
574 
585  const std::weak_ptr<ome::xml::model::Annotation>&
587  const std::shared_ptr<ome::xml::model::Annotation>& annotation);
588 
599  bool
600  linkAnnotation (const std::shared_ptr<ome::xml::model::Annotation>& annotation);
601 
617  bool
618  unlinkAnnotation (const std::shared_ptr<ome::xml::model::Annotation>& annotation);
619 
625  std::shared_ptr<ome::xml::model::LightPath>
626  getLightPath ();
627 
633  const std::shared_ptr<ome::xml::model::LightPath>
634  getLightPath () const;
635 
641  void
642  setLightPath (std::shared_ptr<ome::xml::model::LightPath>& lightPath);
643 
649  std::weak_ptr<ome::xml::model::Pixels>
650  getPixels ();
651 
657  const std::weak_ptr<ome::xml::model::Pixels>
658  getPixels () const;
659 
665  void
666  setPixels (std::weak_ptr<ome::xml::model::Pixels>& pixels_BackReference);
667 
668  protected:
669  // Documented in base class.
670  virtual void
672  common::xml::dom::Element& element) const;
673 
674  public:
675  // Documented in superclass.
676  const std::string&
677  getXMLNamespace() const;
678  };
679 
680  }
681  }
682 }
683 
684 #endif // OME_XML_MODEL_CHANNEL_H
685 
686 /*
687  * Local Variables:
688  * mode:C++
689  * End:
690  */
OME model interface (abstract top-level container)
Definition: OMEModel.h:61
std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength > > & getPinholeSize()
Get the PinholeSize property.
Definition: Channel.cpp:567
void setPockelCellSetting(std::shared_ptr< int32_t > &pockelCellSetting)
Set the PockelCellSetting property.
Definition: Channel.cpp:749
bool linkAnnotation(const std::shared_ptr< ome::xml::model::Annotation > &annotation)
Link Annotation.
Definition: Channel.cpp:932
void setExcitationWavelength(const std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > > &excitationWavelength)
Set the ExcitationWavelength property.
Definition: Channel.cpp:686
bool unlinkAnnotation(const std::shared_ptr< ome::xml::model::Annotation > &annotation)
Unlink Annotation.
Definition: Channel.cpp:946
void setAcquisitionMode(std::shared_ptr< ome::xml::model::enums::AcquisitionMode > &acquisitionMode)
Set the AcquisitionMode property.
Definition: Channel.cpp:623
std::shared_ptr< Impl > impl
Private implementation details.
Definition: Channel.h:94
void setPinholeSize(const std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength > > &pinholeSize)
Set the PinholeSize property.
Definition: Channel.cpp:581
Channel()
Default constructor.
Definition: Channel.cpp:263
std::shared_ptr< std::string > getName()
Get the Name property.
Definition: Channel.cpp:588
virtual SKIP void update(const common::xml::dom::Element &element, ome::xml::model::OMEModel &model)
Update the object hierarchy recursively from an XML DOM tree.
Definition: Channel.cpp:309
void setIlluminationType(std::shared_ptr< ome::xml::model::enums::IlluminationType > &illuminationType)
Set the IlluminationType property.
Definition: Channel.cpp:707
virtual ~Channel()
Destructor.
Definition: Channel.cpp:282
boost::multi_index_container< Ptr< T >, boost::multi_index::indexed_by< boost::multi_index::random_access<>, boost::multi_index::ordered_unique< boost::multi_index::identity< Ptr< T > >, std::owner_less< Ptr< T > > > > > type
Multi-index container type.
Definition: OMEModelObject.h:93
const std::string & getID() const
Get the ID property.
Definition: Channel.cpp:798
OME model object (concrete implementation).
Definition: OMEModelObject.h:64
Channel model object.
Definition: Channel.h:91
const std::weak_ptr< ome::xml::model::Annotation > & getLinkedAnnotation(OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type::size_type index) const
Get linked Annotation.
Definition: Channel.cpp:916
std::weak_ptr< ome::xml::model::Pixels > getPixels()
Get the Pixels property.
Definition: Channel.cpp:985
bool validElementName(const std::string &name) const
Check if a given element name is valid for processing by this model object.
Definition: Channel.cpp:303
std::weak_ptr< ome::xml::model::FilterSet > getLinkedFilterSet()
Get linked FilterSet.
Definition: Channel.cpp:875
void setLightPath(std::shared_ptr< ome::xml::model::LightPath > &lightPath)
Set the LightPath property.
Definition: Channel.cpp:978
void setSamplesPerPixel(std::shared_ptr< ome::xml::model::primitives::PositiveInteger > &samplesPerPixel)
Set the SamplesPerPixel property.
Definition: Channel.cpp:826
const std::string & getXMLNamespace() const
Get the XML namespace for this model object.
Definition: Channel.cpp:1207
std::shared_ptr< ome::xml::model::primitives::PositiveInteger > getSamplesPerPixel()
Get the SamplesPerPixel property.
Definition: Channel.cpp:812
std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > > & getEmissionWavelength()
Get the EmissionWavelength property.
Definition: Channel.cpp:777
void linkFilterSet(std::shared_ptr< ome::xml::model::FilterSet > &filterSet)
Link FilterSet.
Definition: Channel.cpp:888
virtual void asXMLElementInternal(common::xml::dom::Document &document, common::xml::dom::Element &element) const
Transform the object hierarchy rooted at this element to XML.
Definition: Channel.cpp:1005
std::shared_ptr< ome::xml::model::enums::AcquisitionMode > getAcquisitionMode()
Get the AcquisitionMode property.
Definition: Channel.cpp:609
Multi-index container for efficient ordered insertion and deletion of model object references...
Definition: OMEModelObject.h:84
std::shared_ptr< int32_t > getPockelCellSetting()
Get the PockelCellSetting property.
Definition: Channel.cpp:735
Open Microscopy Environment C++ implementation.
static std::shared_ptr< Channel > create(const common::xml::dom::Element &element, ome::xml::model::OMEModel &model)
Create a Channel model object from DOM element.
Definition: Channel.cpp:287
std::shared_ptr< ome::xml::model::DetectorSettings > getDetectorSettings()
Get the DetectorSettings property.
Definition: Channel.cpp:854
const std::string & elementName() const
Get the element name of this model object.
Definition: Channel.cpp:296
std::shared_ptr< ome::xml::model::LightPath > getLightPath()
Get the LightPath property.
Definition: Channel.cpp:964
void unlinkFilterSet(std::shared_ptr< ome::xml::model::FilterSet > &filterSet)
Unlink FilterSet.
Definition: Channel.cpp:894
void setEmissionWavelength(const std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > > &emissionWavelength)
Set the EmissionWavelength property.
Definition: Channel.cpp:791
Private implementation details of Channel model object.
Definition: Channel.cpp:94
void setColor(std::shared_ptr< ome::xml::model::primitives::Color > &color)
Set the Color property.
Definition: Channel.cpp:644
const std::weak_ptr< ome::xml::model::Annotation > & setLinkedAnnotation(OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type::size_type index, const std::shared_ptr< ome::xml::model::Annotation > &annotation)
Set linked Annotation.
Definition: Channel.cpp:922
void setDetectorSettings(std::shared_ptr< ome::xml::model::DetectorSettings > &detectorSettings)
Set the DetectorSettings property.
Definition: Channel.cpp:868
void setFluor(std::shared_ptr< std::string > &fluor)
Set the Fluor property.
Definition: Channel.cpp:728
std::shared_ptr< ome::xml::model::primitives::Quantity< ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > > & getExcitationWavelength()
Get the ExcitationWavelength property.
Definition: Channel.cpp:672
void setLightSourceSettings(std::shared_ptr< ome::xml::model::LightSourceSettings > &lightSourceSettings)
Set the LightSourceSettings property.
Definition: Channel.cpp:847
void setPixels(std::weak_ptr< ome::xml::model::Pixels > &pixels_BackReference)
Set the Pixels property.
Definition: Channel.cpp:999
std::shared_ptr< ome::xml::model::primitives::Color > getColor()
Get the Color property.
Definition: Channel.cpp:630
bool link(std::shared_ptr< Reference > &reference, std::shared_ptr< ome::xml::model::OMEModelObject > &object)
Link a given OME model object to this model object.
Definition: Channel.cpp:525
std::shared_ptr< std::string > getFluor()
Get the Fluor property.
Definition: Channel.cpp:714
A quantity of a defined unit.
Definition: Quantity.h:57
std::shared_ptr< ome::xml::model::LightSourceSettings > getLightSourceSettings()
Get the LightSourceSettings property.
Definition: Channel.cpp:833
void setName(std::shared_ptr< std::string > &name)
Set the Name property.
Definition: Channel.cpp:602
OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type::size_type sizeOfLinkedAnnotationList() const
Get size of linked Annotation list.
Definition: Channel.cpp:904
OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type getLinkedAnnotationList() const
Get the linked Annotation list.
Definition: Channel.cpp:910
std::shared_ptr< ome::xml::model::enums::ContrastMethod > getContrastMethod()
Get the ContrastMethod property.
Definition: Channel.cpp:651
void setID(const std::string &id)
Set the ID property.
Definition: Channel.cpp:805
void setNDFilter(std::shared_ptr< double > &ndFilter)
Set the NDFilter property.
Definition: Channel.cpp:770
std::shared_ptr< double > getNDFilter()
Get the NDFilter property.
Definition: Channel.cpp:756
void setContrastMethod(std::shared_ptr< ome::xml::model::enums::ContrastMethod > &contrastMethod)
Set the ContrastMethod property.
Definition: Channel.cpp:665
std::shared_ptr< ome::xml::model::enums::IlluminationType > getIlluminationType()
Get the IlluminationType property.
Definition: Channel.cpp:693