Judge MAGNETO


The Report

  Section 1

 "The code that we were given and expanded on is capable of
  determining a healthy, but effective dosage regimen for an 
  individual given that individual's weight (which is a proxy 
  for blood volume)."
  
  This statement could be improved, pointing out that the
  code you were given was incomplete; you had to insert
  statements just to get it to run at all, and then you had
  to devise a blood volume model, and make the program interactive.
  I just think you should be sure to point out what you did.

  Section 2.1

  The second paragraph explains, in words, the process carried
  out by the program in one time step.  However, I don't think
  it makes a clear picture of what is going on.  I would start
  with the big picture.  This is what I am thinking of:

  The code models the process by which medicine moves through
  the body.  Medicine appears in the digestive tract, is absorbed 
  into the blood stream, and then excreted to the intestines.
  At regular times, more medicine enters the digestive tract.
  At a constant absorption rate, medicine moves from digestive
  tract to bloodstream, and at a constant excretion rate,
  medicine moves from bloodstream to the intestines.  The actual
  amount of medicine moving is determined by multiply the rate
  by the amount of medicine present.  The program simulates this
  process by marching through a sequence of discrete time steps,
  adjusting the levels of medicine in digestive tract, blood stream,
  and intestines according to the given rates.

  This may be too many words, but I am trying to make a clear
  picture of the process that is being simulated.

  Section 2.3

  It is good that you modeled the fact that people sleep, and
  Figure 2 makes your point clearly.

  Section 4.1

 "This causes the concentration of the drug in a person's blood
  to change continuously, as is visible in the figure below."

  I assume that "the figure below" is Figure 4, but Figure 4
  has no caption, so I'm not completely sure.  The text should
  be modified to read "in Figure 4 (below)." and Figure 4 should
  have a caption that specifically mentions "Time Release" so
  that there is no doubt about the connection between the words
  and the picture.

  Section 4.3

  I would suggest that you say a little more here about how the
  interactive program works.  In other words, I would emphasize
  the interactivity by printing a short sample dialogue:

    Enter in your weight (kg):
    84
    For your weight of 84 kg, the total daily dose 12mg assuming 4 doses a day

  I would also demonstrate correctness by showing that this program,
  given the weight that is implicitly used by the initial version of
  the program, returns the same dosage level as the initial program used.

  Again, I think you want to emphasize to the judges the work you did.

  Section 4.4

  The three plots a, b, c, should have a "Figure 5" caption.
  Plots b and c refer to drugs for which the Toxic and Medicinal
  levels shown are not applicable, so those horizontal lines should
  be removed; otherwise, it looks like in both cases you're poisoning
  the patient.

The Programs

  Your README file does explain what is going on in each program,
  but I would prefer that each program also have at least a 1 line
  explanation at the beginning of what is going on.