From 2355ffe3c396510a182debf7c2a57d6559df942b Mon Sep 17 00:00:00 2001
From: afreimann <65560532+afreimann@users.noreply.github.com>
Date: Fri, 9 Feb 2024 12:54:59 +0100
Subject: [PATCH] updated repo to estnet v1.0
This commit updates the Github repository to the latest version of ESTNeT
---
.cproject | 373 ++++++---
.gitignore | 10 +-
.gitlab-ci.yml | 44 +
.nedfolders | 1 +
README.md | 10 -
data/UWEModel.STL | Bin 0 -> 2069234 bytes
data/a_b_raindrop_attenuation.csv | 42 +
data/blueMarble.earth | 7 +
data/blueMarble.jpg | Bin 0 -> 2383580 bytes
data/earthObstacle.xml | 4 +
data/noisemaps/noise_model_437_2MHz.dat | 103 +++
data/osm.earth | 9 +
data/walker_o6_s3_i45_h698.tle | 54 ++
examples/datageneration/omnetpp.ini | 156 ++++
examples/errormodel/omnetpp.ini | 117 +++
examples/orbitpropagation/omnetpp.ini | 70 ++
examples/package.ned | 22 +
examples/pathloss/omnetpp.ini | 112 +++
examples/powermodel/omnetpp.ini | 130 +++
examples/protocol/omnetpp.ini | 89 ++
examples/visualization/omnetpp.ini | 93 +++
figures/estnet_diagram.png | Bin 287291 -> 0 bytes
.../AxiallySymmetricAntennaExtraStatistics.h | 2 +-
...AxiallySymmetricAntennaExtraStatistics.ned | 2 +-
src/estnet/antenna/base/AntennaMobility.cc | 85 --
.../base/ScalarAnalogModelAntennaFix.cc | 167 ----
.../base/ScalarAnalogModelAntennaFix.h | 54 --
.../antenna/base/ThreeDbBeamwidthAntenna.cc | 8 +-
.../antenna/base/ThreeDbBeamwidthAntenna.h | 13 +-
.../antenna/base/ThreeDbBeamwidthAntenna.ned | 8 +-
.../contactplan/OmnidirectionalAntennaCpr.cc | 14 +-
.../contactplan/OmnidirectionalAntennaCpr.h | 7 +
.../contactplan/OmnidirectionalAntennaCpr.ned | 6 +-
src/estnet/application/common/AppHeader.msg | 4 +
.../application/common/AppHeaderSerializer.h | 2 +-
src/estnet/application/common/AppHost.h | 6 +
.../application/common/AppHostHeader.msg | 4 +
.../common/AppHostHeaderSerializer.h | 2 +-
.../application/common/DestNodeIdTag.msg | 3 +
.../application/common/SrcNodeIdTag.msg | 3 +
src/estnet/application/contract/IApp.h | 2 +-
.../application/contract/IPositionData.h | 4 +
.../positionbased/PositionBasedApp.ned | 2 +-
.../positionbased/common/AISDataLoader.h | 6 +
.../common/GeoCoordinateDataHandler.h | 4 +
.../common/MemorizedDataHandler.cc | 73 +-
.../common/MemorizedDataHandler.h | 8 +
.../attitudecontroller/AttitudeController.h | 4 +-
src/estnet/common/AddressUtils.cc | 3 +
src/estnet/common/AddressUtils.h | 3 +
src/estnet/common/ByteHelper.cc | 3 +
src/estnet/common/ByteHelpers.h | 3 +
src/estnet/common/CustomResultFilters.cc | 39 +-
src/estnet/common/CustomResultFilters.h | 15 +
src/estnet/common/DirUtils.h | 3 +
src/estnet/common/ESTNETDefs.h | 4 +-
src/estnet/common/ESTNETDefs.msg | 9 +-
src/estnet/common/OmnetUtils.cc | 5 +-
src/estnet/common/OmnetUtils.h | 5 +-
src/estnet/common/StrUtil.cc | 27 +
src/estnet/common/StrUtil.h | 52 ++
.../SphericalBilinearInterpolation.cc | 147 ++++
.../SphericalBilinearInterpolation.h | 62 ++
.../multivariate-splines/LICENSE | 373 +++++++++
.../multivariate-splines/bspline.cc | 519 ++++++++++++
.../multivariate-splines/bspline.h | 110 +++
.../multivariate-splines/bsplinebasis.cc | 427 ++++++++++
.../multivariate-splines/bsplinebasis.h | 71 ++
.../multivariate-splines/bsplinebasis1d.cc | 764 ++++++++++++++++++
.../multivariate-splines/bsplinebasis1d.h | 94 +++
.../multivariate-splines/datasample.cc | 78 ++
.../multivariate-splines/datasample.h | 47 ++
.../multivariate-splines/datatable.cc | 385 +++++++++
.../multivariate-splines/datatable.h | 117 +++
.../multivariate-splines/generaldefinitions.h | 57 ++
.../multivariate-splines/linearsolvers.h | 148 ++++
.../mykroneckerproduct.cc | 96 +++
.../multivariate-splines/mykroneckerproduct.h | 23 +
.../multivariate-splines/pspline.cc | 300 +++++++
.../multivariate-splines/pspline.h | 44 +
.../multivariate-splines/rbfspline.cc | 334 ++++++++
.../multivariate-splines/rbfspline.h | 242 ++++++
.../multivariate-splines/spline.h | 46 ++
src/estnet/common/matrix/Matrix.h | 2 +-
.../common/matrix/eigen/KroneckerProduct | 36 +
.../KroneckerProduct/KroneckerTensorProduct.h | 305 +++++++
src/estnet/common/node/NodeRegistry.cc | 3 +
src/estnet/common/node/NodeRegistry.h | 3 +
src/estnet/common/node/NodeRegistry.ned | 3 +
src/estnet/common/time/GlobalJulianDate.cc | 85 +-
src/estnet/common/time/GlobalJulianDate.h | 12 +-
src/estnet/common/time/GlobalJulianDate.ned | 16 +-
.../contactplan/ContactPlanCreatingApp.cc | 6 +-
.../contactplan/ContactPlanCreatingApp.ned | 2 +-
.../ContactPlanCreatingRadioMedium.cc | 287 ++++---
.../ContactPlanCreatingRadioMedium.h | 15 +-
.../ContactPlanCreatingRadioMedium.ned | 11 +-
.../contactplan/ContactPlanVisualizer.cc | 65 +-
.../contactplan/ContactPlanVisualizer.ned | 4 +-
.../contactplan/common/ContactPlanManager.cc | 2 +-
.../contactplan/common/ContactPlanManager.h | 2 +-
src/estnet/contactplan/common/Contacts.h | 7 +-
.../contactplan/common/KDTreeAdapter.cc | 169 ++++
src/estnet/contactplan/common/KDTreeAdapter.h | 145 +---
.../atmosphere/Atmosphere.cc} | 27 +-
.../atmosphere/Atmosphere.h} | 24 +-
.../atmosphere/Atmosphere.ned} | 14 +-
.../atmosphere/SimpleWeatherModel.cc | 129 +++
.../atmosphere/SimpleWeatherModel.h | 76 ++
.../atmosphere/SimpleWeatherModel.ned | 33 +
src/estnet/environment/contract/IAtmosphere.h | 40 +
.../environment/contract/IAtmosphere.ned | 24 +
.../environment/contract/IEarthModel.cc | 46 +-
src/estnet/environment/contract/IEarthModel.h | 32 +-
.../environment/contract/IWeatherModel.ned | 23 +
.../earthmodel/EarthModelFactory.h | 6 +
src/estnet/global_config.h | 8 +-
.../mac/ideal/IdealMacExtraStatistics.ned | 3 +-
src/estnet/mobility/base/OffsetMobility.cc | 98 +++
.../base/OffsetMobility.h} | 21 +-
.../base/OffsetMobility.ned} | 19 +-
.../mobility/contract/IExtendedMobility.cc | 69 +-
.../mobility/contract/IExtendedMobility.h | 18 +-
.../mobility/contract/IExtendedMobility.ned | 30 +
src/estnet/mobility/satellite/SatMobility.cc | 80 +-
src/estnet/mobility/satellite/SatMobility.h | 26 +-
src/estnet/mobility/satellite/SatMobility.ned | 19 +-
.../satellite/common/EulerAngleHelpers.cc | 145 +---
.../satellite/common/EulerAngleHelpers.h | 7 +-
.../satellite/common/QuaternionHelpers.cc | 32 +-
.../satellite/common/QuaternionHelpers.h | 37 +
.../satellite/contract/IAttitudePropagator.h | 69 +-
.../satellite/contract/IPositionPropagator.h | 10 +-
.../satellite/contract/IPropagatorBase.h | 4 +-
.../mobility/satellite/propagator/PropState.h | 1 +
.../attitude/AttitudePropagatorEuler.ned | 2 +-
.../attitude/AttitudePropagatorQuaternion.ned | 2 +-
.../attitude/state/PropStateAttitude.h | 3 +
.../attitude/state/PropStateEulerAngles.h | 3 +
.../attitude/state/PropStateQuaternion.h | 3 +
.../position/PositionPropagatorKepler.cc | 58 +-
.../position/PositionPropagatorKepler.h | 16 +-
.../position/PositionPropagatorKepler.ned | 10 +-
.../position/PositionPropagatorLinear.cc | 66 --
.../position/PositionPropagatorSGP4.ned | 2 +-
.../position/PositionPropagatorSGP4Base.h | 2 +-
.../position/PositionPropagatorSGP4File.ned | 2 +-
.../position/PositionPropagatorSGP4List.cc | 133 +++
...rLinear.h => PositionPropagatorSGP4List.h} | 66 +-
...ear.ned => PositionPropagatorSGP4List.ned} | 13 +-
.../terrestrial/StaticTerrestrialMobility.cc | 99 ++-
.../terrestrial/StaticTerrestrialMobility.h | 24 +-
.../terrestrial/StaticTerrestrialMobility.ned | 26 +-
src/estnet/node/base/NodeBase.cc | 4 -
.../node/contract/INetworkNodeNumbered.ned | 2 +-
.../node/errormodel/JammedPacketHandler.cc | 25 +-
.../node/errormodel/JammedPacketHandler.h | 30 +-
src/estnet/node/errormodel/JammingStation.cc | 2 +-
src/estnet/node/errormodel/JammingStation.h | 24 +
.../node/errormodel/NodeFailureModel.cc | 30 +-
src/estnet/node/errormodel/NodeFailureModel.h | 17 +-
.../node/errormodel/NodeFailureModel.ned | 2 +-
src/estnet/node/groundstation/GroundLabel.cc | 48 +-
src/estnet/node/groundstation/GroundLabel.ned | 2 +-
src/estnet/node/groundstation/GroundStation.h | 5 +
.../node/groundstation/GroundStation.ned | 1 -
src/estnet/node/satellite/Satellite.cc | 5 +-
src/estnet/node/satellite/Satellite.h | 9 +-
.../ContactPlanBasedNodeTracking.cc | 2 -
.../ContactPlanBasedNodeTracking.ned | 2 +-
.../node/tracking/contract/INodeTracking.h | 2 +-
.../node/tracking/contract/ISwipeTracking.cc | 3 -
.../swipe/ContactPlanLessSwipeTracking.cc | 112 +++
.../swipe/ContactPlanLessSwipeTracking.h | 50 ++
.../swipe/ContactPlanLessSwipeTracking.ned | 25 +
.../swipe/ExponentialSwipeTracking.cc | 8 +-
.../tracking/swipe/ExponentialSwipeTracking.h | 2 +-
.../swipe/ExponentialSwipeTracking.ned | 2 +-
.../node/tracking/target/TargetTracking.h | 16 +-
.../noise/BackgroundNoiseSelector.cc | 61 ++
.../noise/BackgroundNoiseSelector.h | 51 ++
.../noise/BackgroundNoiseSelector.ned | 36 +
.../noise/DirectionalScalarBackgroundNoise.cc | 43 +-
.../noise/DirectionalScalarBackgroundNoise.h | 14 +-
.../DirectionalScalarBackgroundNoise.ned | 4 +-
...eographicIsotropicScalarBackgroundNoise.cc | 114 +++
...GeographicIsotropicScalarBackgroundNoise.h | 52 ++
...ographicIsotropicScalarBackgroundNoise.ned | 36 +
.../noise/GroundstationBackgroundNoise.cc | 362 +++++++++
.../noise/GroundstationBackgroundNoise.h | 97 +++
.../noise/GroundstationBackgroundNoise.ned | 52 ++
.../pathloss/AtmosphericPathLoss.cc | 75 ++
.../pathloss/AtmosphericPathLoss.h | 75 ++
.../pathloss/AtmosphericPathLoss.ned | 38 +
src/estnet/power/EnergyModule.h | 1 -
.../power/base/SatelliteSolarPanelBase.cc | 13 +-
.../power/base/SatelliteSolarPanelBase.ned | 15 +-
src/estnet/power/base/SimpleSolarPanelBase.cc | 13 +-
.../power/base/SimpleSolarPanelBase.ned | 12 +-
src/estnet/power/consumer/modules/ADS.ned | 1 +
.../power/consumer/type/ConstantConsumer.h | 2 +-
.../consumer/type/TargetTrackingConsumer.cc | 19 +-
.../consumer/type/TargetTrackingConsumer.h | 18 +-
.../power/contract/IConsumerStateHandler.ned | 2 +
src/estnet/power/contract/ISolarPanel.h | 4 +-
.../power/solarpanel/CubeSatPanel_CESI.ned | 4 +-
.../base/ExternalProtocolModuleBase.cc | 29 +-
.../protocol/base/ProtocolModuleBase.cc | 8 -
src/estnet/radio/RadioHost.cc | 3 +-
src/estnet/radio/RadioHost.h | 3 +-
src/estnet/radio/RadioHost.ned | 1 +
src/estnet/radio/RadioNic.ned | 2 +-
.../apsk/APSKScalarRadioExtraStatistics.h | 9 +-
.../radio/apsk/ApskScalarReceiverCpr.cc | 3 +-
src/estnet/radio/apsk/ApskScalarReceiverCpr.h | 5 +
.../radio/errormodel/PerfectErrorModel.h | 1 +
.../radio/gmsk/APSKScalarReceiverWithGMSK.cc | 45 +-
.../radio/gmsk/APSKScalarReceiverWithGMSK.h | 12 +-
.../gmsk/APSKScalarTransmitterWithGMSK.cc | 2 +
.../gmsk/APSKScalarTransmitterWithGMSK.h | 4 +
.../ConstantSpeedPropagationWithMovement.cc | 1 -
.../ConstantSpeedPropagationWithMovement.h | 26 +-
.../radio/psk8/APSKScalarReceiverWith8PSK.cc | 17 +-
.../radio/psk8/APSKScalarReceiverWith8PSK.h | 14 +-
.../psk8/APSKScalarTransmitterWith8PSK.h | 5 +
src/estnet/siminterface/pubsub/Publisher.h | 8 +
.../siminterface/pubsub/SimplePublisher.h | 9 +
.../tcpinterface/extMessageHandler.h | 9 +
src/estnet/visualizer/OsgEarthScene.cc | 4 +-
src/estnet/visualizer/OsgEarthScene.h | 17 +
src/estnet/visualizer/OsgEarthScene.ned | 4 +-
src/estnet/visualizer/OsgNode.cc | 52 +-
src/estnet/visualizer/OsgNode.h | 5 +-
src/estnet/visualizer/OsgNode.ned | 13 +-
src/makemake | 2 +-
tests/examples/3dvis.test | 7 +
tests/examples/data | 1 +
tests/examples/datageneration_basicapp.test | 27 +
tests/examples/energy_consumption.test | 46 ++
tests/examples/energy_creation.test | 55 ++
tests/examples/errormodel_jammer.test | 14 +
tests/examples/errormodel_node_failure.test | 14 +
tests/examples/orbit_propagation_kepler.test | 7 +
tests/examples/orbit_propagation_sgp4.test | 7 +
tests/examples/pathloss_atmosperic.test | 12 +
tests/examples/pathloss_reference.test | 11 +
tests/examples/protocol.test | 11 +
tests/examples/runtests.sh | 12 +
tests/unit/runtests.sh | 5 +
...bilinear_interpolation_generic_interp.test | 22 +
...inear_interpolation_latitude_cropping.test | 39 +
...r_interpolation_longitude_periodicity.test | 42 +
...herical_bilinear_interpolation_lookup.test | 26 +
...ilinear_interpolation_midpoint_interp.test | 35 +
...al_bilinear_interpolation_simple_calc.test | 26 +
wiki/3dvis.md | 83 --
...criber-Feature-for-external-interfacing.md | 53 --
...ning-a-simulation-from-the-command-line.md | 19 -
wiki/Submitting-Code.md | 5 -
wiki/Tracking-and-Attitude-Control.md | 98 ---
wiki/creating-a-contact-plan.md | 6 -
wiki/creating-earth-map-for-offline-use.md | 10 -
wiki/ini-file-options.md | 13 -
263 files changed, 10293 insertions(+), 1844 deletions(-)
create mode 100644 .gitlab-ci.yml
create mode 100644 data/UWEModel.STL
create mode 100644 data/a_b_raindrop_attenuation.csv
create mode 100644 data/blueMarble.earth
create mode 100644 data/blueMarble.jpg
create mode 100644 data/earthObstacle.xml
create mode 100644 data/noisemaps/noise_model_437_2MHz.dat
create mode 100644 data/osm.earth
create mode 100644 data/walker_o6_s3_i45_h698.tle
create mode 100644 examples/datageneration/omnetpp.ini
create mode 100644 examples/errormodel/omnetpp.ini
create mode 100644 examples/orbitpropagation/omnetpp.ini
create mode 100644 examples/package.ned
create mode 100644 examples/pathloss/omnetpp.ini
create mode 100644 examples/powermodel/omnetpp.ini
create mode 100644 examples/protocol/omnetpp.ini
create mode 100644 examples/visualization/omnetpp.ini
delete mode 100644 figures/estnet_diagram.png
delete mode 100644 src/estnet/antenna/base/AntennaMobility.cc
delete mode 100644 src/estnet/antenna/base/ScalarAnalogModelAntennaFix.cc
delete mode 100644 src/estnet/antenna/base/ScalarAnalogModelAntennaFix.h
create mode 100644 src/estnet/common/StrUtil.cc
create mode 100644 src/estnet/common/StrUtil.h
create mode 100644 src/estnet/common/interpolation/SphericalBilinearInterpolation.cc
create mode 100644 src/estnet/common/interpolation/SphericalBilinearInterpolation.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/LICENSE
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bspline.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bspline.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bsplinebasis.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bsplinebasis.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bsplinebasis1d.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/bsplinebasis1d.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/datasample.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/datasample.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/datatable.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/datatable.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/generaldefinitions.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/linearsolvers.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/mykroneckerproduct.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/mykroneckerproduct.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/pspline.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/pspline.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/rbfspline.cc
create mode 100644 src/estnet/common/interpolation/multivariate-splines/rbfspline.h
create mode 100644 src/estnet/common/interpolation/multivariate-splines/spline.h
create mode 100644 src/estnet/common/matrix/eigen/KroneckerProduct
create mode 100644 src/estnet/common/matrix/eigen/src/KroneckerProduct/KroneckerTensorProduct.h
create mode 100644 src/estnet/contactplan/common/KDTreeAdapter.cc
rename src/estnet/{antenna/base/AntennaBaseWithOrientation.cc => environment/atmosphere/Atmosphere.cc} (61%)
rename src/estnet/{antenna/base/AntennaBaseWithOrientation.h => environment/atmosphere/Atmosphere.h} (63%)
rename src/estnet/{antenna/base/ScalarAnalogModelAntennaFix.ned => environment/atmosphere/Atmosphere.ned} (65%)
create mode 100644 src/estnet/environment/atmosphere/SimpleWeatherModel.cc
create mode 100644 src/estnet/environment/atmosphere/SimpleWeatherModel.h
create mode 100644 src/estnet/environment/atmosphere/SimpleWeatherModel.ned
create mode 100644 src/estnet/environment/contract/IAtmosphere.h
create mode 100644 src/estnet/environment/contract/IAtmosphere.ned
create mode 100644 src/estnet/environment/contract/IWeatherModel.ned
create mode 100644 src/estnet/mobility/base/OffsetMobility.cc
rename src/estnet/{antenna/base/AntennaMobility.h => mobility/base/OffsetMobility.h} (82%)
rename src/estnet/{antenna/base/AntennaBaseWithOrientation.ned => mobility/base/OffsetMobility.ned} (58%)
create mode 100644 src/estnet/mobility/contract/IExtendedMobility.ned
delete mode 100644 src/estnet/mobility/satellite/propagator/position/PositionPropagatorLinear.cc
create mode 100644 src/estnet/mobility/satellite/propagator/position/PositionPropagatorSGP4List.cc
rename src/estnet/mobility/satellite/propagator/position/{PositionPropagatorLinear.h => PositionPropagatorSGP4List.h} (51%)
rename src/estnet/mobility/satellite/propagator/position/{PositionPropagatorLinear.ned => PositionPropagatorSGP4List.ned} (69%)
create mode 100644 src/estnet/node/tracking/swipe/ContactPlanLessSwipeTracking.cc
create mode 100644 src/estnet/node/tracking/swipe/ContactPlanLessSwipeTracking.h
create mode 100644 src/estnet/node/tracking/swipe/ContactPlanLessSwipeTracking.ned
create mode 100644 src/estnet/physicallayer/noise/BackgroundNoiseSelector.cc
create mode 100644 src/estnet/physicallayer/noise/BackgroundNoiseSelector.h
create mode 100644 src/estnet/physicallayer/noise/BackgroundNoiseSelector.ned
rename src/estnet/{ => physicallayer}/noise/DirectionalScalarBackgroundNoise.cc (89%)
rename src/estnet/{ => physicallayer}/noise/DirectionalScalarBackgroundNoise.h (77%)
rename src/estnet/{ => physicallayer}/noise/DirectionalScalarBackgroundNoise.ned (93%)
create mode 100644 src/estnet/physicallayer/noise/GeographicIsotropicScalarBackgroundNoise.cc
create mode 100644 src/estnet/physicallayer/noise/GeographicIsotropicScalarBackgroundNoise.h
create mode 100644 src/estnet/physicallayer/noise/GeographicIsotropicScalarBackgroundNoise.ned
create mode 100644 src/estnet/physicallayer/noise/GroundstationBackgroundNoise.cc
create mode 100644 src/estnet/physicallayer/noise/GroundstationBackgroundNoise.h
create mode 100644 src/estnet/physicallayer/noise/GroundstationBackgroundNoise.ned
create mode 100644 src/estnet/physicallayer/pathloss/AtmosphericPathLoss.cc
create mode 100644 src/estnet/physicallayer/pathloss/AtmosphericPathLoss.h
create mode 100644 src/estnet/physicallayer/pathloss/AtmosphericPathLoss.ned
create mode 100644 tests/examples/3dvis.test
create mode 100644 tests/examples/data
create mode 100644 tests/examples/datageneration_basicapp.test
create mode 100644 tests/examples/energy_consumption.test
create mode 100644 tests/examples/energy_creation.test
create mode 100644 tests/examples/errormodel_jammer.test
create mode 100644 tests/examples/errormodel_node_failure.test
create mode 100644 tests/examples/orbit_propagation_kepler.test
create mode 100644 tests/examples/orbit_propagation_sgp4.test
create mode 100644 tests/examples/pathloss_atmosperic.test
create mode 100644 tests/examples/pathloss_reference.test
create mode 100644 tests/examples/protocol.test
create mode 100644 tests/examples/runtests.sh
create mode 100644 tests/unit/runtests.sh
create mode 100644 tests/unit/spherical_bilinear_interpolation_generic_interp.test
create mode 100644 tests/unit/spherical_bilinear_interpolation_latitude_cropping.test
create mode 100644 tests/unit/spherical_bilinear_interpolation_longitude_periodicity.test
create mode 100644 tests/unit/spherical_bilinear_interpolation_lookup.test
create mode 100644 tests/unit/spherical_bilinear_interpolation_midpoint_interp.test
create mode 100644 tests/unit/spherical_bilinear_interpolation_simple_calc.test
delete mode 100644 wiki/3dvis.md
delete mode 100644 wiki/Publisher-Subscriber-Feature-for-external-interfacing.md
delete mode 100644 wiki/Running-a-simulation-from-the-command-line.md
delete mode 100644 wiki/Submitting-Code.md
delete mode 100644 wiki/Tracking-and-Attitude-Control.md
delete mode 100644 wiki/creating-a-contact-plan.md
delete mode 100644 wiki/creating-earth-map-for-offline-use.md
delete mode 100644 wiki/ini-file-options.md
diff --git a/.cproject b/.cproject
index 589f1d9..7325293 100644
--- a/.cproject
+++ b/.cproject
@@ -1,127 +1,252 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/.gitignore b/.gitignore
index 1261c68..07f2376 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,6 +30,7 @@ precompiled_*.h.*
/tutorials/*/cache/
/tutorials/*/data/
/tutorials/wireless/html/
+/tests/work/
/tests/*/work/
/tests/*/*/work/
/tests/*/results*/
@@ -71,7 +72,7 @@ out/
.cmdenv-log
netanim-trace.txt
*.out
-#contact plan tools for linux users
+# contact plan tools, only applies to unix os
contactplan/ContactGraphEval
contactplan/ContactPlanPostProcessor
contactplan/IndependentSetsCreator
@@ -86,4 +87,9 @@ backups
*~
xxx
/tmp/
-*.tmp*
\ No newline at end of file
+*.tmp*
+
+# workspace config files
+.vscode/
+*.code-workspace
+
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
new file mode 100644
index 0000000..4a54730
--- /dev/null
+++ b/.gitlab-ci.yml
@@ -0,0 +1,44 @@
+default:
+ image: $CI_REGISTRY/$CI_PROJECT_NAMESPACE/estnet_docker/archlinux/opp-estnet-headless
+
+stages:
+ - build
+ - test
+
+build_release:
+ stage: build
+ cache:
+ policy: push
+ paths:
+ - src/Makefile
+ - src/libESTNeT.so
+ - src/libESTNeT_dbg.so
+ - out
+ script:
+ - cd src && INET4_PROJ=/workspace/inet4 ./makemake
+ - make MODE=release
+
+test_examples:
+ stage: test
+ cache:
+ policy: pull
+ paths:
+ - src/Makefile
+ - src/libESTNeT.so
+ - src/libESTNeT_dbg.so
+ - out
+ script:
+ - env -C tests/examples ./runtests.sh
+ - env -C examples/orbitpropagation opp_run -u Cmdenv -c Kepler -n '../../src/estnet;/workspace/inet4/src' -l ../../out/gcc-release/src/ESTNeT
+
+test_non_opp:
+ stage: test
+ cache:
+ policy: pull
+ paths:
+ - src/Makefile
+ - src/libESTNeT.so
+ - src/libESTNeT_dbg.so
+ - out
+ script:
+ - env -C tests/unit ./runtests.sh
\ No newline at end of file
diff --git a/.nedfolders b/.nedfolders
index 85de9cf..0022606 100644
--- a/.nedfolders
+++ b/.nedfolders
@@ -1 +1,2 @@
+examples
src
diff --git a/README.md b/README.md
index b75164b..dbeb47d 100644
--- a/README.md
+++ b/README.md
@@ -8,19 +8,9 @@ Further information on ESTNeT can be found in the following paper: https://doi.o
If you use ESTNeT for publications please cite this paper.
-
-
# Getting started
Guidelines for the installation of ESTNeT can be found in the file **[INSTALL.md](INSTALL.md)**
A template project is provided [here](https://github.com/estnet-framework/estnet-template) to simplify the use of ESTNeT as a library.
-
-# User guidelines:
-- [Running a simulation from the command line](wiki/Running-a-simulation-from-the-command-line.md)
-- [Creating a contact plan](wiki/creating-a-contact-plan.md)
-- [ini file options](wiki/ini-file-options.md)
-- [Creating earth map for offline use](wiki/creating-earth-map-for-offline-use.md)
-- [Publisher Subscriber](wiki/Publisher-Subscriber-Feature-for-external-interfacing.md)
-- [Submitting Code](wiki/Submitting-Code.md)
diff --git a/data/UWEModel.STL b/data/UWEModel.STL
new file mode 100644
index 0000000000000000000000000000000000000000..3383e4cfe5b47e35e9bfebf5c639cfb12c4b0b65
GIT binary patch
literal 2069234
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