sa_weightings.xml

The sa_weightings.xml file is used to configure weightings for databases added to SuperSERVER. There must be one weightings XML file for each weighted database.

File Name

<SXV4_db_filename>_sa_weightings.xml

For example, if the SXV4 filename is Survey.sxv4, the weighting file must be named Survey_sa_weightings.xml

Location

The same location as the SXV4 database file. For example C:\ProgramData\STR\SuperSERVER SA\databases

Example

XML

<DATABASE_WEIGHTINGS dbid="VISTA0709WDWE" formula_file="formula.xml">
    <WEIGHT id="Trips level replicate weights" type="Replicate" level="TRIPS">
        <CODE>TRIPS</CODE>
        <CODE>WDWE_RW_0</CODE>
        <CODE>WDWE_RW_1</CODE>
        <CODE>WDWE_RW_2</CODE>
        <CODE>WDWE_RW_3</CODE>
        <CODE>WDWE_RW_4</CODE>
        <CODE>WDWE_RW_5</CODE>
        <CODE>WDWE_RW_6</CODE>
        <CODE>WDWE_RW_7</CODE>
        <CODE>WDWE_RW_8</CODE>
        <CODE>WDWE_RW_9</CODE>
    </WEIGHT>
    <COEFF measure="all" weight_id="Trips level replicate weights">
        <VAR id="G" value="10"/>
    </COEFF>
    <RSE_CONFIG formula="bootstrap"/>
</DATABASE_WEIGHTINGS>

Structure

<DATABASE_WEIGHTINGS>	Root node. This node has the following attributes: `dbid` - The ID of the database this weighting file applies to. `formula_file` - The name of the formula XML file. `code` - Set to `code` or `label` to indicate whether the file refers to fields by display names or codes.
<WEIGHT>	The start of the weighting factor definitions. This node has the following attributes: `id` - The ID of the weighting. For a single weight this should be the display name of the weight field; for replicate weights it can be any name. `type` - the weighting type (either `single` or `replicate`). `level` - the name of the table that the weighted field comes from.
<CODE>Name</CODE>	For replicate weights only. One entry per replicate weight. The name must be the display name of the weighted field from the table in the database.
</WEIGHT>	The end of the weighting factor definitions.
<COEFF>	The start of the constant coefficient used in the formulas. this node has the following attributes: `measure` - Either the ID of the measure that this coefficient applies to, or `all` if it applies to all measures. `weight_id` - The display name of the measure (must be the display name of a column in the database).
<VAR ... />	The coefficient definition: `id` - the name to be used in the coefficient formula (displayed in SuperCROSS). `value` - the value of the coefficient.
</COEFF>	End of the coefficient definitions.
<RSE_CONFIG ... />	Sets the formula for calculation of Relative Standard Error (RSE). Prior to version 9.7, it was necessary to configure a data control plugin to calculate RSE values. From 9.7 onwards this now runs automatically for all SuperSERVER weighted databases, and will use the jackknife formula for calculating the RSE. You can still configure the plugin if you wish to change some of its other settings, although if you just want to change the formula then you can do this by editing the setting in the weightings file (if both are configured then the plugin settings take precedence). This node has the following attribute: `formula` - the formula (either `bootstrap` or `jackknife`).
</DATABASE_WEIGHTINGS>	End of the database weighting definitions.