Description of instrument: PICK8

In all cases participants receive a  ticket that gives $w if white ball is drawn and
$b if a black ball is drawn.

They can also purchase a 2nd lottery ticket, that pays out if one of the colors is drawn.
That is, this 2nd ticket ONLY pays on black or on white.

The type of the ticket1  is determined by the loType1 variable, and useWhites[1]

lotype1
  1 : payouts of blackDefaults[1] and whiteDefaults[1]
  2 : payouts blackPayouts[1] and whitePayouts[1]

The type of  ticket2  is determined by the loType2 variable and useWhites[2]
Note that ticket2 payouts are in addition to the ticket1 payout 

loType2 can be: 
  1: All participants can buy the same "color" (W or B) lottery ticket.  This pays
     blackDefaults[2]  if the BLACK is drawn on a B ticket, and whiteDefaults[2] if W is
     drawn on a W ticket. Otherwise, $0 is paid.
     Whether W or B tickets are used (for everyone) depends on value of USEWHITES[2]
  2 : same as 1, but type of ticket varies across participants as determined by 
      by whiteGroups[2]
  3 : same as 1, but payout varies across participants (blackPayouts[2] and whitePayouts[2])
  4 : same as 2, but payouts vary across participants (blackPayouts[2] and whitePayouts[2])

lotype3 is the same as lotype2, but is used only if a third ticket is offered (and array index of 3 is used)

 
 


 ========================
General Variables


SHOWUPFEE	Payment for just showing up

LOTYPE1    Ticket 1 type (see above). 1 if same for all, 2 if varying
LOTYPE2    Ticket 2 type (see above). 1 if same for all, 2 if some W and B, 3.. ,4.. 
LOTYPE3    Ticket 3 type (see above). Similar to LOTYPE2


BLACKDEFAULTS[1] Ticket 1 payout if black drawn and lotype1=1
BLACKDEFAULTS[2] Ticket 2 payout if black drawn and lotype2=1 and useWhites[2]=0
BLACKDEFAULTS[3] Ticket 3 payout if black drawn and lotype3=1 and useWhites[3]=0

WHITEDEFAULTS[1] Ticket 1 payout if white drawn and lotype1=1 
WHITEDEFAULTS[2] Ticket 2 payout if white drawn and lotype2=1 and useWhites[2]=1
WHITEDEFAULTS[3] Ticket 3 payout if white drawn and lotype3=1 and useWhite3[2]=1

USEWHITES[1]  : not currently used
USEWHITES[2]  : If 1, and if lotype2=1 or 3, everyone gets W ticket. Otherwise, everyone gets B
USEWHITES[3]  : Same as above, for ticket 3

USE2TICKETS   :  Is this a two ticket round? Note that ticket 1 is constant (free, no participant options).

Reference Variables


whiteGroups[1]  not currently used
whiteGroups[2]  If lotype2=2 or 4: if 1 then get a W ticket2. Otherwise, a B ticket2
whiteGroups[3]  If lotype3=2 or 4: if 1 then get a W ticket3. Otherwise, a B ticket3

whitePayouts[1]	White ball payout (first ticket, used if loType1=2 )
whitePayouts[2]	white ball payout (2nd ticket, used if lotype2=2 or 4 and player has W ticket )
whitePayouts[3]	white ball payout (same as [2], but for 3rd ticket)

blackPayouts[1]	black ball payout (first ticket, used if loType1=2)
blackPayouts[2]	black ball payout (2nd ticket, used if lotype2=2 or 4 and player has W ticket)
blackPayouts[3]	black ball payout (same as [2], but for 3rd ticket)


-----
Submitted variables

Each participant, in each round, submits the following variables

Round specific variables (same for all participants)     
      nowRound        = the round number
      isDemo          = 0/1 dummy (1 if this is a demo round)
      open_ended      = 0/1 dummy (1 if open ended offers)
      open_ended_min  = if open_ended, this is the min acceptable offer (smaller offers are rejected)
      lotype1         = the type of ticket 1 (1 or 2)
      lotype2         = the type of ticket 2 (1,2,3, or 4)
      use2Tickets     = 0/1 dummy (1 if a 2 ticket round)
      realCount       = real round count (if demo round, this not augmented)
      roundCost       = the ticket cost (not used if open ended)
      ballDrawn       = the color of the ball that was drawn (1=black, 2=white)
Participant specific
      badOffer        =  0/1 dummy : if 1, bad offer (due to too late offer)
      ballChosenColor = the color of the ball that was subject to choice
      ballChosenYes   = 0/1 dummy (1 if a ball was chosen, 0 if ball was not chosen (hence no earnings on this ticket)
      offerPrice      = only used if open-ended: the offer price (if 0, no offer was made)
      reject          =  0=accepted offer, 1=rejected, 2=NOT openended.
      roundEarnings   =  earnings in this round
      totalEarnings   =  total earnings after taking into account this round's earnings

