music_rate_out_proxy.h

Go to the documentation of this file.

/*
 *  music_rate_out_proxy.h
 *
 *  This file is part of NEST.
 *
 *  Copyright (C) 2004 The NEST Initiative
 *
 *  NEST is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  NEST is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with NEST.  If not, see <http://www.gnu.org/licenses/>.
 *
 */
 
#ifndef MUSIC_RATE_OUT_PROXY_H
#define MUSIC_RATE_OUT_PROXY_H
 
// Generated includes:
#include "config.h"
 
#ifdef HAVE_MUSIC
 
// C++ includes:
#include <vector>
 
// External includes:
#include <music.hh>
 
// Includes from nestkernel:
#include "device_node.h"
#include "event.h"
#include "exceptions.h"
#include "nest_types.h"
#include "node.h"
 
/* BeginUserDocs: device, rate, MUSIC
 
Short description
+++++++++++++++++
 
Device to forward rates to remote applications using MUSIC
 
Description
+++++++++++
 
A ``music_rate_out_proxy`` is used to send rates to a remote application that
also uses MUSIC.
 
The ``music_rate_out_proxy`` represents a complete MUSIC rate output
port. The channel on the port to which a source node forwards its
events is determined during connection setup by using the parameter
``music_channel`` of the connection. The name of the port is set via
``SetStatus`` (see Parameters section below).
 
Parameters
++++++++++
 
The following properties are available in the status Dictionary:
 
port_name    - The name of the MUSIC output_port to forward events to (default: `rate_out`)
 
port_width   - The width of the MUSIC input port
 
published    - A bool indicating if the port has been already published with MUSIC
 
The parameter port_name can be set using ``SetStatus``.
 
Availability: Only when compiled with MUSIC
 
See also
++++++++
 
music_rate_in_proxy, music_cont_out_proxy
 
Examples using this model
+++++++++++++++++++++++++
 
.. listexamples:: music_rate_out_proxy
 
EndUserDocs */
 
namespace nest
{
void register_music_rate_out_proxy( const std::string& name );
 
class music_rate_out_proxy : public DeviceNode
{
 
public:
  music_rate_out_proxy();
  music_rate_out_proxy( const music_rate_out_proxy& );
  ~music_rate_out_proxy();
 
  bool
  has_proxies() const
  {
    return false;
  }
  bool
  local_receiver() const
  {
    return true;
  }
  bool
  one_node_per_process() const
  {
    return true;
  }
 
  using Node::handle;
  using Node::handles_test_event;
 
  void handle( InstantaneousRateConnectionEvent& );
 
  size_t handles_test_event( InstantaneousRateConnectionEvent&, size_t );
 
  void get_status( Dictionary& ) const;
  void set_status( const Dictionary& );
 
private:
  void init_buffers_();
  void pre_run_hook();
 
  void
  update( Time const&, const long, const long )
  {
  }
 
  // ------------------------------------------------------------
 
  struct State_;
 
  struct Parameters_
  {
    std::string port_name_;  
 
    Parameters_();  
 
    void get( Dictionary& ) const;           
    void set( const Dictionary&, State_& );  
  };
 
  // ------------------------------------------------------------
 
  struct State_
  {
    bool published_;  
    int port_width_;  
 
    State_();  
 
    void get( Dictionary& ) const;  
    void set( const Dictionary&, const Parameters_& );
  };
 
  // ------------------------------------------------------------
 
  struct Variables_
  {
    MUSIC::ContOutputPort* MP_;  
    std::vector< MUSIC::GlobalIndex > index_map_;
  };
 
  struct Buffers_
  {
    Buffers_();                   
    Buffers_( const Buffers_& );  
    std::vector< double > data_;  
  };
 
  // ------------------------------------------------------------
 
  Parameters_ P_;
  State_ S_;
  Variables_ V_;
  Buffers_ B_;
};
 
inline size_t
music_rate_out_proxy::handles_test_event( InstantaneousRateConnectionEvent&, size_t receptor_type )
{
  // receptor_type i is mapped to channel i of the MUSIC port so we
  // have to generate the index map here, that assigns the channel
  // number to the local index of this connection the local index
  // equals the number of connection
 
  if ( not S_.published_ )
  {
    V_.index_map_.push_back( static_cast< int >( receptor_type ) );
  }
  else
  {
    throw MUSICPortAlreadyPublished( "", P_.port_name_ );
  }
 
  return receptor_type;
}
 
}  // namespace
 
#endif /* HAVE_MUSIC */
 
#endif