ome-xml  5.5.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 
139  private:
141  Channel&
142  operator= (const Channel&);
143 
144  public:
145  // -- OMEModelObject API methods --
146 
148  virtual void
149  update(const common::xml::dom::Element& element,
151 
152  public:
153  // -- Channel API methods --
154 
156  bool
157  link (std::shared_ptr<Reference>& reference,
158  std::shared_ptr<ome::xml::model::OMEModelObject>& object);
159 
165  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength > >&
166  getPinholeSize ();
167 
173  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength > >&
174  getPinholeSize () const;
175 
181  void
183 
189  std::shared_ptr<std::string>
190  getName ();
191 
197  const std::shared_ptr<std::string>
198  getName () const;
199 
205  void
206  setName (std::shared_ptr<std::string>& name);
207 
213  std::shared_ptr<ome::xml::model::enums::AcquisitionMode>
215 
221  const std::shared_ptr<ome::xml::model::enums::AcquisitionMode>
222  getAcquisitionMode () const;
223 
229  void
230  setAcquisitionMode (std::shared_ptr<ome::xml::model::enums::AcquisitionMode>& acquisitionMode);
231 
237  std::shared_ptr<ome::xml::model::primitives::Color>
238  getColor ();
239 
245  const std::shared_ptr<ome::xml::model::primitives::Color>
246  getColor () const;
247 
253  void
254  setColor (std::shared_ptr<ome::xml::model::primitives::Color>& color);
255 
261  std::shared_ptr<ome::xml::model::enums::ContrastMethod>
263 
269  const std::shared_ptr<ome::xml::model::enums::ContrastMethod>
270  getContrastMethod () const;
271 
277  void
278  setContrastMethod (std::shared_ptr<ome::xml::model::enums::ContrastMethod>& contrastMethod);
279 
285  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
287 
293  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
294  getExcitationWavelength () const;
295 
301  void
303 
309  std::shared_ptr<ome::xml::model::enums::IlluminationType>
311 
317  const std::shared_ptr<ome::xml::model::enums::IlluminationType>
318  getIlluminationType () const;
319 
325  void
326  setIlluminationType (std::shared_ptr<ome::xml::model::enums::IlluminationType>& illuminationType);
327 
333  std::shared_ptr<std::string>
334  getFluor ();
335 
341  const std::shared_ptr<std::string>
342  getFluor () const;
343 
349  void
350  setFluor (std::shared_ptr<std::string>& fluor);
351 
357  std::shared_ptr<int32_t>
359 
365  const std::shared_ptr<int32_t>
366  getPockelCellSetting () const;
367 
373  void
374  setPockelCellSetting (std::shared_ptr<int32_t>& pockelCellSetting);
375 
381  std::shared_ptr<double>
382  getNDFilter ();
383 
389  const std::shared_ptr<double>
390  getNDFilter () const;
391 
397  void
398  setNDFilter (std::shared_ptr<double>& ndFilter);
399 
405  std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
407 
413  const std::shared_ptr<ome::xml::model::primitives::Quantity<ome::xml::model::enums::UnitsLength, ome::xml::model::primitives::PositiveFloat > >&
414  getEmissionWavelength () const;
415 
421  void
423 
429  const std::string&
430  getID () const;
431 
437  void
438  setID (const std::string& id);
439 
445  std::shared_ptr<ome::xml::model::primitives::PositiveInteger>
447 
453  const std::shared_ptr<ome::xml::model::primitives::PositiveInteger>
454  getSamplesPerPixel () const;
455 
461  void
462  setSamplesPerPixel (std::shared_ptr<ome::xml::model::primitives::PositiveInteger>& samplesPerPixel);
463 
469  std::shared_ptr<ome::xml::model::LightSourceSettings>
471 
477  const std::shared_ptr<ome::xml::model::LightSourceSettings>
478  getLightSourceSettings () const;
479 
485  void
486  setLightSourceSettings (std::shared_ptr<ome::xml::model::LightSourceSettings>& lightSourceSettings);
487 
493  std::shared_ptr<ome::xml::model::DetectorSettings>
495 
501  const std::shared_ptr<ome::xml::model::DetectorSettings>
502  getDetectorSettings () const;
503 
509  void
510  setDetectorSettings (std::shared_ptr<ome::xml::model::DetectorSettings>& detectorSettings);
511 
518  std::weak_ptr<ome::xml::model::FilterSet>
520 
527  const std::weak_ptr<ome::xml::model::FilterSet>
528  getLinkedFilterSet () const;
529 
535  void
536  linkFilterSet (std::shared_ptr<ome::xml::model::FilterSet>& filterSet);
537 
547  void
548  unlinkFilterSet (std::shared_ptr<ome::xml::model::FilterSet>& filterSet);
549 
557 
564  getLinkedAnnotationList () const;
565 
573  const std::weak_ptr<ome::xml::model::Annotation>&
575 
586  const std::weak_ptr<ome::xml::model::Annotation>&
588  const std::shared_ptr<ome::xml::model::Annotation>& annotation);
589 
600  bool
601  linkAnnotation (const std::shared_ptr<ome::xml::model::Annotation>& annotation);
602 
618  bool
619  unlinkAnnotation (const std::shared_ptr<ome::xml::model::Annotation>& annotation);
620 
626  std::shared_ptr<ome::xml::model::LightPath>
627  getLightPath ();
628 
634  const std::shared_ptr<ome::xml::model::LightPath>
635  getLightPath () const;
636 
642  void
643  setLightPath (std::shared_ptr<ome::xml::model::LightPath>& lightPath);
644 
650  std::weak_ptr<ome::xml::model::Pixels>
651  getPixels ();
652 
658  const std::weak_ptr<ome::xml::model::Pixels>
659  getPixels () const;
660 
666  void
667  setPixels (std::weak_ptr<ome::xml::model::Pixels>& pixels_BackReference);
668 
669  protected:
670  // Documented in base class.
671  virtual void
673  common::xml::dom::Element& element) const;
674 
675  public:
676  // Documented in superclass.
677  const std::string&
678  getXMLNamespace() const;
679  };
680 
681  }
682  }
683 }
684 
685 #endif // OME_XML_MODEL_CHANNEL_H
686 
687 /*
688  * Local Variables:
689  * mode:C++
690  * End:
691  */
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:559
void setPockelCellSetting(std::shared_ptr< int32_t > &pockelCellSetting)
Set the PockelCellSetting property.
Definition: Channel.cpp:741
bool linkAnnotation(const std::shared_ptr< ome::xml::model::Annotation > &annotation)
Link Annotation.
Definition: Channel.cpp:924
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:678
bool unlinkAnnotation(const std::shared_ptr< ome::xml::model::Annotation > &annotation)
Unlink Annotation.
Definition: Channel.cpp:938
void setAcquisitionMode(std::shared_ptr< ome::xml::model::enums::AcquisitionMode > &acquisitionMode)
Set the AcquisitionMode property.
Definition: Channel.cpp:615
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:573
Channel()
Default constructor.
Definition: Channel.cpp:259
std::shared_ptr< std::string > getName()
Get the Name property.
Definition: Channel.cpp:580
virtual 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:301
void setIlluminationType(std::shared_ptr< ome::xml::model::enums::IlluminationType > &illuminationType)
Set the IlluminationType property.
Definition: Channel.cpp:699
virtual ~Channel()
Destructor.
Definition: Channel.cpp:274
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:790
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:908
std::weak_ptr< ome::xml::model::Pixels > getPixels()
Get the Pixels property.
Definition: Channel.cpp:977
bool validElementName(const std::string &name) const
Check if a given element name is valid for processing by this model object.
Definition: Channel.cpp:295
std::weak_ptr< ome::xml::model::FilterSet > getLinkedFilterSet()
Get linked FilterSet.
Definition: Channel.cpp:867
void setLightPath(std::shared_ptr< ome::xml::model::LightPath > &lightPath)
Set the LightPath property.
Definition: Channel.cpp:970
void setSamplesPerPixel(std::shared_ptr< ome::xml::model::primitives::PositiveInteger > &samplesPerPixel)
Set the SamplesPerPixel property.
Definition: Channel.cpp:818
const std::string & getXMLNamespace() const
Get the XML namespace for this model object.
Definition: Channel.cpp:1199
std::shared_ptr< ome::xml::model::primitives::PositiveInteger > getSamplesPerPixel()
Get the SamplesPerPixel property.
Definition: Channel.cpp:804
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:769
Channel & operator=(const Channel &)
Assignment operator (deleted).
void linkFilterSet(std::shared_ptr< ome::xml::model::FilterSet > &filterSet)
Link FilterSet.
Definition: Channel.cpp:880
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:997
std::shared_ptr< ome::xml::model::enums::AcquisitionMode > getAcquisitionMode()
Get the AcquisitionMode property.
Definition: Channel.cpp:601
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:727
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:279
std::shared_ptr< ome::xml::model::DetectorSettings > getDetectorSettings()
Get the DetectorSettings property.
Definition: Channel.cpp:846
const std::string & elementName() const
Get the element name of this model object.
Definition: Channel.cpp:288
std::shared_ptr< ome::xml::model::LightPath > getLightPath()
Get the LightPath property.
Definition: Channel.cpp:956
void unlinkFilterSet(std::shared_ptr< ome::xml::model::FilterSet > &filterSet)
Unlink FilterSet.
Definition: Channel.cpp:886
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:783
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:636
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:914
void setDetectorSettings(std::shared_ptr< ome::xml::model::DetectorSettings > &detectorSettings)
Set the DetectorSettings property.
Definition: Channel.cpp:860
void setFluor(std::shared_ptr< std::string > &fluor)
Set the Fluor property.
Definition: Channel.cpp:720
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:664
void setLightSourceSettings(std::shared_ptr< ome::xml::model::LightSourceSettings > &lightSourceSettings)
Set the LightSourceSettings property.
Definition: Channel.cpp:839
void setPixels(std::weak_ptr< ome::xml::model::Pixels > &pixels_BackReference)
Set the Pixels property.
Definition: Channel.cpp:991
std::shared_ptr< ome::xml::model::primitives::Color > getColor()
Get the Color property.
Definition: Channel.cpp:622
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:517
std::shared_ptr< std::string > getFluor()
Get the Fluor property.
Definition: Channel.cpp:706
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:825
void setName(std::shared_ptr< std::string > &name)
Set the Name property.
Definition: Channel.cpp:594
OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type::size_type sizeOfLinkedAnnotationList() const
Get size of linked Annotation list.
Definition: Channel.cpp:896
OMEModelObject::indexed_container< ome::xml::model::Annotation, std::weak_ptr >::type getLinkedAnnotationList() const
Get the linked Annotation list.
Definition: Channel.cpp:902
std::shared_ptr< ome::xml::model::enums::ContrastMethod > getContrastMethod()
Get the ContrastMethod property.
Definition: Channel.cpp:643
void setID(const std::string &id)
Set the ID property.
Definition: Channel.cpp:797
void setNDFilter(std::shared_ptr< double > &ndFilter)
Set the NDFilter property.
Definition: Channel.cpp:762
std::shared_ptr< double > getNDFilter()
Get the NDFilter property.
Definition: Channel.cpp:748
void setContrastMethod(std::shared_ptr< ome::xml::model::enums::ContrastMethod > &contrastMethod)
Set the ContrastMethod property.
Definition: Channel.cpp:657
std::shared_ptr< ome::xml::model::enums::IlluminationType > getIlluminationType()
Get the IlluminationType property.
Definition: Channel.cpp:685