Blood Voyager Simulator for Network

Existing code:https://github.com/RegineWendt/blood-voyager-sRegine Wendt <wendt@itm.uni-luebeck.de>v1.1, 2019-04-24

BVS is a ns-3 module that simulates the global movement of objects in the human body. It’s main purpose is to model the work environment of medical nanobots. The simulation of nanobots in their working environment is crucial to promote their application in the medical context. Several simulators for nanonetworks investigate new communication paradigms at nanoscale. However, the influence of the environment, namely the human body, on the movement and communication of nanobots was rarely considered so far. Currently there are three open-source nanonetwork ns-3 extension, namelyNanoSim,p1906 andTeraSim that are readily usable. We propose the combination of one of those, or your own nanonetwork simulators with BVS. Our simulator is in a prototypical state at the moment and we’re consistently working on it’s development. At the moment it features a simplified model of a human body’s cardiovascular system to simulate the nanobots’ mobility. Feel free to use BVS and contact us for any remark or contribute to our code. Be sure to have also read our paper describing it.

BVS v2.1 introduces the possibility to model the communication channel, between the nanobots and the gateways, which would in real apllications be situated at the skin level and is in simulation a synthetic data generator for database usage. The mobility model is left unchanged, but we added multiple modules to measure, transmit and receive data.

If you are looking for a way to visualize the mobility part of the simulation results please visit the extended github for BVS-VIS.

• Models a terahertz channel transmission between nanobots and gateway

• Outputs the received packages into a csv file (gateway.csv)

• Calculates the bit error and package error rate per transmission (gateway_ber.csv)

• Possibility to have a single run or a multi parameter sweep with respect to tissue thickness.

• 3D coordinates of major vessels and organs

• Simulates permanent movement of nanobots in cardiovascular system

• Injection of nanobots in specific vessels

• Provides global position data of nanobots (/ns-3.2x/csvNano.csv)

• easy data analysis with provided MATLAB files

• tissue thickness

• Size of symbols of one transmitted package: TESTPACKETSIZE 200

• transmission frequency: FREQ_THZ 0.5*10^12

• initial distance between nanobot and gateway: DIST_INIT 850*10^-6

• initial thickness of skin: SKIN_THICKNESS 76*10^-6

• initial thickness of blood vessel: VESSEL_THICKNESS 200*10^-6

• initial transmit power: POWER 4*10^3

• structure of output packet: — struct MAC_PHY_DATA

  int nanobot_ID; // ID of nanobot

  int tissue_ID; // ID of body part where to measure

  vector<int> PDU_TX; // Bit stream of measurement data at nanobot

  vector<double> SEQ_TX; // Amplitude stream of measurement data send at nanobot

  vector<double> SEQ_RX; // Amplitude stream of measurement data received at gateway

  vector<int> PDU_RX; // decoded bit stream of measurement data at gateway

• Number of nanobotsm_numberOfNanobots

• Injection vesselm_injectionVessel [1-94]

• Simulation duration in secondsm_simulationDuration

• Duration between each simulation stepm_deltaT

• Velocities:m_arteryVelocity = 10 cm/s, m_veinVelocity = 3,7 cm/s, m_organVelocity = 1cm/s

• Number of streamsm_numberOfStreams [1-5]

• Windows: Visual Studio Code and WSL

• Mac: Visual Studio Code

• Linux: Visual Studio Code

The simulation returns:- a csv-file (/ns-3.40/csvNano.csv) with the position data of the simulated nanobots in every timestep.- a csv-file (/ns-3.40/gateway.csv) with the transmitted data of the simulated nanobots.- a csv-file (/ns-3.40/gateway_ber.csv) with the calcualted ber and per of the simulated nanobots.