## 3.3 Aggregated Statistics

Objects to supports the exchange of information for statistical purposes.

### 3.3.1 AggregateCharacteristicInfo

This object defines the attribute of a group of objects that implicitly or explicitly defines a subset of the group for statistical purposes.

SIF_Events are reported for this object.

Figure 3.3.1-1: AggregateCharacteristicInfo

| Element/@Attribute | Char | Privacy Rating | Description | Type
--- | --- | --- | --- | --- | ---
| AggregateCharacteristicInfo |  | Low | This object defines the attribute of a group of objects that implicitly or explicitly defines a subset of the group for statistical purposes. |
@ | RefId | M | Low | Key for aggregate characteristic information. | RefIdType
| Description | O | Low | Describes the supercategory of the characteristic described in the `Definition` element below. Examples Sex CulturalBackground YearLevel IndigenousStatus | xs:string
| Definition | M | Low | Defines the aggregate characteristic information. Examples LBOTE Male | xs:token
| ElementName | O | Low | Reference to SIF elements or external authority (e.g., `StudentPersonal/PersonInfo/Demographics/Sex`). Examples Dropout Status | xs:token
| LocalCodeList | O | Low |  | LocalCodeListType
| SIF_Metadata | O | Low |  | SIF_MetadataType
| SIF_ExtendedElements | O | Low |  | SIF_ExtendedElementsType

Table 3.3.1-1: AggregateCharacteristicInfo
JSON
{ "AggregateCharacteristicInfo": { "RefId": "06AF1D69-FB06-4AB3-8898-3505714F18FB", "Description": "Sex", "Definition": "Gender or Sex", "ElementName": "StudentPersonal/PersonInfo/Demographics/Sex" } }
XML
<AggregateCharacteristicInfo RefId="06AF1D69-FB06-4AB3-8898-3505714F18FB"> <Description>Sex</Description> <Definition>Gender or Sex</Definition> <ElementName>StudentPersonal/PersonInfo/Demographics/Sex</ElementName> </AggregateCharacteristicInfo>
Example 3.3.1-1: AggregateCharacteristicInfo

### 3.3.2 AggregateStatisticFact

This object is the actual value of a statistical measurement. It is always associated with one statistic and one or more characteristics.

SIF_Events are reported for this object.

Figure 3.3.2-1: AggregateStatisticFact

| Element/@Attribute | Char | Privacy Rating | Description | Type
--- | --- | --- | --- | --- | ---
| AggregateStatisticFact |  | Low | This object is the actual value of a statistical measurement. It is always associated with one statistic and one or more characteristics. |
@ | RefId | M | Low |  | RefIdType
| AggregateStatisticInfoRefId | M | Low | Reference to statistic defined by `AggregateStatisticInfo`. | IdRefType
| Characteristics | M | Low | Reference to one or more `AggregateCharacteristicInfo` objects. | CharacteristicsType
| Excluded | O | Low | Can the fact be excluded? | values: Yes No
| Value | M | Low | Value of the fact. | xs:decimal
| LocalCodeList | O | Low |  | LocalCodeListType
| SIF_Metadata | O | Low |  | SIF_MetadataType
| SIF_ExtendedElements | O | Low |  | SIF_ExtendedElementsType

Table 3.3.2-1: AggregateStatisticFact
JSON
{ "AggregateStatisticFact": { "RefId": "3A4E2822-C696-433B-812B-49DEAE557E41", "AggregateStatisticInfoRefId": "91A4209F-7F4F-4F4B-9DC8-D21CEFD1DC2F", "Characteristics": { "AggregateCharacteristicInfoRefId": [ "0B972D86-44EE-4D79-94F5-FF1C3131772D" ] }, "Excluded": "No", "Value": 27 } }
XML
<AggregateStatisticFact RefId="3A4E2822-C696-433B-812B-49DEAE557E41"> <AggregateStatisticInfoRefId>91A4209F-7F4F-4F4B-9DC8-D21CEFD1DC2F</AggregateStatisticInfoRefId> <Characteristics> <AggregateCharacteristicInfoRefId>0B972D86-44EE-4D79-94F5-FF1C3131772D</AggregateCharacteristicInfoRefId> </Characteristics> <Excluded>No</Excluded> <Value>27</Value> </AggregateStatisticFact>
Example 3.3.2-1: AggregateStatisticFact

### 3.3.3 AggregateStatisticInfo

This object defines the data that is being aggregated as well as the type of measurement that is being performed.

SIF_Events are reported for this object.

Figure 3.3.3-1: AggregateStatisticInfo

| Element/@Attribute | Char | Privacy Rating | Description | Type
--- | --- | --- | --- | --- | ---
| AggregateStatisticInfo |  | Low | This object defines the data that is being aggregated as well as the type of measurement that is being performed. |
@ | RefId | M | Low | Key | RefIdType
| StatisticName | M | Low | Name of Aggregate Statistic Examples Total Enrollment Diploma Recipients | xs:token
| CalculationRule | O | Low | Rule for calculating the aggregate statistic | xs:string
@ | Type | M | Low |  | values: Description Formula URL Other
| ApprovalDate | O | Low | Date for which the statistic is initially valid | xs:date
| ExpirationDate | O | Low | Date after which the statistic is no longer valid | xs:date
| ExclusionRules | O | Low | Rules for which statistic may not be reported. | ExclusionRulesType
| Source | O | Low | System providing the data: i.e., SIS, Transportation, | xs:token
| EffectiveDate | O | Low | Effective date of the statistic | xs:date
| DiscontinueDate | O | Low | Discontinue date of the statistic | xs:date
| Location | O | Low | Location where the activity takes place. | LocationType
| Measure | O | Low | Type of the statistic. | values: Count Minimum Maximum Percent Mean Median Mode Sum StandardDeviation UnduplicatedCount FTE Other
| LocalCodeList | O | Low |  | LocalCodeListType
| SIF_Metadata | O | Low |  | SIF_MetadataType
| SIF_ExtendedElements | O | Low |  | SIF_ExtendedElementsType

Table 3.3.3-1: AggregateStatisticInfo
JSON
{ "AggregateStatisticInfo": { "RefId": "A5DECBD3-161B-4F5D-9F46-EBA64C87B002", "StatisticName": "Read Proficiency L1", "CalculationRule": { "Type": "Description", "value": "Number of students scoring at Reading Proficiency Level 1" }, "ApprovalDate": "2002-09-01", "ExpirationDate": "2006-06-30", "ExclusionRules": { "ExclusionRule": [ { "Type": "SampleSize", "value": "N less than 10" } ] }, "Source": "SIS", "Location": { "Type": "School", "LocationName": "Green River High School", "LocationRefId": { "SIF_RefObject": "SchoolInfo", "value": "279BCEE5-515E-4C1A-AC3A-765D1F069BC3" } }, "Measure": "Count" } }
XML
<AggregateStatisticInfo RefId="A5DECBD3-161B-4F5D-9F46-EBA64C87B002"> <StatisticName>Read Proficiency L1</StatisticName> <CalculationRule Type="Description">Number of students scoring at Reading Proficiency Level 1</CalculationRule> <ApprovalDate>2002-09-01</ApprovalDate> <ExpirationDate>2006-06-30</ExpirationDate> <ExclusionRules> <ExclusionRule Type="SampleSize">N less than 10</ExclusionRule> </ExclusionRules> <Source>SIS</Source> <Location Type="School"> <LocationName>Green River High School</LocationName> <LocationRefId SIF_RefObject="SchoolInfo">279BCEE5-515E-4C1A-AC3A-765D1F069BC3</LocationRefId> </Location> <Measure>Count</Measure> </AggregateStatisticInfo>
Example 3.3.3-1: AggregateStatisticInfo