Data Periods
- Dean Goodman (Deactivated)
- Jason Hoekstra
- Ian Christopher (Deactivated)
Owned by Dean Goodman (Deactivated)
The SDG has the capability to simulate the passage of time through a given school year via the concept of data periods. At the most basic level, a data period is simply a period of time for which the SDG will generate and output data. Mutators, when present, run at the end of each data period.Â
Date period Name elements will be used when crafting output file names so that data can easily be grouped by time period for bulk loading. The most frequent use case is data periods which neatly align with school calendar periods such as grading periods, terms, or school years.
Data Period Configuration
Data periods are defined in the SDG XML configuration file and have the following restrictions:
- The beginning of the first data period MUST be the same as the
SchoolCalendar.StartDate
configuration element - Data periods MUST have a Name property
- Data periods MUSTÂ be consecutive and non-overlapping (including weekends and school holidays)
- Data periods will typically have EndDates that fall on a Sunday and also include school holidays (like winter break)
- SDG is smart enough to only produce output on instructional days or as appropriate for non-instructional days
- The final data period MAY end prior to the end of the school year
The following listing shows an example data period configuration.
Valid DataPeriod configuration
<DataClock> <StartDate>2016-08-22</StartDate> <EndDate>2017-05-08</EndDate> <DataPeriod Name="First Six Weeks"> <StartDate>2016-08-22</StartDate> <EndDate>2016-10-02</EndDate> </DataPeriod> <DataPeriod Name="Second Six Weeks"> <StartDate>2016-10-03</StartDate> <EndDate>2016-11-13</EndDate> </DataPeriod> <DataPeriod Name="Third Six Weeks"> <StartDate>2016-11-14</StartDate> <EndDate>2017-01-02</EndDate> </DataPeriod> <DataPeriod Name="Fourth Six Weeks"> <StartDate>2017-01-03</StartDate> <EndDate>2017-02-12</EndDate> </DataPeriod> <DataPeriod Name="Fifth Six Weeks"> <StartDate>2017-02-13</StartDate> <EndDate>2017-03-26</EndDate> </DataPeriod> <DataPeriod Name="Sixth Six Weeks"> <StartDate>2017-03-27</StartDate> <EndDate>2017-05-08</EndDate> </DataPeriod> </DataClock>