major restructuring
[charm.git] / doc / bignetsim / bignetsim.tex
index f94cdea8865e53012f1a64301752a762f4a88eaf..1b58228bed1a91bb3bb536334339b6297fbf2d78 100644 (file)
@@ -1,38 +1,3 @@
-\section{BigSim Network Simulator}
-\label{bignetsim}
-
-The BigSim Network Simulator is also known as Bigsimulator and lives 
-in the SVN repository https://charm.cs.uiuc.edu/svn/repos/BigNetSim. 
-The Network simulator is actually more of an Inter-connection network 
-simulator and hence more important in the context of large parallel
-machines with interconnects. 
-The BigSim simulator  along with the network simulator is together 
-also known as BigNetSim.
-
-Both the simulators run on top of the POSE framework, which is a Parallel
-Discrete Event Simulation framework built on top of \charmpp{}.
-
-
-\subsection{What does this software do?}
-BigNetSim is an effort to simulate large current and future computer 
-systems to study the behavior of applications developed for those systems. 
-BigNetSim could be used to study
-\begin{itemize}
-\item  new types of interconnection topologies and routing algorithms 
-along with different types of switching architecture.
-\item application performance on different machines. This uses the API
-provided in Section \ref{bgapi} to run the application on some number
-of processors on some machine and generate (dump) all events (entry
-method executions or message send/recv).  BigNetSim is used to 
-model the machine that needs to be studied for this application and
-these logs are then fed into this simulation, and it predicts the
-performance of this application.
-\end{itemize}
-
-So, the two important uses are studying {\it interconnection networks} and
-{\it performance prediction for applications}.
-
-
 \subsection{BigNetSim Design and Internals}
 \begin{figure}[!t]
 \centering  
@@ -183,85 +148,3 @@ can choose among them. Each should implement the following function.
 \desc{Returns the output virtual channel to be used depending on the strategy and
 the input parameters.}
 
-
-\subsection{Which Interconnection networks are implemented?}
-A large number of topologies and routing strategies are implemented in the
-software. Here, we present a list of interconnection networks. For a complete
-list of routing strategies, input/output VC selectors, refer to the
-corresponding directories in the software.
-
-\begin{itemize}
-\item HyperCube
-\item FatTree
-\item DenseGraph
-\item Three dimensional Mesh
-\item K-ary-N-cube
-\item K-ary-N-fly
-\item K-ary-N-mesh
-\item K-ary-N-tree
-\item N-mesh
-\item Hybrid of Fattree and Dense Graph
-\item Hybrid of Fattree and HyperCube
-\end{itemize}
-
-
-\subsection{Using the software}
-
-BigNetSim has 2 major modes.  
-
-\begin{itemize}
-\item{ Trace based traffic simulation }
-\item{Artificial traffic generation based simulation.
-The mode of the simulator is governed by the $USE\_TRANSCEIVER$ parameter
-in the netconfig file.  When set to 0, trace based simulation is used,
-when set to 1, traffic generation is used.}
-\end{itemize}
-
-Trace based simulation.  This is used to study target application performance,
-or detailed network performance when loaded by a specific application.
-
-There are two command line parameters for traced based simulation.
-\begin{alltt}./bigsimulator arg1 arg2\end{alltt}
-\begin{alltt}
-       arg1 = 0 => Latency only mode
-              1 => Detailed contention model
-       arg2 = N => starts execution at the time marked by skip point N (0 is start) 
-\end{alltt}
-
-Artificial traffic generation based simulation is use to study the performance
-of interconnects under standard network load schemes.
-
-
-\begin{alltt}./bigsimulator arg1 arg2 arg3 arg4 arg5 arg6\end{alltt}
-example
-\begin{alltt}./bigsimulator 1 2 3 100 2031 0.1\end{alltt}
-
-\begin{alltt}
-       arg1 = 0 => Latency only mode
-              1 => Detailed contention model
-       arg2 = 1 => deterministic traffic
-              2 => poisson traffic
-       arg3 = 1 => KSHIFT 
-              2 => RING 
-              3 => BITTRANSPOSE 
-              4 => BITREVERSAL 
-              5 => BITCOMPLEMENT 
-              6 => UNIFORM\_DISTRIBUTION 
-       arg4 = number of packets
-       arg5 = message size
-       arg6 = load factor
-\end{alltt}
-
-\subsection{Build your own Interconnection network}
-To build a new interconnection network, one has to create a new directory for
-that interconnection network and then create the routing strategy, topology,
-input virtual channel selection and output virtual channel selection strategies
-for that network. If existing strategies could be used, then reuse them, but if
-new ones are required, one has to write these new strategies in the
-corresponding directories for routing, topology, etc.
-
-The InitNetwork function must be provided in InitNetwork.C for this new
-interconnection network. It builds up all the nodes and switches and NICs and
-channels that form the network. Look at one of the existing interconnection
-topologies for reference.
-