~ubuntu-branches/ubuntu/quantal/ns3/quantal

« back to all changes in this revision

Viewing changes to ns-3.12.1/src/spectrum/model/spectrum-propagation-loss-model.h

  • Committer: Package Import Robot
  • Author(s): YunQiang Su, Aron Xu, YunQiang Su, Upstream
  • Date: 2012-01-06 00:35:42 UTC
  • mfrom: (10.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20120106003542-vcn5g03mhapm991h
Tags: 3.13+dfsg-1
[ Aron Xu ]:
        add tag binary and binary-indep, 
  for not build doc when --binary-arch (Closes: #654493).
[ YunQiang Su ]
        add waf 1.5/1.6 source to debian directory, 
  and build waf from there (Closes: #642217).
[ Upstream ]
  Successfully link with --as-needed option (Closes: #642225).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2
 
/*
3
 
 * Copyright (c) 2009 CTTC
4
 
 *
5
 
 * This program is free software; you can redistribute it and/or modify
6
 
 * it under the terms of the GNU General Public License version 2 as
7
 
 * published by the Free Software Foundation;
8
 
 *
9
 
 * This program is distributed in the hope that it will be useful,
10
 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
 
 * GNU General Public License for more details.
13
 
 *
14
 
 * You should have received a copy of the GNU General Public License
15
 
 * along with this program; if not, write to the Free Software
16
 
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
 
 *
18
 
 * Author: Nicola Baldo <nbaldo@cttc.es>
19
 
 */
20
 
 
21
 
#ifndef SPECTRUM_PROPAGATION_LOSS_MODEL_H
22
 
#define SPECTRUM_PROPAGATION_LOSS_MODEL_H
23
 
 
24
 
 
25
 
#include <ns3/object.h>
26
 
#include <ns3/mobility-model.h>
27
 
#include <ns3/spectrum-value.h>
28
 
 
29
 
namespace ns3 {
30
 
 
31
 
 
32
 
 
33
 
 
34
 
/**
35
 
 * \ingroup spectrum
36
 
 *
37
 
 * \brief spectrum-aware propagation loss model
38
 
 *
39
 
 * Interface for propagation loss models to be adopted when
40
 
 * transmissions are modeled with a power spectral density by means of
41
 
 * the SpectrumValue class.
42
 
 *
43
 
 */
44
 
class SpectrumPropagationLossModel : public Object
45
 
{
46
 
public:
47
 
  SpectrumPropagationLossModel ();
48
 
  virtual ~SpectrumPropagationLossModel ();
49
 
 
50
 
  static TypeId GetTypeId ();
51
 
 
52
 
 
53
 
  /**
54
 
   * used to chain various instances of SpectrumPropagationLossModel
55
 
   *
56
 
   * @param next
57
 
   */
58
 
  void SetNext (Ptr<SpectrumPropagationLossModel> next);
59
 
 
60
 
  /**
61
 
   * This method is to be called to calculate
62
 
   *
63
 
   * @param txPsd the SpectrumValue representing the power spectral
64
 
   * density of the transmission. Watt units are to be used for radio
65
 
   * communications, and Pascal units for acoustic communications
66
 
   * (e.g. underwater).
67
 
   *
68
 
   * @param a sender mobility
69
 
   * @param b receiver mobility
70
 
   *
71
 
   * @return set of values vs frequency representing the received
72
 
   * power in the same units used for the txPower parameter.
73
 
   */
74
 
  Ptr<SpectrumValue> CalcRxPowerSpectralDensity (Ptr<const SpectrumValue> txPsd,
75
 
                                                 Ptr<const MobilityModel> a,
76
 
                                                 Ptr<const MobilityModel> b) const;
77
 
 
78
 
protected:
79
 
  virtual void DoDispose ();
80
 
 
81
 
 
82
 
private:
83
 
  /**
84
 
   *
85
 
   *
86
 
   * @param txPsd set of values vs frequency representing the
87
 
   * transmission power. See SpectrumChannel for details.
88
 
   * @param a sender mobility
89
 
   * @param b receiver mobility
90
 
   *
91
 
   * @return set of values vs frequency representing the received
92
 
   * power in the same units used for the txPower parameter.
93
 
   */
94
 
  virtual Ptr<SpectrumValue> DoCalcRxPowerSpectralDensity (Ptr<const SpectrumValue> txPsd,
95
 
                                                           Ptr<const MobilityModel> a,
96
 
                                                           Ptr<const MobilityModel> b) const = 0;
97
 
 
98
 
  Ptr<SpectrumPropagationLossModel> m_next;
99
 
};
100
 
 
101
 
 
102
 
 
103
 
 
104
 
 
105
 
 
106
 
} // namespace ns3
107
 
 
108
 
#endif /* SPECTRUM_PROPAGATION_LOSS_MODEL_H */