Version 1.0.4
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
toNodeConfiguration
, 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 toNodeConfiguration
&Decoration
Width
,Depth
function likeHeight
, they allow for scaling the 3D model in ns-3 unitsKeepRatio
, If set totrue
(the default) makes sure when your models are scaled, they maintain their aspect ratio, so they do not appear stretched. Set this attribute tofalse
to disable this check- Also added the
ScaleAxes
attribute toDecoration
&NodeConfiguration
. This allows for specifying a fixed scale multiplier for each axis (in x, y, z order) - The
COLOR_PALETTE
constant, astd::vector
of all the colors, was added tocolor-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:
cd
into the module directory (either incontrib/
orsrc
)
cd netsimulyzer
- Run
git fetch
.
git fetch
- 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