Creating multiple observations for fixed-time transitions       [ssa6: STB-22]
---------------------------------------------------------

	^slice^ timevar [ ^if^ exp ] [ ^in^ range ] ^,^ ^tv^id^(^varname^)^ 

		^g^enerate^(^new_var^)^ ^i^ntervals^(^interval^)^ 

		^sav^ing^(^file_name^)^ [ ^start(^varname^)^ ^nolab^el ]


adds observations to a panel (time series-cross section) data set as needed to
guarantee that certain times or ages are represented for each individual in the
panel.  ^slice^ adds observations to cover ^timevar^ for the periods specified in
the ^interval()^ option.  Individuals are identified by the variable specified in
the ^tvid()^ option.


Note that ^slice^ may add many observations to your data set.  You may need to
repartition memory with the ^memsize^ command before using ^slice^.



Options
-------

^tvid(^varname^)^ specifies the variable that identifies individuals in the data
    set.  ^tvid()^ is not optional.

^intervals(^interval^)^ specifies the time intervals to used for "slicing" the
    data.  A single argument is interpreted as the width of the interval.  For
    instance, ^interval(2)^ aggregates data into the time intervals 0<=t<2,
    2<=t<4, etc.  When more than one argument is specified, time intervals are
    aggregated as specified. For instance, ^interval(0,2,8,16)^ aggregates data
    into the intervals [0,2), [2,8), [8,16), [16, last time recorded].

    ^intervals()^ is not optional.

^generate(^new_var^)^ specifies the name of the new variable that records the
    calendar period or age group.  ^generate()^ is not optional.

^saving(^file_name^)^ specifies the name of the new file in which the results are
    to be stored.  ^saving()^ is not optional.

^start(^varname^)^ is an option to allow for a variable to define the starting
    point from which the time is to be sliced.  If ^start()^ is not specified,
    the starting point is zero.

^nolab^el suppresses the labeling of the new variable specified in the ^generate()^
    option.  Only the first 20 intervals are labeled.


Examples
--------

To slice according to specific decades:

 . ^slice yearjob, tvid(ident) int(60,70,80,90) saving(new) gen(decade)^


To slice every five periods starting from age at entry:

 . ^slice agedead, tvid(ident) int(5) saving(new) gen(agegr) start(agentry)^


Author
------

        Dr. Philippe Bocquier, CERPOD
        bocquier@@orstom.orstom.fr


Also see
--------

 Manual:  [5d] survival
    STB:  ssa6 (STB-22)
On-line:  ^help^ for ^censor^, ^firstocc^, and ^tmerge^