Skip to content
Snippets Groups Projects
Commit f3205e12 authored by Brutzman, Don's avatar Brutzman, Don
Browse files

javadoc, clear warnings

parent c31388df
No related branches found
No related tags found
No related merge requests found
Showing
with 86 additions and 36 deletions
...@@ -8,7 +8,7 @@ import simkit.random.RandomVariate; ...@@ -8,7 +8,7 @@ import simkit.random.RandomVariate;
* events is scheduled based on an inter arrival time random variate. The state * events is scheduled based on an inter arrival time random variate. The state
* variable, simply counts the number of these arrivals. * variable, simply counts the number of these arrivals.
* *
* @author ahbuss * @author abuss@nps.edu
*/ */
public class ArrivalProcess extends SimEntityBase { public class ArrivalProcess extends SimEntityBase {
...@@ -72,6 +72,7 @@ public class ArrivalProcess extends SimEntityBase { ...@@ -72,6 +72,7 @@ public class ArrivalProcess extends SimEntityBase {
} }
/** /**
* accessor method to get a state variable
* @return the interarrivalTimeGenerator * @return the interarrivalTimeGenerator
*/ */
public RandomVariate getInterarrivalTimeGenerator() { public RandomVariate getInterarrivalTimeGenerator() {
...@@ -79,6 +80,7 @@ public class ArrivalProcess extends SimEntityBase { ...@@ -79,6 +80,7 @@ public class ArrivalProcess extends SimEntityBase {
} }
/** /**
* accessor method to set a state variable
* @param interarrivalTimeGenerator the interarrivalTimeGenerator to set * @param interarrivalTimeGenerator the interarrivalTimeGenerator to set
*/ */
public void setInterarrivalTimeGenerator(RandomVariate interarrivalTimeGenerator) { public void setInterarrivalTimeGenerator(RandomVariate interarrivalTimeGenerator) {
...@@ -86,6 +88,7 @@ public class ArrivalProcess extends SimEntityBase { ...@@ -86,6 +88,7 @@ public class ArrivalProcess extends SimEntityBase {
} }
/** /**
* accessor method to get a state variable
* @return the numberArrivals * @return the numberArrivals
*/ */
public int getNumberArrivals() { public int getNumberArrivals() {
......
...@@ -14,7 +14,7 @@ import simkit.random.RandomVariate; ...@@ -14,7 +14,7 @@ import simkit.random.RandomVariate;
* @see SimkitOpenDis7Examples.SimpleServer * @see SimkitOpenDis7Examples.SimpleServer
* @see SimkitOpenDis7Examples.run.RunSimpleServerOpenDis7 * @see SimkitOpenDis7Examples.run.RunSimpleServerOpenDis7
* @see <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/raw/master/examples/src/SimkitOpenDis7Examples/documentation/ArrivalProcessDisPdu.png">ArrivalProcessDisPdu.png</a> * @see <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/raw/master/examples/src/SimkitOpenDis7Examples/documentation/ArrivalProcessDisPdu.png">ArrivalProcessDisPdu.png</a>
* @author ahbuss * @author abuss@nps.edu
* @author brutzman * @author brutzman
*/ */
public class ArrivalProcessOpenDis7 extends SimEntityBase { public class ArrivalProcessOpenDis7 extends SimEntityBase {
...@@ -98,6 +98,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase { ...@@ -98,6 +98,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase {
} }
/** /**
* accessor method to get a state variable
* @return the interarrivalTimeGenerator * @return the interarrivalTimeGenerator
*/ */
public RandomVariate getInterarrivalTimeGenerator() { public RandomVariate getInterarrivalTimeGenerator() {
...@@ -105,6 +106,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase { ...@@ -105,6 +106,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase {
} }
/** /**
* accessor method to set a state variable
* @param interarrivalTimeGenerator the interarrivalTimeGenerator to set * @param interarrivalTimeGenerator the interarrivalTimeGenerator to set
*/ */
public void setInterarrivalTimeGenerator(RandomVariate interarrivalTimeGenerator) { public void setInterarrivalTimeGenerator(RandomVariate interarrivalTimeGenerator) {
...@@ -112,6 +114,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase { ...@@ -112,6 +114,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase {
} }
/** /**
* accessor method to get a state variable
* @return the numberArrivals * @return the numberArrivals
*/ */
public int getNumberArrivals() { public int getNumberArrivals() {
...@@ -119,6 +122,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase { ...@@ -119,6 +122,7 @@ public class ArrivalProcessOpenDis7 extends SimEntityBase {
} }
/** /**
* accessor method to get current DIS channel object
* @return the disChannel * @return the disChannel
*/ */
public DisChannel getDisChannel() { public DisChannel getDisChannel() {
......
...@@ -3,7 +3,8 @@ package SimkitOpenDis7Examples; ...@@ -3,7 +3,8 @@ package SimkitOpenDis7Examples;
import simkit.Entity; import simkit.Entity;
/** /**
* @author ahbuss * Model a ship that arrives at a pier for crane servicing
* @author abuss@nps.edu
*/ */
public class Ship extends Entity { public class Ship extends Entity {
...@@ -13,7 +14,7 @@ public class Ship extends Entity { ...@@ -13,7 +14,7 @@ public class Ship extends Entity {
protected double remainingUnloadingTime; protected double remainingUnloadingTime;
/** /**
* * Model constructor
* @throws IllegalArgumentException if remainingUnloadingTime &le; 0.0 * @throws IllegalArgumentException if remainingUnloadingTime &le; 0.0
* @param remainingUnloadingTime Given initial unloading time * @param remainingUnloadingTime Given initial unloading time
*/ */
...@@ -37,7 +38,7 @@ public class Ship extends Entity { ...@@ -37,7 +38,7 @@ public class Ship extends Entity {
} }
/** /**
* * accessor method to get a state variable
* @return The remainingUnloadingTime * @return The remainingUnloadingTime
*/ */
public double getRemainingUnloadingTime() { public double getRemainingUnloadingTime() {
......
...@@ -3,7 +3,8 @@ package SimkitOpenDis7Examples; ...@@ -3,7 +3,8 @@ package SimkitOpenDis7Examples;
import simkit.random.RandomVariate; import simkit.random.RandomVariate;
/** /**
* @author ahbuss * Model a ship arrival process
* @author abuss@nps.edu
*/ */
public class ShipArrivalProcess extends ArrivalProcess { public class ShipArrivalProcess extends ArrivalProcess {
...@@ -19,7 +20,7 @@ public class ShipArrivalProcess extends ArrivalProcess { ...@@ -19,7 +20,7 @@ public class ShipArrivalProcess extends ArrivalProcess {
} }
/** /**
* * Instance constructor
* @param interarrivalTimeGenerator Given generator for interarrival times * @param interarrivalTimeGenerator Given generator for interarrival times
* @param unloadTimeGenerator Given generator for total unloading times * @param unloadTimeGenerator Given generator for total unloading times
*/ */
...@@ -42,6 +43,7 @@ public class ShipArrivalProcess extends ArrivalProcess { ...@@ -42,6 +43,7 @@ public class ShipArrivalProcess extends ArrivalProcess {
} }
/** /**
* accessor method to get a state variable
* @return the unloadTimeGenerator * @return the unloadTimeGenerator
*/ */
public RandomVariate getUnloadTimeGenerator() { public RandomVariate getUnloadTimeGenerator() {
...@@ -49,6 +51,7 @@ public class ShipArrivalProcess extends ArrivalProcess { ...@@ -49,6 +51,7 @@ public class ShipArrivalProcess extends ArrivalProcess {
} }
/** /**
* accessor method to set a state variable
* @param unloadTimeGenerator the unloadTimeGenerator to set * @param unloadTimeGenerator the unloadTimeGenerator to set
*/ */
public void setUnloadTimeGenerator(RandomVariate unloadTimeGenerator) { public void setUnloadTimeGenerator(RandomVariate unloadTimeGenerator) {
......
...@@ -13,7 +13,7 @@ import simkit.random.RandomVariate; ...@@ -13,7 +13,7 @@ import simkit.random.RandomVariate;
* will occur ahead of any simultaneously scheduled Arrival events, as long as * will occur ahead of any simultaneously scheduled Arrival events, as long as
* they have the default priority of 0.0. * they have the default priority of 0.0.
* *
* @author ahbuss * @author abuss@nps.edu
*/ */
public class SimpleServer extends SimEntityBase { public class SimpleServer extends SimEntityBase {
...@@ -132,7 +132,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -132,7 +132,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return the numberAvailableServers * @return the numberAvailableServers
*/ */
public int getNumberAvailableServers() { public int getNumberAvailableServers() {
...@@ -140,7 +140,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -140,7 +140,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return the numberInQueue * @return the numberInQueue
*/ */
public int getNumberInQueue() { public int getNumberInQueue() {
...@@ -148,7 +148,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -148,7 +148,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* * accessor method to set a state variable
* @param totalNumberServers total number of servers * @param totalNumberServers total number of servers
* @throws IllegalArgumentException if totalNumberServers &lt; 0 * @throws IllegalArgumentException if totalNumberServers &lt; 0
*/ */
...@@ -160,6 +160,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -160,6 +160,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* accessor method to get a state variable
* @return the serviceTimeGenerator * @return the serviceTimeGenerator
*/ */
public RandomVariate getServiceTimeGenerator() { public RandomVariate getServiceTimeGenerator() {
...@@ -167,6 +168,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -167,6 +168,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* accessor method to set a state variable
* @param serviceTimeGenerator the serviceTimeGenerator to set * @param serviceTimeGenerator the serviceTimeGenerator to set
*/ */
public void setServiceTimeGenerator(RandomVariate serviceTimeGenerator) { public void setServiceTimeGenerator(RandomVariate serviceTimeGenerator) {
...@@ -174,7 +176,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -174,7 +176,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return the totalNumberServers * @return the totalNumberServers
*/ */
public int getTotalNumberServers() { public int getTotalNumberServers() {
...@@ -182,7 +184,7 @@ public class SimpleServer extends SimEntityBase { ...@@ -182,7 +184,7 @@ public class SimpleServer extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return the numberServed * @return the numberServed
*/ */
public int getNumberServed() { public int getNumberServed() {
......
...@@ -6,7 +6,8 @@ import simkit.Priority; ...@@ -6,7 +6,8 @@ import simkit.Priority;
import simkit.SimEntityBase; import simkit.SimEntityBase;
/** /**
* @author ahbuss * Model two crane berths
* @author abuss@nps.edu
*/ */
public class TwoCraneBerths extends SimEntityBase { public class TwoCraneBerths extends SimEntityBase {
...@@ -209,7 +210,7 @@ public class TwoCraneBerths extends SimEntityBase { ...@@ -209,7 +210,7 @@ public class TwoCraneBerths extends SimEntityBase {
} }
/** /**
* * Get tree of sorted Ship set queue
* @return Shallow copy of queue * @return Shallow copy of queue
*/ */
public SortedSet<Ship> getQueue() { public SortedSet<Ship> getQueue() {
...@@ -217,7 +218,7 @@ public class TwoCraneBerths extends SimEntityBase { ...@@ -217,7 +218,7 @@ public class TwoCraneBerths extends SimEntityBase {
} }
/** /**
* * Get tree of sorted Ship set berths
* @return Shallow copy of berth * @return Shallow copy of berth
*/ */
public SortedSet<Ship> getBerth() { public SortedSet<Ship> getBerth() {
...@@ -225,7 +226,7 @@ public class TwoCraneBerths extends SimEntityBase { ...@@ -225,7 +226,7 @@ public class TwoCraneBerths extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return The timeInSystem * @return The timeInSystem
*/ */
public double getTimeInSystem() { public double getTimeInSystem() {
...@@ -233,7 +234,7 @@ public class TwoCraneBerths extends SimEntityBase { ...@@ -233,7 +234,7 @@ public class TwoCraneBerths extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return The delayInQueue * @return The delayInQueue
*/ */
public double getDelayInQueue() { public double getDelayInQueue() {
......
File deleted
...@@ -6,7 +6,15 @@ import simkit.Priority; ...@@ -6,7 +6,15 @@ import simkit.Priority;
import simkit.SimEntityBase; import simkit.SimEntityBase;
/** /**
* @author ahbuss * Add DIS outputs to TwoCraneBerths simkit simulation
* @see TwoCraneBerths
* @see SimkitOpenDis7Examples.run.RunTwoCranesBerth
* @see SimkitOpenDis7Examples.run.RunTwoCranesBerthOpenDis7
* @see <a href="run/RunTwoCranesBerthOpenDis7Log.txt">RunTwoCranesBerthOpenDis7Log.txt</a>
* @see <a href="TwoCraneBerthsAssignment05.docx">TwoCraneBerthsAssignment05.docx</a>
* @see <a href="TwoCraneBerthsAssignment05Solution.docx">TwoCraneBerthsAssignment05Solution.docx</a>
* @author abuss@nps.edu@nps.edu
* @author brutzman@nps.edu
*/ */
public class TwoCraneBerthsOpenDis7 extends SimEntityBase { public class TwoCraneBerthsOpenDis7 extends SimEntityBase {
...@@ -209,7 +217,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase { ...@@ -209,7 +217,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase {
} }
/** /**
* * Get tree of sorted Ship set queue
* @return Shallow copy of queue * @return Shallow copy of queue
*/ */
public SortedSet<Ship> getQueue() { public SortedSet<Ship> getQueue() {
...@@ -217,7 +225,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase { ...@@ -217,7 +225,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase {
} }
/** /**
* * Get tree of sorted Ship set berths
* @return Shallow copy of berth * @return Shallow copy of berth
*/ */
public SortedSet<Ship> getBerth() { public SortedSet<Ship> getBerth() {
...@@ -225,7 +233,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase { ...@@ -225,7 +233,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return The timeInSystem * @return The timeInSystem
*/ */
public double getTimeInSystem() { public double getTimeInSystem() {
...@@ -233,7 +241,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase { ...@@ -233,7 +241,7 @@ public class TwoCraneBerthsOpenDis7 extends SimEntityBase {
} }
/** /**
* * accessor method to get a state variable
* @return The delayInQueue * @return The delayInQueue
*/ */
public double getDelayInQueue() { public double getDelayInQueue() {
......
...@@ -9,6 +9,7 @@ import simkit.stat.SimpleStatsTimeVarying; ...@@ -9,6 +9,7 @@ import simkit.stat.SimpleStatsTimeVarying;
import simkit.util.SimplePropertyDumper; import simkit.util.SimplePropertyDumper;
/** /**
* Run a simple server problem and compute statistical measurement of results.
* <h2>Output:</h2><pre> * <h2>Output:</h2><pre>
* ArrivalProcess.1 * ArrivalProcess.1
* &nbsp;&nbsp;&nbsp;&nbsp;interarrivalTimeGenerator = Uniform (0.900, 2.200) * &nbsp;&nbsp;&nbsp;&nbsp;interarrivalTimeGenerator = Uniform (0.900, 2.200)
...@@ -22,11 +23,17 @@ import simkit.util.SimplePropertyDumper; ...@@ -22,11 +23,17 @@ import simkit.util.SimplePropertyDumper;
* Average number in queue 15.9655 * Average number in queue 15.9655
* Average utilization 0.9819</pre> * Average utilization 0.9819</pre>
* *
* @author ahbuss * @author abuss@nps.edu
*/ */
public class RunSimpleServer { public class RunSimpleServer
{
/** Default constructor */
public RunSimpleServer()
{
// default constructor
}
/** /**
* Run a simple program and compute statistical measurement of results.
* @param args the command line arguments * @param args the command line arguments
*/ */
public static void main(String args[]) { public static void main(String args[]) {
......
...@@ -27,13 +27,22 @@ import simkit.util.SimplePropertyDumper; ...@@ -27,13 +27,22 @@ import simkit.util.SimplePropertyDumper;
* *
* @see SimkitOpenDis7Examples.ArrivalProcessOpenDis7 * @see SimkitOpenDis7Examples.ArrivalProcessOpenDis7
* @see SimkitOpenDis7Examples.SimpleServer * @see SimkitOpenDis7Examples.SimpleServer
* @see <a href="RunSimpleServerOpenDis7Log.txt">RunSimpleServerOpenDis7Log.txt</a>
* @see <a href="../ArrivalProcessOpenDis7EventGraphPdu.png">ArrivalProcessOpenDis7EventGraphPdu.png</a>
* @see <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/raw/master/examples/src/SimkitOpenDis7Examples/documentation/ArrivalProcessDisPdu.png">ArrivalProcessDisPdu.png</a> * @see <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/raw/master/examples/src/SimkitOpenDis7Examples/documentation/ArrivalProcessDisPdu.png">ArrivalProcessDisPdu.png</a>
* @author ahbuss * @author abuss@nps.edu@nps.edu
* @author brutzman * @author brutzman@nps.edu
*/ */
public class RunSimpleServerOpenDis7 { public class RunSimpleServerOpenDis7
{
/** Default constructor */
public RunSimpleServerOpenDis7()
{
// default constructor
}
/** /**
* Run a simple program and compute statistical measurement of results.
* @see RunSimpleServer
* @param args the command line arguments * @param args the command line arguments
*/ */
public static void main(String args[]) { public static void main(String args[]) {
......
...@@ -27,11 +27,17 @@ Average time in system: 1.3207 ...@@ -27,11 +27,17 @@ Average time in system: 1.3207
Average delay in queue: 0.4857 Average delay in queue: 0.4857
</pre> </pre>
* *
* @author ahbuss * @author abuss@nps.edu
*/ */
public class RunTwoCranesBerth { public class RunTwoCranesBerth
{
/** Default constructor */
public RunTwoCranesBerth()
{
// default constructor
}
/** /**
* Run a simple program and compute statistical measurement of results.
* @param args the command line arguments * @param args the command line arguments
*/ */
public static void main(String[] args) { public static void main(String[] args) {
......
...@@ -27,11 +27,17 @@ Average time in system: 1.3207 ...@@ -27,11 +27,17 @@ Average time in system: 1.3207
Average delay in queue: 0.4857 Average delay in queue: 0.4857
</pre> </pre>
* *
* @author ahbuss * @author abuss@nps.edu
*/ */
public class RunTwoCranesBerthOpenDis7 { public class RunTwoCranesBerthOpenDis7
{
/** Default constructor */
public RunTwoCranesBerthOpenDis7()
{
// default constructor
}
/** /**
* Run a simple program and compute statistical measurement of results.
* @param args the command line arguments * @param args the command line arguments
*/ */
public static void main(String[] args) { public static void main(String[] args) {
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment