110448Snilay@cs.wisc.edu/* Copyright (c) 2012 Massachusetts Institute of Technology
210448Snilay@cs.wisc.edu *
310448Snilay@cs.wisc.edu * Permission is hereby granted, free of charge, to any person obtaining a copy
410448Snilay@cs.wisc.edu * of this software and associated documentation files (the "Software"), to deal
510448Snilay@cs.wisc.edu * in the Software without restriction, including without limitation the rights
610448Snilay@cs.wisc.edu * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
710448Snilay@cs.wisc.edu * copies of the Software, and to permit persons to whom the Software is
810448Snilay@cs.wisc.edu * furnished to do so, subject to the following conditions:
910448Snilay@cs.wisc.edu *
1010448Snilay@cs.wisc.edu * The above copyright notice and this permission notice shall be included in
1110448Snilay@cs.wisc.edu * all copies or substantial portions of the Software.
1210448Snilay@cs.wisc.edu *
1310448Snilay@cs.wisc.edu * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
1410448Snilay@cs.wisc.edu * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
1510448Snilay@cs.wisc.edu * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
1610448Snilay@cs.wisc.edu * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
1710448Snilay@cs.wisc.edu * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
1810448Snilay@cs.wisc.edu * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
1910448Snilay@cs.wisc.edu * THE SOFTWARE.
2010448Snilay@cs.wisc.edu */
2110448Snilay@cs.wisc.edu
2210447Snilay@cs.wisc.edu#ifndef __DSENT_MODEL_OPTICALGRAPH_OPTICALNODE_H__
2310447Snilay@cs.wisc.edu#define __DSENT_MODEL_OPTICALGRAPH_OPTICALNODE_H__
2410447Snilay@cs.wisc.edu
2510447Snilay@cs.wisc.edu#include "model/OpticalModel.h"
2610447Snilay@cs.wisc.edu#include "util/CommonType.h"
2710447Snilay@cs.wisc.edu
2810447Snilay@cs.wisc.edunamespace DSENT
2910447Snilay@cs.wisc.edu{
3010447Snilay@cs.wisc.edu    class OpticalNode;
3110447Snilay@cs.wisc.edu
3210447Snilay@cs.wisc.edu    //TODO: Change to detector
3310447Snilay@cs.wisc.edu    typedef std::pair<OpticalNode*, double> DetectorEntry;
3410447Snilay@cs.wisc.edu    typedef std::vector<DetectorEntry> DetectorTable;
3510447Snilay@cs.wisc.edu
3610447Snilay@cs.wisc.edu    class OpticalNode
3710447Snilay@cs.wisc.edu    {
3810447Snilay@cs.wisc.edu        public:
3910447Snilay@cs.wisc.edu            // The starting visited number flag of all optical nodes
4010447Snilay@cs.wisc.edu            static const int OPTICAL_NODE_INIT_VISITED_NUM;
4110447Snilay@cs.wisc.edu
4210447Snilay@cs.wisc.edu            // The types of optical nodes that can exist
4310447Snilay@cs.wisc.edu            enum Type
4410447Snilay@cs.wisc.edu            {
4510447Snilay@cs.wisc.edu                WAVEGUIDE,
4610447Snilay@cs.wisc.edu                LASER,
4710447Snilay@cs.wisc.edu                MODULATOR,
4810447Snilay@cs.wisc.edu                FILTER,
4910447Snilay@cs.wisc.edu                DETECTOR
5010447Snilay@cs.wisc.edu            };
5110447Snilay@cs.wisc.edu
5210447Snilay@cs.wisc.edu        public:
5310447Snilay@cs.wisc.edu            OpticalNode(Type type_, const String& instance_name_, OpticalModel* model_, const WavelengthGroup& wavelengths_);
5410447Snilay@cs.wisc.edu            ~OpticalNode();
5510447Snilay@cs.wisc.edu
5610447Snilay@cs.wisc.edu        public:
5710447Snilay@cs.wisc.edu            // Get the type of optical node
5810447Snilay@cs.wisc.edu            Type getType() const;
5910447Snilay@cs.wisc.edu            // Return instance name
6010447Snilay@cs.wisc.edu            const String& getInstanceName() const;
6110447Snilay@cs.wisc.edu            // Get the downstream optical nodes
6210447Snilay@cs.wisc.edu            vector<OpticalNode*>* getDownstreamNodes() const;
6310447Snilay@cs.wisc.edu            // Connect the downstream optical node
6410447Snilay@cs.wisc.edu            void addDownstreamNode(OpticalNode* node_);
6510447Snilay@cs.wisc.edu            // Return the node's parent model
6610447Snilay@cs.wisc.edu            OpticalModel* getModel();
6710447Snilay@cs.wisc.edu            const OpticalModel* getModel() const;
6810447Snilay@cs.wisc.edu            // Get wavelength groups
6910447Snilay@cs.wisc.edu            WavelengthGroup getWavelengths() const;
7010447Snilay@cs.wisc.edu            // Returns whether the node is expecting a set of wavelengths
7110447Snilay@cs.wisc.edu            bool isExpected(const WavelengthGroup& wavelengths_) const;
7210447Snilay@cs.wisc.edu
7310447Snilay@cs.wisc.edu            // Trace wavelengths, find and put all found lasers, modulators, and detectors
7410447Snilay@cs.wisc.edu            //virtual void traceWavelengths(const WavelengthGroup& wavelengths_, OpticalNode* laser_,
7510447Snilay@cs.wisc.edu            //    OpticalNode* modulator_, DetectorTable* detectors_, double current_loss_) const;
7610447Snilay@cs.wisc.edu
7710447Snilay@cs.wisc.edu            //-----------------------------------------------------------------
7810447Snilay@cs.wisc.edu            // Node variables for wavelength tracing
7910447Snilay@cs.wisc.edu            //-----------------------------------------------------------------
8010447Snilay@cs.wisc.edu            // Loss incurred at this optical node
8110447Snilay@cs.wisc.edu            void setLoss(double loss_);
8210447Snilay@cs.wisc.edu            double getLoss() const;
8310447Snilay@cs.wisc.edu            // Visited number marker
8410447Snilay@cs.wisc.edu            void setVisitedNum(int visited_num_);
8510447Snilay@cs.wisc.edu            int getVisitedNum() const;
8610447Snilay@cs.wisc.edu            //-----------------------------------------------------------------
8710447Snilay@cs.wisc.edu
8810447Snilay@cs.wisc.edu
8910447Snilay@cs.wisc.edu        private:
9010447Snilay@cs.wisc.edu            // Disable copy constructor
9110447Snilay@cs.wisc.edu            OpticalNode(const OpticalNode& node_);
9210447Snilay@cs.wisc.edu
9310447Snilay@cs.wisc.edu        private:
9410447Snilay@cs.wisc.edu            // The type of optical node
9510447Snilay@cs.wisc.edu            const Type m_type_;
9610447Snilay@cs.wisc.edu            // Name of this instance
9710447Snilay@cs.wisc.edu            String m_instance_name_;
9810447Snilay@cs.wisc.edu            // A pointer to the model that contains this node
9910447Snilay@cs.wisc.edu            OpticalModel* m_model_;
10010447Snilay@cs.wisc.edu            // Downstream optical node
10110447Snilay@cs.wisc.edu            vector<OpticalNode*>* m_downstream_nodes_;
10210447Snilay@cs.wisc.edu            // Path visited count (so that you don't have to clear it)
10310447Snilay@cs.wisc.edu            int m_visited_num_;
10410447Snilay@cs.wisc.edu            // The amount of loss incurred at this optical node
10510447Snilay@cs.wisc.edu            double m_loss_;
10610447Snilay@cs.wisc.edu            // The wavelengths this optical node is supposed to see
10710447Snilay@cs.wisc.edu            const WavelengthGroup m_wavelengths_;
10810447Snilay@cs.wisc.edu    };
10910447Snilay@cs.wisc.edu
11010447Snilay@cs.wisc.edu} // namespace DSENT
11110447Snilay@cs.wisc.edu
11210447Snilay@cs.wisc.edu#endif // __DSENT_MODEL_OPTICALGRAPH_OPTICALNODE_H__
11310447Snilay@cs.wisc.edu
114