SDA 4.0 Documentation for UPDATES

NAME

DESCRIPTION

• First there is a summary of changes by SDA version (with links to the next section).
• That summary is followed by a description of the changes by category.

• Version 3.6 (only limited distribution)
  • Accessibility Option (for Version 3.x)
  • Medians in the MEANS Program
  • Probabilities for LOGIT Program

• Version 4.0
  • New User Interface
  • New SDA Manager
  • Modify Underlying Architecture

• Version 4.0.1
  • Modify Interface for Help
  • Accessibility Option
  • Bookmark Analysis Output

• Version 4.0.2
  • Drag and Drop
  • View Variable with Right Click
  • View Has Bars for Frequencies

• Version 4.0.3
  • Percentiles in the MEANS Program
  • Minimum and Maximum in the MEANS Program
  • Codebook Has Bars for Frequencies

CHANGES TO THE INTERFACE (Version 4.0 and later)

• In Version 4.0:
  
  • The user interface was substantially modified in Version 4.0, providing a more modern look with rich, dynamic components.

  • This also allows for the simplification of the interface for beginning users by hiding more advanced options until they're needed.

• In Version 4.0.1:
  
  • A question mark now indicates that online help is available by clicking on the question mark. In previous versions of SDA, the online help was accessed by clicking on the name of the option -- a mechanism that was not clear to all users.

• In Version 4.0.2:
  
  • Drag and drop from variable tree to input text boxes
    You can drag and drop a variable from the variable tree to an input field on a form. (Note that although the variables in the tree include both the variable name and the label, only the variable name will be "dropped" into the input field.)
    In addition to "drag and drop," however, the procedure of clicking on a variable to transfer it to the "Selected" box, and then clicking a button to transfer the variable to the appropriate input field continues to function as in previous versions.

  • Right-click on variable tree to view variable description
    You can right-click on a variable in the tree to bring up a context menu where you can click on View variable to view a description of the variable's contents.
    This is a shortcut for the procedure of first selecting a variable to put it in the "Selected" box and then clicking on the "View" button.

ACCESSIBLITY VERSIONS

• In Version 4.0.1:
  The Version 4.0 interface was modified to include an accessibility interface that was compliant with Section 508. There is a checkbox at the top of the option screen to enter that mode.

• In Version 3.6:
  The former version 3 "Classic Interface" was updated into an SDA interface that was easier for screen readers to interpret. This revised accessibility interface was intended to be compliant with requirements to make all SDA software accessible to those with disabilities. However, version 4.0.1 provides a more complete solution for the issue of accessibility.

RE-RUNNING (BOOKMARKABLE) ANALYSIS OUTPUT

• In Version 4.0.1:
  When the result of one of the analysis programs (TABLES, MEANS, etc.) is sent to your browser to be displayed, the URL in the address window at the top of your browser now contains all of the information necessary to re-run that specific analysis. There are various ways to make use of this new feature:

  • You can bookmark the URL in your browser, in order to run the same analysis later. This is a good way to document compactly the various steps of your analysis.

  • You can also e-mail the URL to someone, and the recipient can simply click on that URL in the e-mail to run the analysis. This method is easier than saving the output in a file and then sending someone the file that you have saved.

  • You can also copy and store one or several URLs in a file, perhaps with some commentary. If you put the URLs in a Word file, for example, you can define the URLs as hyperlinks. Then you can control-click a URL within the file to re-run the analysis. This is another way to describe and document the analysis you are carrying out. You can also e-mail such a file to someone else, who can then read your commentary and re-run the analyses.

  Note that the results for a restricted dataset will still be restricted to those users who have been granted access to that dataset. The analysis will not be re-run on a restricted dataset unless the user is logged in and authenticated.

NEW SDA MANAGER WEB APPLICATION (Version 4.0 and later)

• A new SDA Manager web application is part of the SDA distribution package for Version 4.0 and later. The SDA Manager consolidates all of the management functions for an SDA archive into one web interface. And all of the configuration information for an SDA archive is consolidated into one location -- a MySQL database. Previously, the management functions were handled by separate applications, and the configuration information was dispersed in various files across the system.

• The SDA Manager webapp also supports the configuration of personal user workspaces. These user workspaces enable analysts to create and store recoded and computed variables in their own private storage areas.

• The SDA Manager also allows an archive manager to easily configure dataset-level access control for specifying which users can access which datasets.

CHANGES TO ANALYSIS PROGRAMS (after Version 3.5)

• MEANS (in Version 3.6 and later)

  Calculate a median for each cell
  An option was added to calculate and display the median of the dependent variable, in addition to the mean. If there is a very large number of cases and table cells, there may not be enough memory to calculate the exact median for all the cells of the table. In that case an estimate of the median, called the remedian, will be computed for some of the cells. An asterisk next to the median statistic indicates that it was estimated by the remedian.

• MEANS (in Version 4.0.3)

  Calculate a percentile for each cell
  An option was added to calculate and display a specified percentile (from the 1st to the 99th percentile) of the dependent variable in each cell. Similar to the median, an estimate for each percentile may be computed and indicated by an asterisk, if the there is a very large number of cases and table cells.

  Display the minimum and/or maximum value for each cell
  The minimum and/or maximum value of the dependent variable for the cases in each cell of the table can be displayed.

• LOGIT (in Version 3.6 and later)

  Contribution to probability of '1' rather than '0'
  An option was added to convert the logit or probit coefficients to the scale of a probability, to show how much each independent variable contributes to an increase in the probability that the dependent variable is predicted to be '1' rather than '0'.

• VIEW/DESCRIBE (in Version 4.0.2)

  Bars to show relative frequencies
  When a frequency distribution is displayed (for variables with 256 categories or fewer), each category is now displayed with a horizontal bar to show the relative size of the percent of cases falling into each category.

• CODEBOOK (in Version 4.0.3)

  Bars to show relative frequencies
  When a frequency distribution is displayed (for variables with 40 categories or fewer -- or a number that can be specified with the XCODEBK program), each category is now displayed with a horizontal bar to show the relative size of the percent of cases falling into each category.

CHANGES TO THE UNDERLYING ARCHITECTURE

Upgrading from SDA Version 3.5 (or 3.6)
What does this mean for organizations that already have SDA archives? What changes in the new SDA version -- and what doesn't? Many of the pieces of the current SDA architecture remain the same as before. In particular, the SDA assets that organizations have developed -- such as SDA datsets, codebooks, etc. -- are fully compatible with SDA 4.x.

The things that DO NOT CHANGE in the new architecture include:

• The SDA dataset format
• The SDA codebook format
• The SDA metadata syntax (DDL)
• All the non-CGI SDA programs (analysis programs, codebook creation program, etc.)

The things that DO CHANGE are:

• The CGI programs (hsda, hsda2, etc.) are completely replaced by a servlet-based web user interface.
• The configuration information that was previously stored in HARC files is now stored in a MySQL database. (However, a simple procedure, HARCimport, is provided in the SDA Manager to import the information from existing HARC files into the database.)