Generation - Student Interchange Data
- Jason Hoekstra
This section outlines the Student Interchange generation rules.
Input & Precursors
This document can be generated independently of other interchange files by providing input parameters (e.g., number of students, ethnicity and gender percentages), or as part of a generation run including Education Organizations.
Entities & Elements
Interchange-Student.xsd contains one entity:
- Student
Path | Element | Rules | Notes |
---|---|---|---|
Student | id | "STU_{StudentUniqueId}", where StudentUniqueId is defined as below | |
StudentUniqueId | Id is a sequential 6-digit number based starting from 000001 at the time the program begins. | ||
Address | If student is homeless, no address is generated | ||
At Risk Status (StudentIndicator) | Set if student is Homeless, EconomicDisadvantaged or FoodServiceEligible | ||
BirthData | Birth date calculated from a base year given current year and student's grade level. Start of school year assumed to be 8/31. Random offset between -30 and 365 days added to school start day, with a 2% chance of an additional -365 day offset added to model held back students. | ||
EconomicDisadvantaged | Randomly set to true based on the StudentProfile, which defines chance on a per-race basis | ||
ElectronicMail | Hard coded for all students to be "{FirstName}.{LastSurname}-{Id}@example.com", set as primary, home/personal email address | ||
HomelessStatus | Randomly set to true based on the StudentProfile, which defines chance on a per-race basis | ||
ImmigrantStatus | Randomly set based on the ImmigrantProfile in the StudentProfile, which defines chance as well as country of origin on a per-race basis. | ||
Language | Set only if student is an immigrant. If so, HomeLanguage is set to Spanish if the student is HispanicLatinoEthnicity or Other in all other cases | ||
Name | Randomly chosen based on gender and ethnicity. FirstNames defined in "DataFiles\FirstName-{Ethnicity}-{Gender}.csv"; LastNames defined in "DataFiles\Surname-{Ethnicity}.csv" | ||
Race | Randomly generated based on StudentProfile. HispanicLatinoEthnicity and OldEthnicity fields also populated as appropriate. | ||
SchoolFoodServicesEligibility | 20% of students marked EconomicDisadvantaged as set to "Free" lunch; the remaining 80% of the EconomicDisadvantaged population are set to "ReducedPrice". | ||
Sex | Randomly generated based on StudentProfile | ||
StudentIdentificationCode | Set to match the student's UniqueId | ||
StudentIdentificationDocument | For PersonalInformationVerification: If the student ImmigrantStatus = true, 20% set to EntryInFamilyBible, 80% set to ImmigrationDocumentVisa If the student is an upperclassman (11th or 12th grade), 50% set to DriversLicense, 50% set to BirthCertificate Otherwise: BirthCertificate | ||
Telephone | If student is Homeless, no phone number is generated; otherwise, a random number is generated, prefixed by an Area Code defined for the City in which the student has an address. |