Skip to content

Version 1.0.4

Compare
Choose a tag to compare
@bpe2 bpe2 released this 03 May 17:35
· 26 commits to master since this release
v1.0.4
beaf168

Overview

This is the official release of version 1.0.4 for the NetSimulyzer ns-3 module, which corresponds with the release of version 1.04 of the application

Changes

  • Granularity down to the nanosecond for all events & durations (previously only milliseconds)
  • Added MotionTrailColor to NodeConfiguration, to manually set the color of the motion trail in the application.
  • Added a method to the NodeConfiguration to indicate a transmission of some kind has occurred. This is displayed as a 'bubble' animation in the application. The duration of the animation, the size of the bubble, and the color are configurable per animation. Call the method below to trigger the animation
void NodeConfiguration::Transmit (Time duration, double targetSize, Color3 color = GRAY_30)
  • CMake is now supported as a build system (Waf still is too)
  • Added KeepRatio, Width, & Depth attributes to NodeConfiguration & Decoration
  • Width, Depth function like Height, they allow for scaling the 3D model in ns-3 units
  • KeepRatio,  If set to true (the default) makes sure when your models are scaled, they maintain their aspect ratio, so they do not appear stretched. Set this attribute to false to disable this check
  • Also added the ScaleAxes attribute  to Decoration & NodeConfiguration. This allows for specifying a fixed scale multiplier for each axis (in x, y, z order)
  • The COLOR_PALETTE constant, a std::vector of all the colors, was added to color-palette.h

Updating

Deprecations

The TimeStep attribute for the Orchestrator has been replaced by the SetTimeStep() method. To upgrade, replace this:

orchestrator->SetAttribute ("TimeStep", OptionalValue<int>(10));

with this

orchestrator->SetTimeStep (MilliSeconds (10), Time::MS);

Clone

If you originally installed the module by cloning it, you may update to version 1.0.4 by doing the following:

  1. cd into the module directory (either in contrib/ or src)
cd netsimulyzer
  1. Run git fetch.
git fetch
  1. Run git checkout with the tag of the version you're upgrading to (v1.0.4 in this case)
git checkout v1.0.4

ZIP

To update a ZIP installation, you'll have to delete it and replace it with the new version

# From the ns-3 root
# may be 'src' as well, depending on your installation
cd contrb
rm -Rf netsimulyzer

#use this command or download manually
wget https://github.com/usnistgov/NetSimulyzer-ns3-module/archive/refs/tags/v1.0.4.zip -O NetSimulyzer-ns3-module-master.zip
unzip NetSimulyzer-ns3-module-master.zip

# Make sure the directory in the ns-3 contrib/ directory is
# named `netsimulyzer`
mv NetSimulyzer-ns3-module-1.0. netsimulyzer