SAS® Visual Analytics 7.4 - User's Guide PDF
SAS® Visual Analytics 7.4 - User's Guide PDF
SAS® Visual Analytics 7.4 - User's Guide PDF
4:
®
User’s Guide
SAS® Documentation
January 8, 2019
The correct bibliographic citation for this manual is as follows: SAS Institute Inc. 2017. SAS® Visual Analytics 7.4: User’s Guide. Cary, NC:
SAS Institute Inc.
SAS® Visual Analytics 7.4: User’s Guide
Copyright © 2017, SAS Institute Inc., Cary, NC, USA
Chapter 19 / Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
About Scheduling Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Creating Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Export Data Queries as Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Additional Scheduling Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Appendix 11 / About the Classic SAS Visual Analytics Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . 625
Your First Look at the Classic SAS Visual Analytics Home Page . . . . . . . . . . . 625
Manage Content on the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Working with the Right Pane on the Classic Home Page . . . . . . . . . . . . . . . . . . 631
Discover Details Using the Object Inspector on the Classic Home Page . . . . 633
Add Comments to Objects on the Classic Home Page . . . . . . . . . . . . . . . . . . . 635
Specifying Your Preferences for the Classic SAS Visual
Analytics Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
About Searching from the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . 639
Refining Your Search Results for the Classic Home Page . . . . . . . . . . . . . . . . . 641
Audience
The features of SAS Visual Analytics are designed for the following users:
n Persons needing to explore data in support of ad hoc business questions.
n Persons responsible for designing and creating reports for their enterprise.
n Persons responsible for analyzing report data and making decisions based
on that data.
Persons responsible for managing SAS servers and managing the SAS Visual
Analytics environment should refer to SAS Visual Analytics: Administration
Guide.
The content of this document is also applicable to other SAS solutions that
integrate with and use SAS Visual Analytics features.
Prerequisites
Here are the prerequisites for using SAS Visual Analytics:
n A user ID and password for signing in to SAS Visual Analytics.
Documentation Conventions
This book uses short forms of the following phrases where the meaning is clear
from context:
User Interface
Long Form Short Form Labels*
SAS Visual Analytics Graph Builder the graph builder Custom Graph Builder
* Labels in parentheses are used only in the classic (Flash) presentation mode.
** Not all SAS Visual Analytics orders include the explorer.
xvii
Whatʼs New
What’s New in SAS Visual Analytics
7.4
which enables you to adjust for a fiscal calendar or another calendar that
does not start on January 1. Time period calculations are not restricted to the
applied filter view of data.
n Parameters have been enhanced. You can now have parameters with
multiple values, which enables you to use them in a list control. And,
parameters can now be based on date and datetime formats.
n There are now cascading prompts. Filter controls placed at the report level
and the section level can now include dependencies.
n You can now synchronize prompt values and parameters across linked
reports.
n The CumulativePeriod operator for aggregated measures now enables you
to customize the starting month for each year (for example, to calculate year-
to-date based on the fiscal year for your company).
n Periodic operators for aggregated measures have a new parameter that
enables them to be calculated before datetime filters are applied.
n Slider controls have two new properties that enable you to set dynamic
minimum and maximum values for the slider. The dynamic minimum and
maximum values automatically adjust to the current data query.
n Custom shape files for geo maps are now supported. For more information
about custom polygon data, see the SAS Visual Analytics: Administration
Guide.
n You can select all or clear all selections for list prompt controls using the right
mouse button.
n You can sort on graphs.
Accessibility
For information about the accessibility of this product, see Accessibility Features
of SAS Visual Analytics 7.4.
xx What’s New in SAS Visual Analytics 7.4
1
Part 1
Introduction to SAS Visual Analytics
Chapter 1
About SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2
Accessing SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2
3
1
About SAS Visual Analytics
What Is SAS Visual Analytics? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Benefits of Using SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
How Does SAS Visual Analytics Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
SAS Visual Analytics Community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
n enables users to share insights with anyone, anywhere, via the web or a
mobile device
Explore Data
Utilize Self-Service
Predictive and
Prescriptive Analytics
Create Hierarchies
Dynamically
Filter on Selection
Build Analytical
Analyst Models
Reports View on
Home
Build Predictive Mobile Device
Find Content and
Descriptive Models View Online
and Offline
Statistician or Explore Data
Data Scientist Evaluate Models Filter and Drill
Create Report
Generate DATA Step Collaborate
Code for Scoring
Prepare Data Customize Reports
Generate Model
Outputs Using Parameters
Report Designer Manage
Environment
Create Report
Data Administrator Design Reports View on Web
and Dashboards
View Online
Layout and
Style Precisely
Filter and Drill
Define Interactions
IT Administrator and Display Rules
Collaborate
Add Controls
for Filtering Customize Reports
Schedule and Using Parameters
Distribute Reports
Prepare Data
= SAS Visual Analytics license
Join Tables
Stage Data
= SAS Visual Statistics license
Distribute Data
Manage
Environment
Monitor Resources
Administer Security
Load Tables
Manage
Mobile Devices
and
LASR Servers
2
Accessing SAS Visual Analytics
About SAS Visual Analytics Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Authenticated Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Guest Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Use SAS Home to Access SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Overview of SAS Visual Analytics Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
About the Availability of Menus and Menu Selections in
SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
About Application Themes in SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Specifying Your Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Specify Preferences for SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Specify Settings Using SAS Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Specify Global Settings Using SAS Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Personalize SAS Visual Analytics Using SAS Home . . . . . . . . . . . . . . . . . . . . . . . . . 11
Authenticated Users
SAS Visual Analytics uses the standard sign-in window for SAS applications. To
display the sign-in window, use the URL that is supplied by your system
administrator. For example, you might enter: http://host/SASVisualAnalyticsHub
Click Sign Out in the upper right corner of the user interface to sign out of SAS
Visual Analytics. When you click Sign Out, you are signed out of all SAS web
applications. For example, suppose that you have SAS Home (the home page),
the explorer, and the designer open, and then you click Sign Out when you
finish working on a report in the designer. In this case, you have also signed out
of the home page and the explorer.
Guest Access
SAS Visual Analytics system administrators can configure support for guest
access. Users with guest access can access only the home page and SAS
Visual Analytics Viewer (the viewer). Guest access uses a shared account, so it
does not provide individualized features, such as history or alerts. If provided by
the system administrator, favorites and preferences are read-only features.
8 Chapter 2 / Accessing SAS Visual Analytics
n the currently selected report object. For example, ranges are not available for
list tables.
n whether the data for a report has been defined. For example, if the data has
not been selected, then you cannot create a filter.
For more information about roles and capabilities, see the SAS Visual Analytics:
Administration Guide.
Note: Settings are available for the modern viewer. For more information, refer
to the online Help that is available for the modern viewer.
1 On the modern home page, select your name, and then click or tap Settings.
Default Appearance
enables you to specify the appearance when the home page is displayed.
Initial Screen
enables you to specify the initial screen when the home page is
displayed. The available options depend on your role and capabilities.
Application Shortcuts
enables you to specify the order of your application shortcuts.
Tiles
enables you to specify which tiles are displayed and the order in which
they are displayed.
For more information, refer to the online Help that is available for the modern
home page.
For information about the classic home page, see “Specify Your Preferences for
the Classic Home Page” on page 638.
1 On the modern home page, select your name, and then click or tap Settings.
Personalize SAS Visual Analytics Using SAS Home 11
For information about the classic home page, see “Specify Global Preferences
Using the Classic Home Page” on page 637.
n Keyboard shortcuts: You can use keyboard shortcuts as a quick and easy
way to perform tasks or navigate the user interface. For more information,
see “Keyboard Shortcuts for SAS Visual Analytics” on page 549.
For more information, see Accessibility Features of SAS Visual Analytics 7.4.
For information about the classic home page, see “Specify Global Preferences
Using the Classic Home Page” on page 637.
13
Part 2
Accessing Data
Chapter 3
Overview of Data Flow in SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 4
Importing Local Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 5
Importing Data from Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 6
Importing Data from Other Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
14
15
3
Overview of Data Flow in SAS
Visual Analytics
Data Flow in SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Self-Service Data Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Managed Data Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
After a SAS LASR Analytic Server Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Requirements for Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
SAS Visual Analytics Administrator provides features that are most commonly
associated with managed data access. The administrator enables control of
whether tables are loaded to memory and secures access to in-memory tables.
TIP The self-service import feature keeps track of your most recently used
values for each import type to simplify repeated import actions.
4
Importing Local Data Files
Import a Local Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Limitations and Restrictions for Importing Local Data Files . . . . . . . . . . . . . . . . . 21
Large Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Importing Data from Spreadsheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table Names, Column Names, and Special Characters . . . . . . . . . . . . . . . . . . . . . . 22
Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Self-Service
Components
SAS Workspace
Server
Job Execution
PROC IMPORT
Service
Temporary DBMS
Data File
Spreadsheets
and
Delimited Files
Note: When you import a SAS data set, it is not processed with PROC
IMPORT. SAS data sets are transferred to output with a DATA step.
20 Chapter 4 / Importing Local Data Files
Note: Only the data builder can output a SAS data set or a DBMS table. The
explorer and designer can import data to SAS LASR Analytic Server only.
You can import data files that are available from the file systems on your PC.
This includes local file systems such as C:\ on Windows machines and paths
such as /home/$USER on UNIX machines. Network file systems and shared
folders are included, such as UNC paths like \\nas\spreadsheets.
To import data from a Microsoft Excel spreadsheet, delimited text file, ZIP file, or
SAS data set:
1 In the Import Data window, click the link for the type of data file that you want
to import, and then select the file.
3 (Optional) Click Preview to view the data. Preview displays up to 500 rows
from the file.
TIP Previewing the data can help you determine whether you specified
the correct encoding.
4 (Optional) In the Output Table section, enter the name for the output table
and a description. The description is limited to 256 characters. Review the
library and location settings by clicking Advanced. Make any necessary
changes.
You do not have access to the Advanced section if you are using the
explorer or designer and do not have the Build Data capability. Instead, you
can import the data to a general-purpose area or select Store the table in a
private location to prevent other users from accessing the data.
5 Click OK.
n You can import Excel workbook (XLSX, XLSM, and XLSB) files and Excel
97-2003 workbook (XLS) files. You cannot import XLST or other Excel file
types.
Here are some key points about importing XLSB files:
o The machine for the SAS Workspace Server must have the following
provider software installed: Microsoft Data Access Components (MDAC)
and Microsoft Jet (Joint Engine Technology) or Microsoft Access
Database Engine (formerly know as Microsoft Access Connectivity
Engine or ACE) for 2007 and later.
o The bit version of Microsoft Access Database Engine must be the same
as the bit version of SAS.
o You can import XLSB files only if the SAS Workspace Server is running
on Microsoft Windows.
TIP If your spreadsheet is from an unsupported Excel file type, then try
saving it as an XLSX file before importing it.
n When you import a spreadsheet (from your PC) that has multiple worksheets,
by default, all of the worksheets are imported. A table is created for each
worksheet. You can clear the check boxes for the worksheets that you do not
want to import.
n Importing pivot tables is not supported.
n Text files Column names are assigned VAR1, VAR2, and so on.
The following table identifies how a column name that begins with a number,
such as 2014sales, or that uses numbers only, such as 2014, will appear after
being imported:
Usage Notes
Review the following notes if you have trouble importing data:
n Before you click OK to import the data, click Preview. Preview shows an
accurate representation of the column names and data values that will be
available after the import.
n If SAS is configured as a Unicode server at your site, then you have the most
flexibility for importing data. Specifically, SAS as a Unicode server helps with
using column names or filenames (that are used as table names) that have
double-byte characters.
n When you import a delimited text file (CSV file), you must specify the
encoding of the text file. In some cases, the import reports success, even
though the data might be corrupted. It is important to verify the imported
data.
n If you import a SAS data set that uses user-defined formats, then you must
ensure that the custom format catalog is available to the SAS Application
Server. For more information, see “Working with User-Defined Formats” on
page 39.
n If importing large data files at the same time is common for your deployment,
then you should be aware that large data files are written to temporary disk
space on the server. In extreme cases, this can cause temporary disk space
to become full. Systems that run out of disk space can become unresponsive
and difficult to troubleshoot.
n If you import data from text files and plan to append the data, then you must
verify that the column data types and lengths match the table that you want
to append to.
n When you import data, a SAS LASR Analytic Server does not maintain pre-
existing sort orders. You must re-sort the data after you import it.
n Importing indexed SAS data sets is not supported.
24 Chapter 4 / Importing Local Data Files
25
5
Importing Data from Servers
Import a SAS Data Set on a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Import a Database Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Database Connection Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Additional Options for Importing Hadoop Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Additional Options for Importing ODBC Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Additional Options for Importing Oracle Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Additional Options for Importing PostgreSQL Tables . . . . . . . . . . . . . . . . . . . . . . . . 29
Additional Options for Importing Teradata Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
SAS Web
Application Server
Self-Service
Components
SAS Workspace
SAS LASR
Server
Analytic Server
Job Execution
DATA Step
Service
You can direct the SAS Workspace Server to access the file systems on the
server. For example, if you have a large data set, you can use FTP or another
method to copy it to a directory on the server, and then use the server to import
it.
To import a SAS data set that is accessible from your SAS Application Server:
1 Select SAS Data Set from the list of Server data types, navigate to the SAS
data set, and click OK.
Note: Remember that the data files and directories are on the remote
machine, not on your PC.
2 (Optional) In the LASR Table section, enter the name for the table and a
description. The description is limited to 256 characters. Review the library
and location settings by clicking Advanced and make changes if necessary.
You do not have access to the Advanced section if you are using the
explorer or designer and do not have the Build Data capability. Instead, you
can import the data to a general-purpose area or select Store the table in a
private location to prevent other users from accessing the data.
3 Click OK.
1 From the Import Data window, select the database name from the list of
server or Hadoop databases. These lists include only the data sources for
which a SAS/ACCESS product is licensed and configured and that your
administrator has granted you the capability to use.
If you want to import SAS Data Set on a server, see “Import a SAS Data Set
on a Server” on page 25 for more information.
2 Specify the connection information. Here are some key points about
specifying connection information:
n The Server field corresponds to the host name for the server. Some
databases connect using a data source name instead of the combination
of server and port.
Import a Database Table 27
n In the DBMS table names field, you can import multiple tables at the
same time. To do this, hold down the Ctrl key while selecting the table
names in the Choose Tables window. During the import, an icon in the
Status column indicates whether the table was successfully imported, if it
failed, or if you chose to cancel. By clicking the link in the Remarks
column, you can view additional information, such as log or error
messages.
For connection details for specific databases, see the “Database Connection
Tips” on page 28 topic.
Most fields are case sensitive. For example, specifying a value of products
in the Database field might not be the same as specifying PRODUCTS.
Case sensitivity depends on the database vendor. Furthermore, some
databases use schemas. Some databases automatically use the user ID as
the schema if a schema is not explicitly specified. Be aware that the User ID
and Schema fields can be case sensitive. Check with your database
administrator if you are unsure.
The options keyword is submitted with any options that you specify in
this field.
6 Click OK.
If the table fails to reload, the log might not contain any error information. In this
case, the log is most likely displaying information about the last successful
action on the table.
Note: If you are importing a single table, then you cannot cancel it. You can
choose to cancel if you are importing multiple tables. However, the table that is
being processed when the cancel was submitted cannot be canceled and will
finish loading.
Specifying more options might be necessary for your site. For information about
setting up parallel loading from Hadoop, see “Where Do I Locate My Analytics
Cluster” in SAS Visual Analytics: Installation and Configuration Guide
(Distributed SAS LASR).
service name for the connection information is in this file. See the following
figure:
6
Importing Data from Other Sources
Import Data from Facebook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Import Data from Google Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Import Tweets from Twitter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
2 Click OK in the Import Facebook Data window to accept the terms and
conditions.
If you would like to view the terms or remove authorization after completing
this step, click Clear Authorization on the lower left-hand side of the Import
Facebook Data window.
3 Indicate the Facebook fan page that you want to import. Valid values include
the full URL (for example, http://www.facebook.com/SASsoftware) or
the page name (for example, SASsoftware).
6 (Optional) In the LASR Table section, modify the table name and description.
Review the library and location settings by clicking Advanced. Make any
necessary changes.
You do not have access to the Advanced section if you are using the
explorer or designer and do not have the Build Data capability. Instead, you
can import the data to a general-purpose area or select Store the table in a
private location to prevent other users from accessing the data.
8 Click OK.
A Facebook limitation can cause the table to be created with only partial data. If
this occurs, you will receive a warning message. To get a complete data set, try
making one or more of the following adjustments before rerunning the import:
32 Chapter 6 / Importing Data from Other Sources
2 Click Obtain access code in the Import Google Analytics window. The
Google Analytics service opens in a new window.
3 After signing in with your Google user name and password, click Accept to
accept the terms and conditions.
5 Navigate back to SAS Visual Analytics. Paste the code (Ctrl+V) in the Paste
access code here field.
7 (Optional) Modify the fields and date range based on the data that you would
like to import.
Note: The default value for the maximum number of rows that you can
import is 100,000. For more information, contact your administrator.
8 (Optional) In the LASR Table section, modify the table name and description.
Review the library and location settings by clicking Advanced. Make any
necessary changes.
You do not have access to the Advanced section if you are using the
explorer or designer and do not have the Build Data capability. Instead, you
can import the data to a general-purpose area or select Store the table in a
private location to prevent other users from accessing the data.
9 (Optional) Review the Proxy Server section. Make any necessary changes.
10 Click OK.
in the table. To increase your chance of getting a complete data set, try
rerunning the import with a smaller date range.
Note: If you want to reload data for an existing table using the same table
name, you must do one of the following:
n Use the same library and output folder that were used when the table was
originally imported.
n Indicate both a different library and a different output folder than when the
table was originally imported.
Note: It is recommended that your SAS server be configured to use UTF-8
encoding while importing data from Google Analytics. Otherwise, it could impact
your ability to import data that includes nonstandard ASCII characters.
For more information about dimensions and metrics in Google Analytics, see
https://support.google.com/analytics/answer/1033861?hl=en and https://
developers.google.com/analytics/devguides/reporting/core/dimsmets.
The first time you import tweets, you are directed to the Twitter website to log
on to your account and authorize SAS Visual Analytics. After you enter your
logon information and click Authorize app, the SAS product page opens.
Close this page and navigate back to SAS Visual Analytics.
After the initial logon, SAS Visual Analytics uses authorization tokens for
accessing Twitter instead of requiring you to log on each time. If you would
like to change users or remove authorization after completing this step, click
Clear Sign In Information on the lower left-hand side of the Import Twitter
Data window.
3 (Optional) In the LASR Table section, enter the name for the table and a
description. Review the library and location settings by clicking Advanced.
Make any necessary changes.
You do not have access to the Advanced section if you are using the
explorer or designer and do not have the Build Data capability. Instead, you
can import the data to a general-purpose area or select Store the table in a
private location to prevent other users from accessing the data.
4 (Optional) Review the Proxy Server section. Make any necessary changes.
34 Chapter 6 / Importing Data from Other Sources
5 Click OK.
The search results from a Twitter import in SAS Visual Analytics and the search
results from Twitter’s own search interface do not match exactly. Each uses a
different mechanism to download tweets. A Twitter import in SAS Visual
Analytics uses Twitter’s public search API. There are limits on what data and
how much data that SAS can download using Twitter’s public search API. These
limits might not apply to Twitter’s own search interface. For more information,
see https://dev.twitter.com/rest/reference/get/search/tweets.
For information about the data structure of imported tweets, see Appendix 10,
“Schema for Imported Tweets,” on page 621.
Note: Rate limits apply to the Twitter service. Such limits are beyond the control
of SAS Visual Analytics. You are required to follow all applicable terms of use
that Twitter and others might promulgate for Twitter data.
Note: Certain functionality in SAS Visual Analytics enables you to invoke
external third-party resources. Be aware that use of these resources might result
in disclosure and transmission of information that you submit to these resources.
35
Part 3
Preparing Data
Chapter 7
Overview of SAS Visual Data Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapter 8
Specifying Preferences for SAS Visual Data Builder . . . . . . . . . . . . . . . . . . 41
Chapter 9
Creating Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Chapter 10
Working with Tables in Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Chapter 11
Working with Columns in Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Chapter 12
Working with Filters in Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Chapter 13
Working with Joins in Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Chapter 14
Creating LASR Star Schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Chapter 15
Working with SAS LASR Analytic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
36
Chapter 16
Importing SAS Information Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Chapter 17
Supporting Text Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Chapter 18
Customizing Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Chapter 19
Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Chapter 20
Using the Results Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
37
7
Overview of SAS Visual Data Builder
What Is SAS Visual Data Builder? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Your First Look at SAS Visual Data Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
About Managed Access to DBMS Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Working with User-Defined Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
n database tables
n Facebook, Google Analytics, and Twitter
After you import the data, you can prepare it for analysis or join it with existing
data.
The data builder provides a series of features that take advantage of the in-
memory tables in SAS LASR Analytic Server.
You can perform the following operations to add data to memory in the server:
n load an existing table directly into memory
n load the results of a data query into memory (or stage the data and then load
it into memory)
n append rows to an in-memory table
38 Chapter 7 / Overview of SAS Visual Data Builder
After the data is in memory, you can perform the following operations with in-
memory tables:
n join in-memory tables to form a LASR star schema
1 The application bar enables you to return to the home page and to access
other parts of SAS Visual Analytics and other SAS applications that integrate
with the home page. You can access your recently created or viewed reports,
explorations, stored processes, data queries, or other objects in your recent
history. Buttons are displayed for each open application.
2 The menu bar contains menus that enable you to perform tasks such as
creating new data queries and LASR star schemas. The right side of the
menu bar has a memory gauge that displays the memory utilization for a
distributed SAS LASR Analytic Server. You can also sign out of SAS Visual
Analytics.
3 The navigation pane displays a tree (the SAS Folders tree) of tables and
data queries.
4 The center of the screen contains the workspace. When you create a new
object, such as a data query, it is represented as a tab on the top of the
workspace.
The bottom of the workspace contains a series of tabs that enable you to
create column expressions, joins, and filter data.
Working with User-Defined Formats 39
5 The right pane enables you to manage the properties of the item that is
selected in the workspace.
6 The toolbar contains icons that enable you to manage, run, and schedule
data queries.
Importing Data
The data builder has self-service data import features. After you select File
Import Data, you can click the link for the type of data that you want to import.
For more information, see Chapter 4, “Importing Local Data Files,” on page 19,
Chapter 5, “Importing Data from Servers,” on page 25, and Chapter 6, “Importing
Data from Other Sources,” on page 31.
Format menu to go back to the original user-defined format. You can click to
undo the change to the format if you have not saved your work yet, or you can
remove and add the column back again.
Even if the custom format catalog is made available to the SAS Application
Server correctly, you cannot associate a user-defined format to a variable with
the data builder. The menu in the Format column does not enable you to specify
a user-defined format.
41
8
Specifying Preferences for SAS
Visual Data Builder
Specifying Global and General Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Specify Your Preferences for the Data Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9
Creating Data Queries
What Is a Data Query? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
About Creating Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Save Your Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Save a Data Query as a New Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Using the Design Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Adding a Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Add a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Add a Subquery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Support for Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Best Practices for Adding Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Specifying Properties for a Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
As you create your data query, click to validate your data query. Use the
button to preview or run the data query.
The preview option uses a temporary table for the output table. Clicking the
Results tab shows only the first 100 rows. When you run the data query, it uses
the specified output table instead of a temporary table.
44 Chapter 9 / Creating Data Queries
1 Opens the analyst's data query, and clicks to save a copy of the data
query with a new name.
2 Filters the data on the Where or Having tab for the geographic region.
3 Clicks Clear on the Outputs tab, and then specifies new output table
information. This ensures that the original output table, Sales, for the original
data query is not overwritten.
See Also
“Output Tables” on page 50
See Also
n Chapter 10, “Working with Tables in Data Queries,” on page 49
n Chapter 11, “Working with Columns in Data Queries,” on page 55
n Chapter 12, “Working with Filters in Data Queries,” on page 63
n Chapter 13, “Working with Joins in Data Queries,” on page 67
Add a Table
To add a table to a data query, use the SAS Folders tree to locate the table ( )
and then drag and drop the table onto the workspace.
46 Chapter 9 / Creating Data Queries
TIP You can also click and search for the table by name and location.
Add a Subquery
After you have created a data query and saved it, it can be used as an input
data source to another data query. To add a subquery, use the SAS Folders tree
to locate the data query ( ), and then drag and drop the data query onto the
workspace.
The subquery is represented in the workspace by the columns that are selected
for output in the subquery.
See Also
“Specifying Properties for a Source Table” on page 50
48 Chapter 9 / Creating Data Queries
49
10
Working with Tables in Data Queries
Source Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Specifying Properties for a Source Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Output Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
About Output Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Specify an Output Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Staging Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
About Staging Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Specify a Staging Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Output and Staging Table Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Create SQL Query Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Source Tables
When you drop a table onto the workspace, the data builder connects to the
SAS Metadata Server to determine the column names and data types for the
table. When you drop a subquery onto the workspace, the data builder makes
the same request, but determines the column names and data types for the
output table of the subquery.
You (or an administrator) must register a table in metadata before using it as a
source table for data preparation. When you import data from a file, a database,
Facebook, Google Analytics, or Twitter, the data builder automatically registers
the data in metadata as a table. Source tables can also be registered using SAS
Visual Analytics Administrator or SAS Management Console.
Data queries reference input tables by their unique metadata IDs. For this
reason, do not delete the metadata registrations for input tables that are used in
your data queries. If you delete the input tables from metadata, their unique
metadata IDs are also deleted from metadata. If you register the same input
tables again, they are assigned new metadata IDs. As a result, SAS Visual Data
Builder cannot locate the tables because of their new metadata IDs. If the input
tables cannot be located, the query is corrupted, and you must re-create it.
See Also
n “Adding a Data Source” on page 45
n SAS Visual Analytics: Administration Guide
50 Chapter 10 / Working with Tables in Data Queries
See Also
“Use the Auto-Aggregate Functions” on page 59
Output Tables
Action How To
Change the name of the output table. * Enter the new name in the Table field,
and save the data query. All data queries,
reports, explorations, and so on, still
reference the same table object.
Create a new output table. * Click Clear, and then specify a table
name, location, and library. This action
disassociates the previously used output
table.
Reuse an existing table. Click , and then browse for the table to
use. This action disassociates the
previously used output table.
* If you replace the default table name, OutputTable, with another name before you save the data query, the
data builder registers a new output table and uses it with the data query.
You can enter a name that is up to 32 characters as the output table name. If a
third-party vendor database product is used for the output table, then the
number of characters might be less.
If you select a SAS LASR Analytic Server or SASHDAT library, the Partition by
menu becomes available.
Staging Tables
2 Specify a library.
Note: The data builder is initially configured to use the Visual Analytics
Public LASR library and the Visual Analytics Public HDFS pair of libraries. If
you specify different libraries, then make sure that you understand how the
path is related to the server tag for the SAS LASR Analytic Server library. For
more information, see SAS Visual Analytics: Administration Guide.
* The SAS or DBMS value represents data stored in SAS data sets or a third-party vendor database,
respectively.
** Appending data is performed by the SAS LASR Analytic Server engine. Appends are not performed by
having the server read data in parallel.
The information about appending data in the previous table applies to data
queries. See “Append In-Memory Tables” on page 79 if you are working with in-
memory tables on SAS LASR Analytic Server exclusively.
See Also
Chapter 15, “Working with SAS LASR Analytic Server,” on page 77
SAS LASR Analytic Server or SASHDAT These libraries types do not support
views. Selecting the check box applies to
the work table, rather than the output
table or staging table.
If the source tables and the output tables
are in the same SAS LASR Analytic
Server library, then the check box is not
enabled, and the work table must be a
physical table.
Note: In some cases, the check box is enabled, but using this option can result
in an error when running the data query. For example, if you use a DBMS library
for the output table, you must have permission to create a view. You can clear
the check box to create the output table as a physical table in these cases.
55
11
Working with Columns in Data
Queries
Adding Columns to a Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Remove Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Specify a Column Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Specify Aggregations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Remove All Aggregations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Use Group By Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Use the Auto-Aggregate Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Use the Pivot By Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Icon Description
You can add columns to the data query in the following ways:
n Select the table in the workspace, right-click, and select Add All Columns.
n To add one column from a table, select the column name with your pointer.
TIP If you select the column name an additional time, then the column is
added to the data query again. This can be helpful if you want to use a
column for both numeric and character data. When you add a column
more than once, a number is added to the column name. If you change the
column name, then you must make sure that you do not have more than
one column with the same name.
n To create a new column, click the Column Editor tab, and then click next
to the last column that is listed. Enter a column name, expression, and type.
The remaining fields are optional.
Remove Columns
To remove a column from a data query:
3 Click to open the expression builder. The table name and column name
are added automatically as the default SQL expression.
The expression is limited to 1024 characters.
4 On the Fields tab, select columns from the source tables that you have
added to the data query.
5 On the Functions tab, select the functions to apply to the source column.
Note: If you click after you click Apply, then your last change to the
expression is undone. However, because the expression window is closed, you
might not notice the undo.
Specify Aggregations
To specify an aggregation for a column:
1 On the Column Editor tab, place your pointer in the Aggregations cell for
the column and click. Click the ellipsis button to select the aggregations to
use.
3 Select the check boxes for the aggregate functions to use. Click Apply.
Note: After you click Apply, all of the other columns are automatically
specified as GROUP BY columns. You can change a column from GROUP BY
to an aggregate function by repeating this step for the column.
58 Chapter 11 / Working with Columns in Data Queries
TIP This menu option is available only when all of the columns are
selected and at least one aggregation is defined.
4 Select the check boxes for the aggregate functions that you want to apply,
and then click Apply.
Whenever you add a column to the data query, the selected aggregate functions
are automatically applied.
1 On the Column Editor tab, place your pointer in the Pivot By cell for the
column to use as the pivot column. Click the ellipsis button to select the pivot
column and values.
2 In the Pivot Values dialog box, select the pivot by column. You can enter
search criteria in Filter fields to filter the column names.
60 Chapter 11 / Working with Columns in Data Queries
3 After the unique values for the column are loaded, select the check boxes for
the values to use in the summarization. Click Apply.
The following display shows an example of the Column Editor tab when a pivot
by column is used. The minimum and maximum Total_Retail_Price are
calculated for each Customer_ID and are then pivoted by (transposed by) three
values of the Product_Category column.
TIP TRP is specified as the label for the Total_Retail_Price column. Look at
the next display to see how the label is used to create labels for the new
columns.
The following display shows how pivoting the Customer_ID column by three
values of the Product_Category column results in additional output columns. A
substring of the pivot by values is used as a prefix to each column name and the
Use the Pivot By Feature 61
aggregate function is used as a suffix. The pivot by column label and aggregate
function are used in the output column label.
12
Working with Filters in Data Queries
About Filtering Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Specify a WHERE Clause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Specify a HAVING Clause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Best Practices for Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2 On the Fields tab, expand the table node, and select the column to use for
filtering data.
TIP You can enter a value in the Filter fields field to locate the column.
3 Double-click the column or drag and drop it in the SQL expression area.
4 For character variables, you can click column_name Values to view the
values for the column. In the Filter Values window, select the values that you
want to include in the filter.
Click Apply to add the filter values to the SQL expression area.
64 Chapter 12 / Working with Filters in Data Queries
5 (Optional) You can click the Functions tab and select the functions to use
with filtering.
6 (Optional) You can add a subquery to the filter using a table from a different
library. On the Libraries tab, click to add a library.
After you select a library, expand the library node, and select the table that
you want to use for the subquery.
Note: In the SQL expression, you must enclose the subquery in
parentheses.
A single character value Add an equal sign between the CARS.Make = 'Acura'
column name and the unique
value.
2 On the Fields tab, expand the table node, and select the column to use for
filtering data. The Output Columns node includes the calculated columns.
TIP You can enter a value in the Filter fields field to locate the column.
3 Double-click the column or drag and drop it in the SQL expression area.
4 For character variables, you can click column_name Values to view the
values for the column. In the Filter Values window, select the values that you
want to include in the filter.
Click Apply to add the unique values to the SQL expression area.
5 (Optional) You can click the Functions tab and select the functions to use
with filtering.
Best Practices for Filters 65
6 (Optional) You can add a subquery to the filter using a table from a different
library. On the Libraries tab, click to add a library.
After you select a library, expand the library node, and select the table that
you want to use for the subquery.
Note: In the SQL expression, you must enclose the subquery in
parentheses.
7 Edit the HAVING clause in the SQL expression. The syntax is identical to
that shown in step 6 of “Specify a WHERE Clause”.
For more information about editing code manually, see Chapter 18,
“Customizing Code,” on page 89.
66 Chapter 12 / Working with Filters in Data Queries
67
13
Working with Joins in Data Queries
About Joins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
How Does the Automatic Join Feature Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Feature Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Using Foreign and Primary Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Matching by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Selecting the Join Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Adding a Join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Drag and Drop Join Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Use the Joins Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Example: Joins with a Junction Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Remove a Join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Managing Joins in a Data Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Best Practices for Managing Joins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
About Joins
SAS Visual Data Builder supports joins for tables and subqueries. You can join
tables to each other, including self joins. You can join subqueries to tables and
join subqueries to subqueries. When you use a subquery in a join, the join
condition is made against the output table for the subquery. The data builder
supports joining up to 256 tables.
When you drop a table or subquery onto the workspace, the data builder
attempts to determine a join condition automatically. When the data builder
creates a join automatically using foreign keys or by matching columns, the join
is added as an inner join. The data builder also supports left, right, and full joins.
You must specify the join type manually if you do not want an inner join.
In addition to easily adding joins to a data query, the data builder generates an
SQL statement with all of the joins declared explicitly. For example, you can
specify an inner join in a WHERE clause, such as WHERE
t1.order_id=t2.order_id. However, mixing inner joins in a WHERE clause
and outer join types in a single data query can be complex to read and
understand.
SAS Visual Data Builder always generates an SQL statement with inner joins
declared explicitly. For example, see the following code sample:
68 Chapter 13 / Working with Joins in Data Queries
LEFT JOIN
LIB1.TRANSACTION_TYPE_DIM TRANSACTION_TYPE_DIM
ON CASH_FLOW_FACT.TRANSACTION_TYPE_KEY =
TRANSACTION_TYPE_DIM.TRANSACTION_TYPE_KEY
INNER JOIN
LIB1.TRANSACTION_DIM TRANSACTION_DIM
ON PARTY_DIM.SEGMENT_ID = TRANSACTION_DIM.SEGMENT_ID
AND PARTY_DIM.TRANSACTION_KEY = TRANSACTION_DIM.TRANSACTION_KEY
Feature Overview
SAS Visual Data Builder attempts to join tables and data queries automatically
as you add them to the workspace. When you drag and drop a table or data
query onto the workspace, information about the table or data query is retrieved
from the SAS Metadata Server. For subqueries, the metadata for the subqueries’
output table is retrieved.
Matching by Name
If there is no foreign key or primary key information for the table that is dragged
and dropped onto the workspace, then the data builder does not use foreign key
or primary key information for the tables already in the workspace.
The data builder retrieves the column information for all of the columns in the
newly added table. The data builder then iterates over each of the tables that are
already in the workspace in the same sequence in which they were added to the
workspace. The data builder compares the length, type, and name for each
column with each column in the newly added table. If a match is found, then the
tables are used in the join, and the columns are added as a join condition. The
data builder does not continue to search for matches between the two tables,
and it does not continue iterating over the tables that are already in the
workspace.
Adding a Join 69
1 If the column for the existing table is not nullable but the column for the newly
added table is nullable, then the tables use a left join.
2 If the column for the existing table is nullable but the column for the newly
added table is not nullable, then the tables use a right join.
3 If both columns for the existing table and newly added table are nullable,
then the tables use a full join.
4 If none of the previous conditions are met, then the tables use an inner join.
You can specify the join type by right-clicking on the join icon ( ) and selecting
the join type from the menu.
Adding a Join
1 Place your pointer on one of the columns in a table to use, and then click and
drag your pointer to a column in the other table to use in the join.
2 If you want a join type other than an inner join, then select the join, right-click,
and select the join type.
TIP The first table that is added to the workspace is always set as the left
table. You can switch the right table and left table by using the Joins tab.
2 Click .
3 Use the menus to replace Not Selected with the table names to use in the
join. Click Save.
70 Chapter 13 / Working with Joins in Data Queries
4 The default join type is an inner join. Use the menu in the Join Type column
to select a different join type.
6 Use the menus to replace Not Selected with the column names to use in
the join condition. Click Save.
To retrieve the transaction amount and transaction type from the Entity_Dim
table, it must have a join that uses the Bridge table instead of the first table (fact
table) that was added to the workspace.
To create a join to a junction (or bridge) table:
2 Add the dimension tables, such as the Accounts_Dim table and junction
tables. The data builder attempts to join the tables automatically.
Review the join as follows:
3 Add the tables that use the junction table, such as the Entity_Dim table.
Initially, the data builder attempts to join the tables to the fact table.
Correct the join as follows:
a Select the automatic join to the fact table, right-click, and select Remove
Join Condition.
b Use your pointer to connect the keys from the junction table to the
dimension table.
Remove a Join
You can remove a join by using either of the following methods:
n Select the join in the workspace, right-click, and select Remove Join
Condition.
n Click the Joins tab, select the row in the table, and click .
n switch the left table and right table assignments for a join
n add, remove, and change the columns that are used in the join condition
The Joins tab shows the join condition for the entire data query. Make sure that
you select a row in the upper table to set the columns in the Join conditions
area.
The workspace shows a link between the tables that are used in a join. If you
specify a left join or right join, then the icon reflects which table provides the
bulk of the data. If you rearrange the tables in the workspace (switching the left
72 Chapter 13 / Working with Joins in Data Queries
table and right table), then the icon continues to reflect which table provides
the bulk of the data. In order to change the data relationship, use either of the
following methods:
n Switch the left table and right table by selecting a row from the table, and
clicking .
n Change the join type from left to right or from right to left.
14
Creating LASR Star Schemas
What is a LASR Star Schema? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Create a LASR Star Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
How Are Tables Used? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Input Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Column Prefixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Output Table and Conserving Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Performance Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
n A LASR Star Schema is limited to a single join condition. It does not support
multiple key columns between fact and dimension tables.
2 Drag and drop tables or data queries from the SAS Folders tree onto the
workspace. Keep the following suggestions in mind:
74 Chapter 14 / Creating LASR Star Schemas
n Drag and drop the fact table first and then the dimension tables.
n Any input tables that are not already in a SAS LASR Analytic Server
library are loaded to memory when the star schema is run.
n If a dimension table shows the icon, then it usually indicates that the
data builder could not determine the join condition for the dimension
table. Position your pointer over the icon for information about how to
correct the incomplete table status.
n If a dimension table shows the icon, then it usually indicates that the
table is from a different SAS LASR Analytic Server library than the output
table. You must use one SAS LASR Analytic Server library only.
3 (Optional) If you do not want a column from the dimension table in the output
table, then select the column in the table in the workspace, right-click, and
select Remove Column.
Note: All of the columns from the fact table are automatically selected and
required to be included in the output table.
4 (Optional) Click the Joins tab to review the columns that are used to
generate the output table.
6 Click the Output tab, and specify a name for the output table.
7 Click , and specify a name and location for the LASR star schema.
Input Tables
The fact table and dimension tables are used in the star schema after you drag
and drop them onto the workspace. By default, the data builder considers the
first table that you drop in the workspace as the fact table. Click from the
toolbar to select a different fact table.
Because the star schema is formed in memory by the server, the first step is to
make sure that the tables are loaded to memory. Be aware that the tables are
transferred each time the star schema runs and this can reduce performance.
Conversely, if the tables are already loaded to memory on the server, the star
schema runs and generates the output faster.
When creating a star schema using tables from the same SASHDAT library, the
star schema will fail to run if one or more of the tables in the star schema is
encrypted, but the SASHDAT library is not encrypted. In this case, you will
receive an error message indicating that a password is needed for the encrypted
tables. This can occur when your administrator turns encryption off for a
previously encrypted library. Any table that was in the library beforehand will
How Are Tables Used? 75
remain encrypted. Your administrator can resolve the issue by turning encryption
back on for the library. Contact your administrator for more information.
Column Prefixes
The first 15 characters of a dimension table’s name and the underscore
character are initially set as a prefix for the column names from the dimension
table. Column names for the output table are a combination of the prefix and the
original column name.
However, you can specify a different value for the prefix after you select the
table name from the menu at the top of the Inputs tab.
Column names from the fact table are not modified with a prefix.
Performance Considerations
Creating a LASR star schema as a view can be more convenient than creating a
table, but accessing data through the view can impact performance negatively.
The scale of the impact depends on the size of the dimension tables. However,
the number of passes through the data is even more important. For example,
requesting percentiles or box plots or fitting statistical models requires passing
76 Chapter 14 / Creating LASR Star Schemas
through the data multiple times. These requests are impacted more than a
request for summary statistics.
Keep the following considerations in mind:
n The initial creation of a view is faster than forming a table. However,
accessing the data in a view is slower than accessing the data from a table.
n Creating a table requires more physical memory than creating a view. If your
system has sufficient memory capacity, then creating a table provides the
best performance for accessing the data.
77
15
Working with SAS LASR Analytic
Server
Using SAS LASR Analytic Server Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Default Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Input Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Output Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Load a Table (As Is) to SAS LASR Analytic Server . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Appending In-Memory Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
How Does Appending In-Memory Tables Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Append In-Memory Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
How Are Tables Used? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Delete Table Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Distributed Server: Using SASHDAT Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Default Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Staging Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Output Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Distributed Server: Save an In-Memory Table to SASHDAT . . . . . . . . . . . . . . . . . . 82
Distributed Server: Legacy Co-located Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Distributed Server: Partition Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Monitoring Memory Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Default Library
During installation, the SAS Deployment Wizard registers a predefined library for
SAS LASR Analytic Server. This library is available for use in the SAS Folders
tree, and it is located in /Shared Data/SAS Visual Analytics/Public/
Visual Analytics Public LASR.
This library is intentionally configured as a general-purpose library with
extremely limited restrictions for securing data access.
78 Chapter 15 / Working with SAS LASR Analytic Server
Input Libraries
When you select a SAS LASR Analytic Server table as an input table for a data
query, be aware of the following best practices if the table is large. If the table is
not large, then using it for input requires no special considerations.
Here are the considerations for using a large SAS LASR Analytic Server table as
an input table:
n A WHERE clause is processed in memory by the server if no aggregations or
joins are used. Specify a filter on the Where tab so that you use only the
rows that you want.
n Instead of using a data query (which transfers the data from the server to the
SAS Workspace Server and then performs the join), you can create a LASR
star schema. The LASR star schema performs the join in memory with other
in-memory tables.
Output Libraries
A SAS LASR Analytic Server library is initially configured as the default output
library. When you run a data query, click Explore Results to explore the
table immediately.
You can select the Append data check box on the Properties tab to add rows
to an in-memory table. However, this option is not available if you use a
SASHDAT library as a staging library. Instead, you can use the data query to
append rows, and then save the in-memory table as a SASHDAT table.
TIP You can also click , and search for the table by name and location.
Field Description
4 Click OK.
2 Select the table that you want to append data to from the Available tables
list, and click to move it to the Base table field.
If the table that you want to use is not listed, click to view a different
source library. If a table is added to the library after you click , then the list
does not automatically refresh to show the new table. Select the same library
again to refresh its contents.
80 Chapter 15 / Working with SAS LASR Analytic Server
3 Add tables to the Source tables list. These are the tables that have the rows
to append to the base table.
4 (Optional) If you select the Unload source tables after appending them to
the base table check box, then the source tables are dropped from memory
after the append completes.
Select this option only if you do not want to access the source tables
individually.
Note: If an administrator reloads the base table, any data that you previously
appended to the table will not be saved. The base table will go back to its
original content and size.
Note: If the append fails and you get an error message that says that the file is
read-only, in some cases it could mean that your administrator has indicated the
fullcopyto= option for the table. You cannot append to a table that includes
this option. Contact your administrator for more information.
Conserving Memory
After you append the source tables, the base table grows to accommodate the
additional rows. This consumes memory on the SAS LASR Analytic Server.
If you do not need to access the source tables after appending them, then you
can select the Unload source tables after appending them to the base table
check box. This option conserves memory, but you must ensure that the source
tables are loaded to memory again (often with newer data) before you can run
the append again.
Note: If the Delete option on the drop-down menu is grayed out, it means that
you do not have permission to delete the metadata for the table.
Default Library
When your deployment uses Hadoop as a co-located HDFS or NFS-mounted
MapR, the SAS Deployment Wizard registers a predefined library for it. This
library is available for use in the SAS Folders tree, and it is located in /Shared
Data/SAS Visual Analytics/Public/Visual Analytics Public HDFS.
Staging Library
You can specify a SASHDAT library as a staging library. This is a common use
because the rows for the output table are distributed among the machines in the
cluster. The server can then read the data in parallel when it loads the table to
memory.
You must specify a SAS LASR Analytic Server library for the output library when
you use a SASHDAT library for staging.
82 Chapter 15 / Working with SAS LASR Analytic Server
Output Library
You can specify a SASHDAT library as an output library. The engine distributes
the rows for the table to the machines in the cluster. Afterward, you can select
the table from the SAS Folders tree, right-click, and select Load a Table. This
menu option loads the table to memory on a SAS LASR Analytic Server.
You can partition SASHDAT tables when they are used in an output library. You
can select a column to use from the Partition by menu. Partitioning the table
ensures that all of the rows with the same formatted value as the selected
column are distributed to one machine in the cluster. The rows are also placed in
the same block. When you load a partitioned table to memory, the partitioning
information is retained, and the result is a partitioned in-memory table.
See Also
“Distributed Server: Partition Tables” on page 83
Restrictions
The following restrictions apply to using SASHDAT libraries with SAS Visual
Data Builder:
n You cannot specify a SASHDAT library as an input library because the
SASHDAT engine is a Write-only engine.
n The Append data check box on the Properties tab is disabled. The
SASHDAT engine does not support appending data.
n If you specify a SASHDAT library as an output library, you cannot view the
results on the Results tab because the SASHDAT engine is a Write-only
engine.
2 Next to the Name field, click to select the SAS LASR Analytic Server
table.
Note: The table is saved with the user ID of the user that started the SAS LASR
Analytic Server.
and SASHDAT libraries and can improve performance once the data is in
memory.
When you specify a partition key, avoid using a variable that has few unique
values. For example, partitioning by a flag column that is Boolean results in all
rows on two machines because only two values are available. At the other end
of the spectrum, partitioning large tables by a nearly unique key results in many
partitions that have few rows.
Determining the optimal partition key can be a challenging task. However, as an
example, if you tend to access data based on a customer ID, then you might
improve performance by partitioning the data by customer.
See Also
SAS LASR Analytic Server: Reference Guide
In some deployments with limited network bandwidth, the data builder cannot
communicate with the SAS LASR Analytic Server monitor, and the memory
gauge fails to appear.
See Also
SAS Visual Analytics: Administration Guide
85
16
Importing SAS Information Maps
About SAS Information Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Import a SAS Information Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Limitations and Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
See Also
Base SAS Guide to Information Maps
The business logic is imported from the map and represented as an SQL query
on the Code tab.
86 Chapter 16 / Importing SAS Information Maps
TIP If you want to join a table, then save the data query, create a new data
query, and add it as a subquery.
See Also
Chapter 18, “Customizing Code,” on page 89
17
Supporting Text Analysis
Features Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Load a Stop List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Add a Unique Numeric Key to a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Features Overview
SAS Visual Analytics can perform text analysis with the explorer. To enable text
analysis, perform the following data administration tasks with the data builder:
n Load a stop list to filter out commonly used words.
n Acquire Twitter data to analyze tweet trends. For more information about
Twitter, see Chapter 6, “Importing Data from Other Sources,” on page 31.
2 Make changes to the location and library if necessary. Each stop list must be
stored in its own metadata folder.
A table named ENGSTOPL or GRMSTOPL is registered in the location and
library that you specified.
3 Click OK.
SAS Visual Analytics supports one stop list for each SAS LASR Analytic Server.
You load the stop list (which is a table) to memory by performing the previous
steps. If more than one library is registered for SAS LASR Analytic Server, then
88 Chapter 17 / Supporting Text Analysis
you can use any one of them. If you load a stop list more than once or use more
than one library, then the server uses the last stop list that was loaded to
memory.
2 Add the columns to include in the text analysis by clicking the column name
in the table in the workspace.
3 In the Column Editor, right-click on the first row in the table, and select Add
Generated Key Column.
A column that is named GENERATED_ID is added to the table.
When you run the data query, the GENERATED_ID column begins at zero and
increments for each row in the source table. If you select the Append data
check box on the Properties tab, then the data query increments from the
current maximum value.
If the data that you want to use is already in memory on SAS LASR Analytic
Server, then performing the previous steps results in the following sequence of
data movements:
n The data is read from memory on SAS LASR Analytic Server and transferred
to the SAS Application Server.
n The data query runs and adds the generated key column.
n The data is transferred back to SAS LASR Analytic Server in a new table.
You can avoid these data movements by adding the generated key column
before loading the table to memory on SAS LASR Analytic Server.
89
18
Customizing Code
Use the Code Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Preprocess and Postprocess Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Considerations for Manually Editing Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Before You Manually Edit Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Table and Column Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Input and Output Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Validate Custom Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Any SAS statements that you enter in the Preprocess view or Postprocess
view are included in the All Code view.
1 On the Outputs tab, specify the information for the output table, including the
table name, location, and library. If you do not specify the table name or the
table name is already in use, then you will not be able to save the data query.
3 Save the data query by clicking . When you save the data query, the
metadata for the table is registered. If you do not save the query before
unlocking the code, you will receive empty columns when you run the query.
See Also
SAS Language Interfaces to Metadata
See Also
n SAS Statements: Reference
n SAS/ACCESS for Relational Databases: Reference
If you unlock the code in the All Code view, then the button is disabled. You
cannot validate customized code.
92 Chapter 18 / Customizing Code
93
19
Scheduling
About Scheduling Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
How Does the Scheduling Feature Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Edit Data Queries That Are Already Scheduled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Stop Scheduled Data Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Caution about Scheduling Data Queries to Run Now . . . . . . . . . . . . . . . . . . . . . . . . 94
Scheduling Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
When Are the Scheduling Preferences Used? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Creating Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Why Use Events? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Create a Time Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Create a File Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Export Data Queries as Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Additional Scheduling Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
When you have a data query open in the workspace, you can click to
schedule the data query. When you schedule a data query, the data builder
performs the following operations:
You can schedule the data query based on specified conditions (for example,
run immediately or run whenever a trigger condition is met).
94 Chapter 19 / Scheduling
The job, deployed job, and deployed flow are metadata objects. The data builder
stores them in the same metadata folder with the data query. The metadata
objects are named based on the following pattern:
vdb_name_timestamp
Up to 42 characters from the data query name are used as the name.
When the specified conditions are met, the data query is run with the user ID
that scheduled it. This is the behavior for the Operating System Services
Scheduler.
3 Select the trigger that you want to delete, and then click Delete.
4 If you deleted the last trigger in the list, you must perform one of the following
steps in order to proceed:
n Create a new trigger by clicking New Time Event.
5 Click OK.
7 Click to run.
Note: If you deleted all of the triggers and then selected Run now, the
scheduled data query no longer runs but it will still exist in the SAS Management
Console. To permanently delete the scheduled data query, you must use the
SAS Management Console. For more information, see the Deleting Jobs and
Flows topic in Scheduling in SAS.
You can avoid this error condition. If you want to schedule the data query to run
now, then close it, open it again, and schedule it to run now. Alternatively, you
can schedule the data query to run in the future and then close the data query.
Scheduling Preferences
n You must specify the same SAS Application Server as your default
application server in your preferences.
As with the default scheduling server, the data builder retrieves your default
batch server, and uses that value to look up the batch server in SAS metadata
the first time you schedule the data query. The data builder uses the first server
that matches the value in SAS metadata.
If you have multiple server contexts and each context has its own batch servers,
then you should specify in preferences the servers that you want to use.
Creating Events
Note: You can specify multiple time events. However, the Operating System
Services Scheduler (the default scheduler) can use only one of the time
events.
n File events are evaluated based on the state of a specified file.
You can create file events if your deployment includes a scheduling server that
supports them, and the flow is deployed to that scheduling server. Time and file
events can be used as triggers (conditions that must be met in order to run a
flow on the scheduling server).
1 In the Schedule window, select Select one or more triggers for this data
query, and then click New Time Event.
2 In the New Time Event window, specify whether the time event should
happen one time only or more than once. If the time event should happen
one time only, then specify the date and time for the time event.
3 If the time event should happen more than once, then select More than
once and then select a radio button for how often the time event should
repeat (such as hourly, weekly, or yearly).
4 Specify the details of when the time event should repeat. The specific fields
that are available depend on the recurrence interval that you select.
If you select Hourly, then the time is calculated from hour zero on a 24-hour
clock. For example, if you leave Interval hour set to 1, then the data query
runs at hour zero (midnight), and runs each hour. If you set Interval hour to
2, then the data query runs every other hour, and the Offset hour specifies
whether to run on the even hours (when set to 0) or on the odd hours (when
set to 1). In this case, the Offset hour specifies the offset from hour zero
(midnight).
If the recurrence interval requires you to select start times, then use the
Hours and Minutes check boxes to select the times. The Minutes area
contains groupings of 10-minute intervals. Selecting a check box for a minute
grouping selects all of the minutes in that grouping.
TIP The following display is available after selecting More than once and
then Daily on the New Time Event window.
98 Chapter 19 / Scheduling
If you select multiple values for Hours, then all of the selections for Minutes
apply to all of the selected values. For example, if you select 19:00 (07:00
PM) and 22:00 (10:00 PM) for Hours, and 43 for Minutes, then the time
event is scheduled for 19:43 and 22:43.
6 If needed, specify the start date and end date for the time event. The default
is to start at the current date and time and not to have an end date.
Export Data Queries as Jobs 99
1 In the Schedule window, select Select one or more triggers for this data
query, and then click New File Event.
2 In the New File Event window, specify or select the file to use for the file
event.
3 Select the condition to evaluate the file to make the file event true. For
example, if you selected not exist for the condition, the file event would be
true only if the selected file was not in the specified location.
4 If needed, specify the details (such as size or age) about the condition.
3 In the Export as a Job window, enter a name and specify a location. Click
Export.
100 Chapter 19 / Scheduling
See Also
Scheduling in SAS
101
20
Using the Results Tab
About the Results Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Data Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Navigate within the Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Filter and Sort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Export Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Column Headings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Data Pages
When you view data, a SAS server retrieves the data from the data set. Instead
of returning all of the data, the data viewer requests a page of data. You can set
the page size to between 20 and 2000 rows.
A slider is provided at the bottom of the Results tab so that you can navigate
through the pages and browse the entire data set.
102 Chapter 20 / Using the Results Tab
Find
Search for text or numbers in the data set by clicking , typing in the Find field,
and pressing Enter. The find feature searches through the rows in the data set
for the value, and it highlights the first row with the value. You can navigate
through the results by clicking Find next and Find previous.
Export Data
You can save the data that you view as a comma-separated values file. After
you click , you can choose to export the rows on the current data page, all of
the rows, or a range of rows. The export feature has a limit of exporting 200,000
rows.
If you choose to export all of the data or a range of rows, then you must click
Retrieve Data before you can click Export as CSV.
Column Headings
Use the Headings menu to control the appearance of the column headings. You
can view the column name from the data set, the column label from the data set,
or a combination of the two. If a column does not have a label in the data set,
then the column name is used.
104 Chapter 20 / Using the Results Tab
105
Part 4
Exploring Data
Chapter 21
Overview of SAS Visual Analytics Explorer . . . . . . . . . . . . . . . . . . . . . . . . . 107
Chapter 22
Specifying Preferences for SAS Visual Analytics Explorer . . . . . . . . . . . . 111
Chapter 23
Managing Explorations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Chapter 24
Managing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Chapter 25
Working with Visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Chapter 26
Working with Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Chapter 27
Exporting Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Chapter 28
Managing Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Chapter 29
Performing Data Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
106
Chapter 30
Sharing Comments in the Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
107
21
Overview of SAS Visual Analytics
Explorer
What Is SAS Visual Analytics Explorer? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
The Welcome Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Overview of the Welcome Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Create a New Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Open an Existing Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Your First Look at the Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Manage Tabs in the Right Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
1 The application bar enables you to return to the home page and to access
other parts of SAS Visual Analytics and other SAS applications that integrate
with the home page. You can access your recently created or viewed reports,
explorations, stored processes, data queries, or other objects in your recent
history. Buttons are displayed for each open application.
2 The menu bar offers common tasks, such as creating a new exploration.
3 The toolbar enables you to manage your explorations and visualizations.
4 The Data pane enables you to manage the data that is used in your
visualizations.
5 The data properties table enables you to set data item properties.
6 The workspace displays one or more visualizations.
110 Chapter 21 / Overview of SAS Visual Analytics Explorer
7 The right pane’s tabs enable you to set properties and data roles, create
filters and ranks, set global parameter values, and use comments.
8 The dock contains any minimized visualizations.
To display the full label name for each tab, select the drop-down list, and then
deselect Show icons only.
You can reorder the tabs in the right pane by dragging and dropping them.
111
22
Specifying Preferences for SAS
Visual Analytics Explorer
Specify Global Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Specify Your Preferences for the Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3 Select the default Map provider mode for geographic maps. The map
provider creates the background map for geo maps and for network
diagrams that display a map.
Note: You can change the map provider for an individual visualization by
editing the Map service value on the Properties tab.
4 If your Map provider mode is Esri, then you must select the specific Esri
map service that you want to use.
6 Select a Graph skin to change the visual effects that are applied to your
graphs. For example, many of the Graph skin settings apply lighting effects
to the features of your graph to create a 3-D appearance.
Note: A high value for Visualization data threshold might degrade your
application performance or lead to time-out errors.
23
Managing Explorations
What Is an Exploration? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Create a New Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Save Your Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Delete Explorations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
What Is an Exploration?
An exploration (sometimes called a visual exploration) is a metadata object that
contains all of the visualizations and data settings from a SAS Visual Analytics
Explorer (the explorer) session. You can use explorations to save your session
for later and to share it with others.
Delete Explorations
To delete an exploration, use the SAS Visual Analytics home page. See
“Manage Content on the Classic Home Page” on page 628.
114 Chapter 23 / Managing Explorations
115
24
Managing Data
Managing Data Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Overview of Managing Data Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Manage Data Properties for Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Select a Numeric Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Select a Date or Time Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Show and Hide Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Sort Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Group Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Assigning Colors for Category Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Add Additional Data Sources to Your Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Replace a Data Source in Your Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Remove a Data Source from Your Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Refresh Your Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Creating Custom Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
About Custom Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Create a Custom Category for a Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Create a Custom Category for a Category or a Date . . . . . . . . . . . . . . . . . . . . . . . 122
Working with Global Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
About Global Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Create a Global Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Set the Value for a Global Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Edit a Global Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Delete a Global Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Creating Calculated Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
About Calculated Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Create a Calculated Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Creating Aggregated Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
About Aggregated Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Create an Aggregated Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Support for Aggregated Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Creating Derived Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
About Derived Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Derived Item Types for Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Derived Item Types for Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Create a Derived Item for a Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Create a Derived Item for a Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
116 Chapter 24 / Managing Data
1 In the Data Properties window or in the property table in the Data pane, click
the format for the data item. A window appears.
3 Specify the Width parameter for the format. The width of the format specifies
the maximum number of characters that a value can contain, including
decimal points.
A preview of your format appears in the Sample field.
4 Specify the number of Decimals for the format. The Decimals value
specifies the number of digits that appear to the right of the decimal place.
A preview of your format appears in the Sample field.
1 In the Data Properties window or in the property table in the Data pane, click
the format for the data item. A window appears.
3 If necessary, select a more specific format from the Sample list. The format
names also represent sample values for the format.
118 Chapter 24 / Managing Data
Note: You can restore the default format by clicking Reset to Default.
Note: Time and datetime values in the explorer ignore daylight-saving time.
1 Select Data Show or Hide Items from the menu bar. The Show or Hide
Items window appears.
2 Click Select All to select or deselect all of the data items, or click the check
box beside each data item to select whether that data item is shown.
By Aggregation
groups measures by the default aggregation.
Note: The default grouping is By Classification.
About Colors
By default, the explorer assigns colors dynamically to category values for
grouped visualizations. You can assign specific colors to your category values to
ensure that the category values are always represented by a specific color.
Because the same assigned colors are used in every visualization, you can
easily compare values between visualizations.
1 Right-click on a category from the Data pane, and then select Colors. A
color selection window appears.
2 For each category value to which you want to assign a color, select the value
from the Choose drop-down list, and then click the color box to select a
color. Click Apply to save your selection.
1 Right-click on a category from the Data pane, and then select Colors. A
color selection window appears.
2 Click Reset all to clear all of the color assignments for the category.
3 Click OK to apply the new color. This color value is used consistently for the
selected category value in all of your visualizations.
120 Chapter 24 / Managing Data
1 In the Data pane, select the data source that you want to replace from the
drop-down list.
3 In the Change Data Source window, select or import the data source that you
want to use.
Note: If any data items in the previous data source do not exist in the new
data source, then a message appears. Any data items that do not exist in the
new data source are removed from your exploration. Any filters, ranks, or
calculated items that are based on the removed data items are also
removed.
1 On the Data pane, select the data source that you want to delete from the
drop-down list.
Note: You cannot delete the last remaining data source from an exploration.
Note: Any visualizations, filters, ranks, or calculated items that are based on
the deleted data source are removed from your exploration.
2 Select the measure that you want to use for the custom category.
a As needed, click New label to add a new label group to the custom
category.
b For each label group, click the label group heading (for example, Label1)
to specify the label text.
Note: The label text must use characters that are compatible with the
locale of the data source. If the data source uses Unicode, then your
labels can contain characters from any locale.
c For each label group, specify the values that are associated with the
label:
n For intervals, select and specify the minimum and maximum
values for the interval.
n For distinct values, drag and drop values from the Values list onto the
label group.
7 Click OK. The new custom category is displayed in the Data pane.
2 Select the category or date that you want to use for the custom category.
a As needed, click New label to add a new label group to the custom
category.
b For each label group, click the label group heading (for example, Label1)
to specify the label text.
Note: The label text must use characters that are compatible with the
locale of the data source. If the data source uses Unicode, then your
labels can contain characters from any locale.
c For each label group, specify the values that are associated with the
label.
Drag and drop values from the Values list onto the label group.
6 Click OK. The new custom category is displayed in the Data pane.
1 In the expression editor, right-click the Parameter heading in the Data Items
list, and then select Create Parameter.
3 Specify the Type for the parameter. You can select either Numeric or
Character.
4 For character parameters, specify the Current value for the parameter.
For numeric parameters, specify the following:
Minimum value
specifies the minimum possible value for the parameter.
Maximum value
specifies the maximum possible value for the parameter.
124 Chapter 24 / Managing Data
Current value
specifies the current value for the parameter.
Format
specifies the data format for the parameter.
6 Finish editing your item. If you close the expression editor window without
saving, then your new parameter is not saved.
1 On the Parameters tab, select the drop-down list for the parameter, and
then select Edit.
2 For character parameters, specify the Current value for the parameter.
For numeric parameters, specify the following:
Minimum value
specifies the minimum possible value for the parameter.
Maximum value
specifies the maximum possible value for the parameter.
Current value
specifies the current value for the parameter.
Format
specifies the data format for the parameter.
2 In the Data Items list, right-click the parameter that you want to delete, and
then select Delete Parameter.
Note: You can delete a global parameter only if it is not used by any filters,
calculated items, or aggregated measures.
Note: If you close the expression editor window without saving, then the
parameter is not deleted.
1 Select Data New Calculated Item. The New Calculated Item window
appears.
3 Select the data type for the calculated data item from the Result type drop-
down list.
Note: The data type is updated automatically based on the outermost
operator of your expression.
4 Build the expression for your calculated data item by dragging and dropping
data items, global parameters, and operators onto the expression in the right
pane. For each field in the expression, you can insert a data item, a global
parameter, an operator, or a specific value.
Note: You can double-click a data item in the Data Items pane to add it to
the first available parameter in the expression.
Note: Aggregated data items and derived data items are not supported for
calculation expressions.
When you drag and drop data items, global parameters, and operators onto
the expression, the precise location of the cursor determines where and how
the new element is added to the expression. As you drag the new element
over the expression, a preview appears, which displays how the expression
would change if you drop the element at the current location.
For example, if your current expression is ( Profit / Revenue ), and you
drag the x - y (subtract) operator over the open parenthesis symbol, then
the expression changes to ( [number] – ( Profit / Revenue )). If
126 Chapter 24 / Managing Data
you drag the operator over the division symbol, then the expression changes
to ( Profit – Revenue ).
There are a large number of operator types available to perform
mathematical functions, process datetime values, and evaluate logical
processing such as IF clauses. See Appendix 5, “Operators for Data
Expressions,” on page 583.
Note: You can also edit your expression as text. See “Editing a Data
Expression in Text Mode” on page 577.
5 When you are finished creating your expression, select the Default
aggregation for the calculated data item, and then click Select to choose the
data format.
6 Click Preview to see a preview of the calculated data item as a table. The
table displays the values of the calculated item and any data items that are
part of the calculation expression.
7 Click OK to create the new calculated data item. The new data item appears
in the Data Items pane.
3 Build the expression for your aggregated measure by dragging and dropping
data items, global parameters, and operators onto the expression in the right
pane. For each field in the expression, you can insert a data item, a global
parameter, an operator, or a specific value.
Note: You can create a new calculated item to use in the aggregated
measure expression. Click New Calculated Item to create the new calculate
item.
Creating Aggregated Measures 127
When you drag and drop items, global parameters, and operators onto the
expression, the precise location of the cursor determines where and how the
new element is added to the expression. As you drag the new element over
the expression, a preview appears, which displays how the expression would
change if you drop the element at the current location.
There are a large number of operator types available to perform
mathematical functions and evaluate logical processing such as IF clauses.
See Appendix 5, “Operators for Data Expressions,” on page 583.
Note: You can also edit your expression as text. See “Editing a Data
Expression in Text Mode” on page 577.
6 When you are finished creating your expression, click Select to choose the
data format.
7 Click OK to create the new aggregated measure. The new data item appears
in the Data Items pane.
n Crosstab
n Bar Chart
n Line Chart
n Treemap
n Geo Map
sales for the current month and sales for the same month of the previous
year.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Percent Difference from Previous Period
Displays the percentage difference between the value for the current time
period and the value for the previous time period. For example, you might
derive the percentage difference between sales for the current month and
sales for the previous month.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Percent of Subtotals
For crosstabs only, displays the percentage of the subtotal value for the
measure on which it is based.
You can select whether to calculate the percentage of the subtotal value for
the rows in the crosstab or for the columns in the crosstab.
For example, you might calculate the percentage of the row subtotal value for
a measure that contains revenue values. The derived item displays the
percentage of the subtotal of revenues for each row in the crosstab.
Note: Percent of Subtotals can be created only from within a crosstab
visualization.
Percent of Total
Displays the percentage of the total value for the measure on which it is
based. For example, you might derive the percentage of the total value for a
measure that contains revenue values. If you create a bar chart by using the
derived item and a category that contains products, then the bar chart shows
the percentage of total revenue for each product.
Note: The percentage of the total value is relative to the subset of data that
is selected by your filters and ranks.
Period to Date
Displays the aggregated value for the current time period and all of the
previous time periods within a larger time interval. For example, you might
derive the year-to-date total for each month.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Year over Year Growth
Displays the percentage difference between the current time period and an
equivalent time period from the previous year. For example, you might derive
the difference in sales between the current month and the same month of the
previous year.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Year to Date
Displays the aggregated value for the current time period and all of the
previous time periods within the year. For example, you might derive the
year-to-date total for each month.
The year-to-date calculation subsets the data for each year using today’s
date (where today is evaluated each time you view the exploration). To use
130 Chapter 24 / Managing Data
all data for every period, use a Period to Date item or edit the expression for
the derived item.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Year to Date Growth
Displays the percentage difference between the year-to-date value for the
current time period and the year-to-date value for the same time period of the
previous year. For example, you might derive the difference in year-to-date
sales between the current month and the same month of the previous year.
The year-to-date calculation subsets the data for each year using today’s
date (where today is evaluated each time you view the exploration). To use
all data for every period, use a Period to Date item or edit the expression for
the derived item.
Note: This derived item is not available if your data source does not contain
a date data item that includes the year.
Note: The derived item types that aggregate values over time use periodic
operators. For information about using periodic operators, see “Periodic
Operators” on page 591.
n Crosstab
n Bar Chart
n Line Chart
Editing a Calculated, Aggregated, or Derived Data Item 131
n Network Diagram
n Geo Map
n Treemap
Add an Operator
To add an operator to the expression:
1 From the Operators list, select the operator that you want to add. For a list of
the operators that are available, see Appendix 5, “Operators for Data
Expressions,” on page 583.
3 For any required parameters, select the parameter, and enter a value. Or,
right-click the parameter field, and select Replace with to select a data item
or a global parameter.
Replace an Operator
To replace an operator, drag and drop a new operator onto the existing operator
in the expression. You can also right-click an operator in your expression, and
select Replace Operator with operator.
Subset an Expression
To subset an expression and delete the remainder:
2 Right-click, and select Keep Operand. The parts of the expression that were
not selected are removed.
use the Minimum and Maximum aggregations for a data item in the same
visualization.
Here are the steps to duplicate a data item:
1 Right-click on a measure in the Data pane, and then select Duplicate Data
Item. The New Duplicate Item window appears.
Note: You can also invoke the New Duplicate Item window by dragging and
dropping the same data item onto a visualization more than once.
2 Enter a Name, a Format, and a Default aggregation for the duplicate data
item.
2 Right-click the category, select Geography, and then select the role type.
The role type can be any of the following:
Country or Region Names
specifies countries or regions by name.
Defining a Geography Data Item 135
Latitude
specifies a measure from your current data source that contains the
latitude (Y) coordinate values for the geographic role that you want to
define.
Longitude
specifies a measure from your current data source that contains the
longitude (X) coordinate values for the geographic role that you want to
define.
136 Chapter 24 / Managing Data
Coordinate Space
specifies the coordinate space (coordinate system) that is used to project
the longitude and latitude coordinate values.
1 Specify a data item as the unique row identifier for the exploration. You can
choose a category, a measure, or a calculated item. The unique row identifier
must have a unique value for each row of the data source.
TIP To determine whether the values of a category are unique, assign the
category to a bar chart with no measures. If the frequency of any value is
greater than one, then the category values are not unique. To determine
whether the values of a measure are unique, open the Measure Details
window, and then compare the Total Rows and Distinct Count statistics.
If the statistics are identical, then the measure values are unique.
Right-click the data item in the Data pane, and then select Set as Unique
Row Identifier.
Note: A nonunique row identifier can produce unreliable results.
2 Assign one or more categories to the Document Collection data role. Right-
click a category, and then select Document Collection.
Note: A document collection can be used in your visualizations the same
way a category is used.
137
25
Working with Visualizations
Overview of Visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
About Visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Visualization Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Working with Visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Create a New Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Manage Visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Arrange the Visualizations in the Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Use the Manage Visualizations Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Display Detailed Data for a Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Change the Data Source for a Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Control Visualization Data Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Manage Visualization Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Managing Visualization Data Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Add a Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Replace a Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Remove a Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Switch Data Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Work with Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Ranking Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Overview of Ranking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Create a New Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Delete a Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Managing Visualization Axes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Lock an Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Adjust an Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Transfer Axis Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Working with Visualization Data Ranges and Color Gradients . . . . . . . . . . . . . . 153
Support for Customized Data Ranges and Color Gradients . . . . . . . . . . . . . . . . . 153
Specify a Custom Color Gradient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Specify a Custom Data Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Share a Color Gradient and Data Range between Visualizations . . . . . . . . . . . . 154
Remove Customized or Shared Color Data Ranges . . . . . . . . . . . . . . . . . . . . . . . . 155
Working with Data Brushing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Overview of Data Brushing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Enable Data Brushing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
138 Chapter 25 / Working with Visualizations
Overview of Visualizations
About Visualizations
SAS Visual Analytics Explorer (the explorer) displays data by using
visualizations. A visualization is an interactive visual representation of your data.
Visualization Types
You can assign any of the following types to your visualizations:
If SAS Visual Statistics is licensed at your site, then the following modeling
visualizations are available:
n Linear Regression
n Logistic Regression
n Cluster
For more information, see Chapter 33, “Modeling Information,” on page 249.
Manage Visualizations
Delete a Visualization
To delete a visualization, click the button on the visualization, or select
Visualization Delete from the menu bar to delete the selected visualization.
You can delete all of your visualizations by selecting View Delete All
Visualizations.
Duplicate a Visualization
To duplicate a visualization, select Visualization Duplicate from the main
menu, or select the drop-down list from the visualization toolbar, and then
select Duplicate.
Working with Visualizations 147
Maximize a Visualization
To maximize a visualization to fill the entire workspace, click in the
visualization that you want to maximize. To return the visualization to its normal
size, click .
Resize a Visualization
To resize a visualization in your workspace, drag the resizing tab at the
bottom edge or the right edge of the visualization that you want to resize.
The Manage Visualizations window enables you to perform the following tasks:
Task Action
Add visualizations to the selection list. Select a visualization from the Available
(Restore visualizations.) list, and then click , or click to add
all of the available visualizations.
Remove visualizations from the selection Select a visualization from the Selected
list.
list, and then click , or click to
(Minimize visualizations.) remove all of the visualizations.
Change the order of the selected In the Selected list, drag and drop the
visualizations. visualizations in the order that you want,
or select a visualization and click the up
and down arrows to move it.
For an empty visualization with no data items, ranks, or visualization filters, you
can add a data item from any data source. The new data source is assigned to
the visualization automatically.
To change the data source for a visualization that is not empty, follow these
steps:
1 If the data source that you want to use is not part of the exploration, then add
the new data source. See “Add Additional Data Sources to Your Exploration”
on page 120.
2 Select the visualization for which you want to change the data source.
3 Remove any ranks from the Ranks tab and any visualization filters from the
Filters tab.
4 On the Roles tab, remove all data items from the data roles.
5 From the Data source drop-down list, select the data source for the
visualization.
n Drag and drop the data item onto a Measure or Category button in the
visualization to assign the data item to a specific data role.
n From the visualization toolbar, select the drop-down list, and then select
Add Category or Add Measure.
n Use the Roles tab in the right pane. Either drag and drop a data item onto a
role, or expand the drop-down list beside the role and then select a data
item.
Each visualization requires a minimum number of each type of data item. The
following table lists the requirements for each visualization:
n Select the drop-down list from the visualization toolbar, and then select
Remove item-name .
n Right-click on the data item that you want to delete in either the visualization
or on the Roles tab, and then select Remove item-name.
Ranking Data
Overview of Ranking
You can use the Ranks tab to create ranks to subset the data in your
visualizations. A rank selects either the top (greatest) or the bottom (least)
aggregated value for a category.
A rank selects values for a category based on either the frequency of the
category values or the aggregated value of a measure.
For example, you might create a rank of the top 10 countries by frequency to
select the 10 countries that are most represented in your data source. As
152 Chapter 25 / Working with Visualizations
another example, you might create a rank of the top 10 countries by population
to select the 10 countries with the greatest population.
Note: If the category for the rank is part of a hierarchy that is used in the current
visualization, then the rank is applied only when the hierarchy is drilled to the
level of the rank category.
1 From the Data pane, select the data item that you want to use as the base of
the rank. You can select any category or geography data item, regardless of
whether it is assigned to the current visualization.
2 Either right-click on the data item, and select Add as Rank on Visualization,
or drag and drop the data item onto the Ranks tab.
a Select the type of rank from the drop-down list. Top specifies that the
rank selects the greatest value. Bottom specifies that the rank selects the
least value.
b Specify the number of values for the rank. For example, if you specify 5,
and you select Top as the rank type, then the rank selects the five
greatest values.
c From the By drop-down list, select the measure that is used to create the
rank. You can either select any measure, or select Frequency to use the
frequency of the rank category.
Note: If you select a measure that is used in the current visualization,
then the rank uses the same aggregation for the measure that is used by
the current visualization.
Note: Only the Sum, Average, Count, Minimum, and Maximum
aggregation types can be used in a rank.
Note: By default, your rank changes are applied automatically to the current
visualization. To apply multiple changes together, deselect Auto-Update, and
then click Update when you are ready to apply your rank changes.
Working with Visualization Data Ranges and Color Gradients 153
Delete a Rank
To delete a rank, click on the rank on the Ranks tab.
Lock an Axis
By default, the axes of your visualizations adjust automatically to your data. If
you change the data that is displayed by applying filters or ranks or by drilling
down, then the data ranges and scaling of your axes will change to fit the data.
For comparison purposes, you might want to lock the axes and retain the same
data ranges and scaling. To lock an axis, click the icon beside the axis
heading.
To re-enable automatic adjustments for an axis, click the icon beside the axis
heading.
Adjust an Axis
For a locked axis, you can adjust the visible data range. You can adjust the
range by dragging the scroll bar that appears over the axis tick marks or by right-
clicking a measure heading, and then selecting Set Visible Axis Range.
n Network diagram (with the Node Color or Link Color role assigned)
1 Right-click on the color gradient in the legend, and then select Edit Color
Gradient.
2 From the Edit Color Gradient window, select a color gradient from the Color
gradient drop-down list.
1 Right-click on the color gradient in the legend, and then select Configure
Color Gradient.
3 In the Lower field, specify the lower bound for the data range.
4 If the selected color gradient uses three colors, specify the inflection point of
the gradient in the Inflection field, or select Use midpoint to use the
midpoint between the lower and upper values as the inflection point. The
inflection point is the point for the middle color in a three-color gradient.
5 In the Upper field, specify the upper bound for the data range.
1 If the data range has not been customized, then right-click on the legend for
the color gradient and data range that you want to share, and then select
Lock Data Range.
2 Right-click on the legend for the color gradient and data range that you want
to share, and then select Transfer Configuration. The Select compatible
visualizations window appears.
Working with Data Brushing 155
3 Select the visualizations that you want to share the color gradient and data
range with. The visualizations are sorted based on their similarity to the
source visualization. Visualizations that use the same data items and
visualizations that are the same type are shown at the top of the list.
4 When you are finished, click OK to apply the color gradient and data range to
all of the selected visualizations.
n Line chart
156 Chapter 25 / Working with Visualizations
n Scatter plot
n Network diagram
n Histogram
n Geo map
n Treemap
n Word cloud
For histograms and for bar charts of frequency that are not grouped or latticed,
data brushing can indicate the portion of a bar that corresponds to the brushed
data. The bar is highlighted and then partially shaded to indicate the
corresponding portion. The value for the shaded portion of the bar is included in
the data tip for the bar.
In Figure 25.2 , a selection in a bubble plot highlights a portion of the
corresponding bar in a bar chart.
For bar charts that have a measure assigned or that are grouped or latticed, the
entire bar is highlighted.
n Click the data values. This is most useful for bar charts, histograms, and
treemaps. To select multiple data values, hold down the Ctrl key while
clicking each data value.
n Click and drag to select data values in a rectangular region. This is most
useful for scatter plots and heat maps.
n Select data values in the details table for the visualization. Press Shift+click
to select multiple adjacent values, or press Ctrl+click to select or deselect
individual values.
Note: The Roles tab for an automatic chart always contains Categories and
Measures. To set advanced data roles such as grouping and lattices, click the
Use chart-type link on the Roles tab to change the visualization from an
automatic chart to the chart type that is currently shown. For example, if your
automatic chart shows a bar chart, then click Use Bar Chart to change the type
to a bar chart and enable advanced data role settings.
158 Chapter 25 / Working with Visualizations
About Tables
A table displays data as text. The data value for each measure or category that
is assigned to the table is displayed as a column. The data values in the table
are not aggregated.
Note: For very large data sources, the table visualization displays only the first
two billion (2,147,483,647) rows.
Managing Columns
Sort Columns
By default, the table is sorted by the values of the first column. To change the
sorting, click on the heading for the column that you want to sort by. An arrow
appears in the column heading to indicate the sorting. If the arrow points
upward, then the sort is ascending. If the arrow points downward, then the sort is
descending.
Rearrange Columns
To rearrange your columns, drag and drop the column headings.
Resize Columns
To resize a column, click, and then drag and drop the left or right edge of a
column heading.
Working with Crosstabs 159
About Crosstabs
A crosstab displays the intersections of category values and measure values as
text. If the crosstab contains measures, then each cell of the crosstab contains
the aggregated measure values for a specific intersection of category values. If
the crosstab does not contain measures, then each cell of the crosstab contains
the frequency of an intersection of category values.
Totals Placement
specifies the location of totals and subtotals. Select Before to place the totals
and subtotals before the axis headings. Select After to place the totals and
subtotals after the axis headings.
Note: For the indented layout, totals are always placed before the axis
headings.
Resize Columns
To resize a column, click, and then drag and drop the left or right edge of the
column heading.
the response axis. If a bar chart contains no measures, then the frequency of the
category values is plotted on the response axis.
In addition to the basic data roles, you can assign these roles:
Group
groups the data based on the values of the category data item that you
assign. Depending on the value that you selected for the Grouping style
property, the group values are shown as either individual bars or as
segments of each bar.
Note: Grouping is not available if you assign multiple measures to the
visualization.
Lattice columns
creates a lattice of charts with a column for each value of the category data
item that you assign.
Lattice rows
creates a lattice of charts with a row for each value of the category data item
that you assign.
Measure layout
specifies whether the measures share a single response axis (Shared axis)
or have separate response axes for each measure (Separate axes).
Note: The Measure layout option is disabled if your visualization contains
exactly one measure.
Overview
specifies whether the chart overview is enabled.
Show data labels
shows the data values as text in the visualization.
Note: You can always view a data value as a data tip when you position the
cursor over a data value.
Rotate axis labels
displays the category labels at an angle.
Note: The Rotate axis labels option has no effect when you select a
horizontal bar orientation.
Reference Lines
adds reference lines to the visualization. To create a reference line, click ,
and then specify the parameters for the line in the New Reference Line
window.
The name of each reference line appears below the Reference Lines option.
You can edit or delete your reference lines by using the icons next to each
name.
the response axis. If the line chart contains no measures, then the frequency of
the category values is plotted on the response axis.
In addition to the basic data roles, you can assign these roles:
Group
groups the data based on the values of the category data item that you
assign. A separate line is created for each data value.
Note: Grouping is not available if you assign multiple measures to the
visualization.
Lattice columns
creates a lattice of charts with a column for each value of the category data
item that you assign.
Lattice rows
creates a lattice of charts with a row for each value of the category data item
that you assign.
Forecasting
enables forecasting for the line chart. Forecasting estimates future values for
your data based on statistical trends.
Note: Forecasting is available only if a date or datetime data item is
assigned to the visualization.
Underlying factors
if forecasting is enabled, adds additional measures to the forecast as
underlying factors. The forecasting model evaluates the additional measures
to determine whether they contribute to the accuracy of the forecast. If the
additional measures do not increase the accuracy of the forecast, then they
are not used. If the additional measures do increase the accuracy of the
forecast, then the forecast line is adjusted, and the confidence bands are
narrowed.
The measures that you add as underlying factors can also be used in a
scenario analysis.
Note: Underlying factors are available only if your line chart contains a
single measure in the Measures role.
Frequency
specifies whether the frequency is displayed as a count (Count) or as a
percentage (Percent).
Note: The frequency values are based on the data that is shown in the
visualization (after filters and other data selections have been applied).
Note: This option has no effect if a measure is assigned to the visualization.
Measure layout
specifies whether the measures share a single response axis (Shared axis)
or have separate response axes for each measure (Separate axes).
Note: The Measure layout option is disabled if your visualization contains
exactly one measure.
Overview
specifies whether the chart overview is enabled.
Show markers
shows markers for the data points in the visualization.
Show data labels
shows the data values as text in the visualization.
Note: You can always view a data value as a data tip when you position the
cursor over a data value.
Thin data labels
removes data labels as necessary to avoid overlap. The thinning algorithm
retains the labels for local high points and low points on the line chart.
Rotate axis labels
displays the category labels at an angle.
Reference Lines
adds reference lines to the visualization. To create a reference line, click ,
and then specify the parameters for the line in the New Reference Line
window.
The name of each reference line appears below the Reference Lines option.
You can edit or delete your reference lines by using the icons next to each
name.
Duration (if forecasting is enabled)
specifies the number of data intervals to forecast.
Note: This option is available only if forecasting is enabled for the
visualization.
Confidence (if forecasting is enabled)
specifies the degree of confidence for the confidence band. The default value
is 95%.
Forecasting
About Forecasting
Forecasting uses the statistical trends in your data source to predict future data
values. Forecasting is available only if a date or datetime data item is assigned
to the visualization.
In addition to the predicted future data values, the forecast displays a confidence
band. For more information, see “Forecasting” on page 227.
Enable Forecasting
To add forecasting to a line chart, select Forecasting on the Roles tab.
Note: The line chart must contain a date or datetime data item to apply
forecasting.
On the Properties tab for the line chart, you can adjust the number of data
values to predict by using the Duration option. You can specify the degree of
confidence for the confidence band by using the Confidence option.
On the Roles tab, you can add additional measures to the forecast as
Underlying factors. The forecasting model evaluates the additional measures
to determine whether they contribute to the accuracy of the forecast. If the
additional measures do not increase the accuracy of the forecast, then they are
not used. If the additional measures do increase the accuracy of the forecast,
then the forecast line is adjusted, and the confidence bands are narrowed.
Note: Underlying factors are available only if your line chart contains a single
measure in the Measures role.
The measures that you use as underlying factors can also be used in scenario
analysis and goal seeking. For more information, see “Working with Scenario
Analysis and Goal Seeking” on page 228.
Correlation
identifies the degree of statistical correlation between the variables in the
visualization. For more information, see “Correlation” on page 225.
Fit Line
plots a model of the relationship between the variables in the visualization.
There are many types of fit lines, including linear fit, quadratic fit, cubic fit,
and penalized B-spline. For more information, see “Fit Lines” on page 226.
Correlation is applied to your visualization automatically when you add a linear fit
line. It is not available with other fit types.
Note: You cannot assign both the Group role and the Color role at the
same time.
Animation
specifies a datetime data item that is used to animate the bubble plot.
Note: The Animation role is enabled only if you assign a data item to the
Group role.
Lattice columns
creates a lattice of charts with a column for each value of the category data
item that you assign.
Lattice rows
creates a lattice of charts with a row for each value of the category data item
that you assign.
Note: This option has no effect if a measure is assigned to the Bubble size
role.
Color gradient
selects the gradient colors for the visualization.
You can click to select the values that are used to assign the colors. See
“Specify a Custom Data Range” on page 154.
Reference Lines
adds reference lines to the visualization. To create a reference line, click ,
and then specify the parameters for the line in the New Reference Line
window.
The name of each reference line appears below the Reference Lines option.
You can edit or delete your reference lines by using the icons next to each
name.
3 Assign a data item with a datetime format to the Animation data role.
Task Action
Task Action
Track the movement of a specific bubble. Click the bubble that you want to track.
Note: If you select a bubble to track, the selected bubble is highlighted in the
current animation frame.
MGR1 75000
Move Nodes
You can move any node in the diagram by clicking the node and dragging it. You
can move multiple nodes in the diagram by selecting the nodes that you want to
move and dragging them.
Note: The positions of the nodes in your diagram are saved with your
exploration.
n Hold down the Ctrl key and click the nodes that you want to select.
1 Nodes contain the events in each path. The node displays the width of each
link that enters and exits the node. The same event can appear at multiple
nodes in the diagram.
2 Links between nodes make up the paths in the diagram. The width of each
link can represent either the frequency of the path or the value of a weight
measure.
Working with Sankey Diagrams 175
3 Drop-off links are links that end at the current node. Drop-off links are
displayed only if some links continue onward from the current node.
Note: If the measure that is assigned to the Weight role has an aggregation
other than SUM or COUNT, then the node width labels in the diagram might
be misleading. It is recommended that you disable the Show nodes option if
your Weight measure has an aggregation other than SUM or COUNT.
Note: For all of the options under Path Analytics, click to apply your
changes.
178 Chapter 25 / Working with Visualizations
3 From the Events drop-down list, select the events for the condition.
TIP You can create a condition for the path selection when only the Event
role is assigned to the visualization. For large data sources, you might want to
create your path selection before assigning all of the data roles to avoid long
loading times.
2 Click the drop-down list, and then select either Include Only or Exclude,
and then select the condition type. The condition type can be any of the
following:
Paths Containing All the Selected Nodes
includes or excludes paths that contain all of the selected nodes. This
condition type is based on specific nodes in the diagram, rather than the
event values.
Working with Sankey Diagrams 179
The new condition appears on the Path Selection tab of the details table.
1 Open the details table for your visualization by clicking the drop-down list
from the visualization toolbar, and then selecting Show Details.
Include Only
includes only the paths that satisfy the condition.
Exclude
excludes the paths that satisfy the condition.
1 Open the details table for your visualization by clicking the drop-down list
from the visualization toolbar, and then selecting Show Details.
3 To remove specific conditions, select the conditions that you want to remove,
right-click one selected condition, and select Remove Selected Conditions.
To remove all of the conditions, right-click any condition, and select Remove
All Conditions.
n On the Path Selection tab of the details table, right-click a condition, and
then select Create Visualization from All Conditions. All of the conditions
in your path selection are used to filter the data in your new visualization.
n In the Sankey diagram, select one or more nodes, click the drop-down
list, select Create New Visualization, and select a condition for your path
selection. For more information, see “Create a New Condition from Selected
Nodes” on page 178.
The new condition and any existing conditions are all used to filter the data in
your new visualization.
The new visualization appears as a bar chart of the data item assigned to the
Transaction Identifier role. A visualization filter selects all of the transaction
identifier values that correspond to your path selection. If your Sankey diagram
includes a weight measure, then the weight measure also appears in the bar
chart.
Note: You can perform any standard visualization tasks with the new
visualization. For example, you can add data items and change the visualization
type.
To display the overview, click the drop-down list from the visualization toolbar,
and then select Show Overview.
n scroll the mouse wheel over the visualization to zoom in or zoom out at the
location of the cursor
n When you have zoomed in on a diagram and scroll bars are displayed,
reposition your zoomed view by holding down the Shift and Alt keys and
dragging the diagram.
Working with Histograms 181
About Histograms
A histogram displays the distribution of values for a single measure. A series of
bars represents the number of observations in the measure that match a specific
value or value range. The bar height can represent either the exact number of
observations or the percentage of all observations for each value range.
Note: If you use the default number of bins, then the minimum and maximum
values on the histogram axis might not match the actual extent of your data
values. If you specify the number of histogram bins, then the histogram axis
matches your data values exactly.
Reference Lines
adds reference lines to the visualization. To create a reference line, click ,
and then specify the parameters for the line in the New Reference Line
window.
The name of each reference line appears below the Reference Lines option.
You can edit or delete your reference lines by using the icons next to each
name.
Figure 25.5 on page 182 shows a diagram of a box plot. The bottom and top
edges of the box indicate the interquartile range (IQR). That is, the range of
values that are between the first and third quartiles (the 25th and 75th
percentiles). The marker inside the box indicates the mean value. The line inside
the box indicates the median value.
You can enable outliers, which are data points whose distances from the
interquartile range are greater than 1.5 times the size of the interquartile range.
The whiskers (lines protruding from the box) indicate the range of values that are
outside of the interquartile range. If you do not enable outliers, then the whiskers
extend to the maximum and minimum values in the plot. If you enable outliers,
then the whiskers indicate the range of values that are outside of the
interquartile range, but are close enough not to be considered outliers.
If there are a large number of outliers, then the range of outlier values is
represented by a bar. The data tip for the bar displays additional information
about the outliers. To explore the outliers, double-click on the outlier bar to view
the values as a new histogram visualization.
Working with Box Plots 183
Hide Outliers
includes the outliers within the whiskers. If you select this option, then
outlier values are not represented differently from the other values in the
plot.
Show Outliers
displays outliers separately from the whiskers. If there are a small number
of outliers, then each outlier is displayed as a point. If there are a large
number of outliers, then the range of outlier values is displayed as a bar.
Show averages
displays the mean value as a marker inside the box.
Rotate axis labels
displays the category labels at an angle.
Note: The Rotate axis labels option has no effect if the box plot contains no
categories.
Reference Lines
adds reference lines to the visualization. To create a reference line, click ,
and then specify the parameters for the line in the New Reference Line
window.
The name of each reference line appears below the Reference Lines option.
You can edit or delete your reference lines by using the icons next to each
name.
Name
specifies the name of the visualization.
Title
specifies the title that appears above the graph.
Note: The Title option is disabled if you select Generate graph title.
Generate graph title
specifies that the graph title is generated automatically based on the data
items in the visualization.
Bin count
specifies the number of value ranges that are represented as cells. Bin
count affects only measures.
Show borders
specifies that the borders between cells are visible.
Rotate axis labels
displays the category labels at an angle.
Note: The Rotate axis labels option affects only the values on the X axis.
Note: The Rotate axis labels option has no effect if the heat map contains
no categories.
Color gradient
selects the gradient colors for the visualization.
You can click to select the values that are used to assign the colors. See
“Specify a Custom Data Range” on page 154.
Fit line
adds a fit line to the heat map. For information about the fit types that are
available, see “Fit Lines” on page 226.
Note: Fit lines are not available if a category is assigned to the heat map.
for the Bubbles map style, specifies a measure that determines the bubble
color.
You can click to select the values that are used to assign the colors. See
“Specify a Custom Data Range” on page 154.
Transparency
specifies the amount of transparency for the data overlay.
188 Chapter 25 / Working with Visualizations
n scroll the mouse wheel to zoom in or zoom out at the location of the cursor
About Treemaps
A treemap displays a hierarchy or a category as a set of rectangular tiles. Each
tile represents a category value or a hierarchy node. The size of each tile
represents either the frequency count or the value of a measure. If you assign a
measure to the Color role, then the color of each tile represents the value of that
measure.
Name
specifies the name of the visualization.
Title
specifies the title that appears above the graph.
Note: The Title option is disabled if you select Generate graph title.
Generate graph title
specifies that the graph title is generated automatically based on the data
items in the visualization.
Show data labels
shows a text label for each tile in the treemap.
Frequency
specifies whether the frequency values are displayed as the number of
values (Count) or as the percentage of values (Percent).
Arrangement
specifies the layout of the tiles in the treemap. Select one of the following
values:
Standard
arranges the tiles into squares, with the largest tiles generally at the
bottom left.
Flow
arranges the tiles from largest to smallest, with the largest tile at the top
left.
Toggle
arranges the tiles into a single row or column, with the largest tile on the
left or at the top.
The orientation of the tiles alternates between hierarchy levels. The top
level is arranged as a row, the second level is a column, and so on.
Additional levels
specifies the number of levels that are displayed beneath the current level.
Color gradient
selects the gradient colors for the visualization.
You can click to select the values that are used to assign the colors. See
“Specify a Custom Data Range” on page 154.
Each branch of the tree displays the name of the predictor for the branch at the
top of the split. The thickness of the branch indicates the number of values that
are associated with each node. The predictor values for each node are
displayed above the node.
Each node in the tree displays the data for the node either as a histogram (if the
response contains continuous data) or as a bar chart (if the response contains
discrete data). The histogram or bar chart in each node displays the values of
the response data item that are selected by the splits in the tree. The number at
the top right of the node indicates the greatest value or frequency for the bar
chart or histogram. At the bottom of each node, the total number of data values
(count) for the node is displayed.
Below the decision tree, an icicle plot of the nodes is displayed. The color of the
node in the icicle plot indicates the predicted level for that node. When you
select a node in either the decision tree or the icicle plot, the corresponding node
is selected in the other location.
Working with Decision Trees 193
Decision trees in SAS Visual Analytics use a modified version of the C4.5
algorithm.
The details table for a decision tree contains two additional data columns, Node
ID and Parent ID. Node ID specifies a unique value for each node in the tree.
Parent ID specifies the ID of the parent node.
If you select Custom as the value for Growth strategy, then the following
additional options appear:
Maximum branches
specifies the maximum number of branches for each node split.
Maximum levels
specifies the maximum number of levels in the tree.
Leaf size
specifies the minimum number of values (count) for each node.
Response bins
specifies the number of bins that are used for the response data item.
Note: This option has no effect if the response data item contains discrete
data.
Predictor bins
specifies the number of bins that are used for predictor data items.
Note: This option has no effect if the predictor data items contain discrete
data.
Rapid growth
enables you to use the information gain ratio and k-means fast search
methods for decision tree growth. When disabled, the information gain and
greedy search methods are used, which generally produce a larger tree and
require more time to create.
Pruning
specifies the level of pruning that is applied to the tree. Pruning removes
leaves and branches that contribute the least to the predictive accuracy of
the tree. A more Lenient pruning value specifies that fewer leaves and
branches are removed from the tree. A more Aggressive pruning value
specifies that more leaves and branches are removed from the tree.
Reuse predictors
specifies that predictors can be used more than once in the tree.
The following parameter values are used for the Basic and Advanced growth
strategies:
Table 25.4 Parameter Values for the Basic and Advanced Growth Strategies
Maximum branches 2 4
Maximum levels 6 6
Leaf size 1 1
Response bins 10 10
Predictor bins 2 10
1 Select the drop-down list from the visualization toolbar, and then select
Derive a Leaf ID Variable.
2 In the New Calculated Item window, enter a Name for the new calculated
item.
n scroll the mouse wheel over the visualization to zoom in or out at the location
of the cursor
Note: If you zoom out on the decision tree, then each leaf node displays a
single bar for the greatest value in that node. To display a bar for each node in
196 Chapter 25 / Working with Visualizations
the tree, right-click an empty part of the decision tree, and then select Show
Branch Coloring.
When you have zoomed in on a decision tree and scroll bars are displayed, you
can reposition the decision tree by holding down the Shift and Alt keys and
dragging it.
n hold down the Shift key and drag the decision tree
values that have the highest frequency or the string values that have the
greatest value for a measure. The color of each word can indicate the value
of a measure.
Note: If you view the word cloud as an automatic chart, then any changes to the
Roles tab might cause the visualization to reset. It is recommended that you
view it as a word cloud.
You can click to select the values that are used to assign the colors. See
“Specify a Custom Data Range” on page 154.
For word clouds that use text analytics, you can specify the following additional
basic options:
Analyze document sentiment
enables sentiment analysis for the word cloud.
Sentiment analysis determines whether a document has a positive
sentiment, negative sentiment, or neutral sentiment based on the content of
the document.
When sentiment analysis is enabled, the number of positive, neutral, and
negative documents in the topic is displayed at the top of the word cloud. In
addition, sentiment values are displayed on the Topics and Documents tabs
of the details table.
Identify term roles
identifies terms by their parts of speech. In addition, this option identifies
groups of nouns as single terms and identifies text entities such as names,
addresses, telephone numbers, and so on.
Note: This option is equivalent to the advanced options Include parts of
speech, Extract noun groups, and Use entity extraction.
Maximum topics
specifies the maximum number of topics to create. Specify a number from 4
to 20.
For word clouds that use text analytics, you can specify the following additional
advanced options:
Analyze document sentiment
enables sentiment analysis for the word cloud.
Working with Word Clouds 199
1 Select the topic and the term that you want to explore.
2 On the Documents tab in the details table, select the documents that you
want to explore in a new visualization. To select all of the documents, right-
click any document, and then select Select All.
26
Working with Filters
About Filters in SAS Visual Analytics Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Managing Your Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Set the Scope of a Filter (Global or Local) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Collapse or Expand a Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Arrange Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Delete a Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Resize the Global Filters and Local Filters Areas . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Copy a Local Filter to Another Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Copy All Local Filters from the Current Visualization to Another Visualization 203
Copy a Local Filter to New Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Link a Global Filter to Another Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Working with Basic Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
About Basic Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Create a Basic Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Create a Basic Filter from a Data Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Edit a Filter By Using Visual Filter Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Edit a Basic Filter By Using the Edit Filter Window . . . . . . . . . . . . . . . . . . . . . . . . . 208
Reset a Basic Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Working with Advanced Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
About Advanced Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Create an Advanced Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Edit an Advanced Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Working with Data Source Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
About Data Source Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Create a Data Source Filter from a Global Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Create a New Data Source Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Edit a Data Source Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Delete a Data Source Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Editing a Filter Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Specify the Filter Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Edit a Parameter Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Add a Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Add an Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Replace an Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Add a Global Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Delete Part of an Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Subset an Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Edit an Expression as Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
202 Chapter 26 / Working with Filters
To set the scope of a filter, click the drop-down list for the filter on the Filters
tab, and then select Filter on data-source to make it a global filter or Filter on
Visualization to make it a local filter.
Note: If you change a global filter’s scope to local, then a local filter is created
for all of the visualizations in the exploration that use the selected data source.
Note: If local filters exist in your other visualizations for the same data item,
then changing a local filter to a global filter replaces those local filters. A
confirmation window enables you to continue or cancel.
Managing Your Filters 203
To collapse all of the filters in an area, click the drop-down list in the global
filters area or in the local filters area on the Filters tab, and then select Collapse
All Filters.
To expand all of the filters in an area, click the drop-down list in the global
filters area or in the local filters area on the Filters tab, and then select Expand
All Filters.
Arrange Filters
To arrange the filters in an area of the Filters tab, click the drop-down list in
the global filters area or in the local filters area and then select Arrange Filters.
In the Arrange Filters window, you can change the order of your filters.
Delete a Filter
To delete a filter, click beside the filter on the Filters tab, or click the drop-
down list for the specific filter, and then select Delete Filter.
You can delete all of the filters in an area by clicking the drop-down list in the
global filters area or in the local filters area on the Filters tab, and then selecting
Delete All Filters.
Note: If you delete a global filter, then the filter is removed from all of the
visualizations that use the selected data source.
To copy your filter, click the drop-down list for the filter on the Filters tab, and
then select Copy Filter to visualization-name.
To copy your filters, click the drop-down list for the local filters (Visualization)
area of the Filters tab, and then select Copy All Filters to visualization-
name.
To copy your filter, click the drop-down list for the filter on the Filters tab, and
then select Copy Filter to New Visualization to copy your filter to a new
blank visualization.
1 Create a global, basic filter or select an existing global, basic filter. See
“Create a Basic Filter” on page 205.
Note: You cannot link an advanced filter to another data source.
2 Click the drop-down list for the filter on the Filters tab, and then select
Link Filter to data-source. The Link Filters window appears.
Note: If the target data source has a different locale from your current data
source, then a message appears. A linked filter between data sources that
use different encodings might cause query errors.
3 Specify the New filter name, and select the Target data item.
The values for the original data item and the target data item are displayed.
For discrete data items, an asterisk marks any values that are identical
between the two data items.
4 Click OK to create the linked filter. The linked filter appears in the global
filters area of each visualization that uses any of the linked data sources.
Note: You can link a linked filter to additional data sources to filter all of the
linked data sources at once.
1 From the Data pane, select the data item that you want to use as the base of
the filter. You can select any data item, regardless of whether it is assigned to
the current visualization.
2 For a local filter, either right-click on the data item, and select Add as Filter
on Visualization, or drag and drop the data item onto the local filters area of
the Filters tab.
For a global filter, either right-click on the data item, and select Add as Filter
on data-source, or drag and drop the data item onto the global filters area of
the Filters tab.
Note: If a local filter exists for a data item in any of your visualizations, then
you cannot create a new global filter for that data item. Remove the local
filter, or change its scope to global. Similarly, if a global filter exists for a data
item, then you cannot create a local filter for that data item.
3 Set the parameters for your filter. You can use either visual filter controls or
the Edit Filter window .
Note: By default, your filter changes are applied automatically to the active
visualization. To apply multiple changes together, deselect Auto-Update, and
then click Update when you are ready to apply your filter changes.
Note: If your data contains a large number of discrete values, then the top
1,000 most frequent values are displayed.
For data items that use the discrete data model, the filter displays all of the
distinct values for the data item. To the right of each value, a bar indicates the
frequency.
Use the check boxes next to each value to select the values for the filter. You
can search for a value in the displayed list by clicking . Enter a text string in
the field. The search locates values from the displayed list that begin with your
text string.
Select All to select or deselect all of the values. If the filter displays the top 1,000
most frequent values, then select Include unlisted values to select the unlisted
values.
To invert your selection, click the drop-down list, and then select Invert
Selection.
You can sort the values by frequency or alphabetically by value. Click the
drop-down list, and then select Sort by Frequency or Sort by Values.
To display the selected values at the top of the list, click the drop-down list,
and then select Show Selected at Top.
If your data item contains more than 1,000 discrete values, then you can exclude
the unlisted values by deselecting Include unlisted values.
If your data item contains missing values, then you can exclude missing values
by deselecting Include missing values.
Working with Basic Filters 207
For measures that use the continuous data model, the filter shows the range of
data values as a histogram. Sliders at each side of the histogram enable you to
select the data that is selected by the filter.
The visual filter can select data by using different filter conditions. By default, the
Between (Inclusive) condition is used. To change the condition for your filter,
click the drop-down list, select Condition Type, and then select the
condition. Select one of the following conditions:
Between (Exclusive)
specifies that a matching value must be in the range between the lower
bound and the upper bound. Matching values do not include the bounding
values.
Between (Inclusive)
specifies that a matching value must be in the range between the lower
bound and the upper bound. Matching values can include the bounding
values.
Equal To
specifies that a matching value must be equal to the value specified by the
filter.
Greater Than
specifies that a matching value must be greater than the value specified by
the filter.
Greater Than or Equal To
specifies that a matching value must be greater than or equal to the value
specified by the filter.
Less Than
specifies that a matching value must be less than the value specified by the
filter.
Less Than or Equal To
specifies that a matching value must be less than or equal to the value
specified by the filter.
Not Between (Exclusive)
specifies that a matching value must be outside the range between the lower
bound and the upper bound. Matching values do not include the bounding
values.
208 Chapter 26 / Working with Filters
If your data item contains missing values, then you can exclude the missing
values by deselecting Include missing values.
To invert your selection, click the drop-down list, and then select Invert
Selection.
By default, your filter changes are applied automatically to the active
visualization. To apply multiple changes together, deselect Auto-Update at the
bottom of the Filters tab, and then click Update when you are ready to apply
your filter changes.
2 Click the drop-down list for the filter that you want to edit, and then select
Edit Filter. The Edit Filter window appears.
3 Edit the expression for the filter. For more information, see “Editing a Filter
Expression” on page 211.
You can reset all of your filters by clicking the drop-down list in the global
filters area or the local filters area of the Filters tab, and then selecting Reset
All Filters.
Working with Advanced Filters 209
1 Click the drop-down list in the global filters area or in the local filters area
of the Filters tab, and then select New Advanced Filter. The Edit Filter
window appears.
2 Specify a Filter name. The filter name identifies the advanced filter on the
Filters tab.
3 Build the expression for your filter by dragging and dropping data items,
global parameters, conditions, and operators onto the expression.
For information about the conditions and operators that are available, see
Appendix 6, “Conditions for Filters,” on page 607 and Appendix 5, “Operators
for Data Expressions,” on page 583 .
You can also build your expression as text by using the Text tab. See
“Editing a Data Expression in Text Mode” on page 577.
2 Click the drop-down list for the filter that you want to edit, and then select
Edit Filter. The Edit Filter window appears.
3 Edit the expression for the filter. For more information, see “Editing a Filter
Expression” on page 211.
210 Chapter 26 / Working with Filters
n An exploration can contain only one data source filter for each data source.
1 On the Filters tab, select the global filter that you want to convert.
2 Click the drop-down list, and select Convert to Data Source Filter. The
global filter disappears from the Filters tab.
Note: If your exploration already contains a data source filter for the selected
data source, then the global filter is appended to the filter expression using the
AND operator.
You can convert all of your global filters together into a single data source filter
by clicking the drop-down list in the global filters area of the Filters tab, and
then selecting Convert All to Data Source Filter. The expressions from the
global filters are joined with AND operators.
To view the data source filter settings, select Data Data Source Details from
the main menu. The data source filter settings are displayed in the Data source
filter field.
1 In the Data pane, select the data source that you want to filter.
Note: If the current exploration contains an existing data source filter, then
select Edit Data Source Filter to add conditions to the existing data source
filter.
The Edit Filter window appears.
Editing a Filter Expression 211
3 Build the expression for your filter by dragging and dropping data items,
global parameters, conditions, and operators onto the expression.
For information about the conditions and operators that are available, see
Appendix 6, “Conditions for Filters,” on page 607 and Appendix 5, “Operators
for Data Expressions,” on page 583 .
You can also build your expression as text by using the Text tab. See
“Editing a Data Expression in Text Mode” on page 577.
1 In the Data pane, select the data source that you want to filter.
3 Edit the expression for the filter. For more information, see “Editing a Filter
Expression” on page 211.
1 In the Data pane, select the data source for which you want to remove the
filter.
Add a Condition
To add a new condition:
1 From the Data items list, select the data item on which the condition is
based.
2 From the Conditions list, select a condition. For a list of the conditions that
are available, see Appendix 6, “Conditions for Filters,” on page 607.
4 For any required parameters, select the parameter, and enter a value, or
right-click the parameter field, and select Replace with to select a data item.
Add an Operator
To add an operator to the expression:
1 From the Operators list, select the operator that you want to add. For a list of
the operators that are available, see Appendix 5, “Operators for Data
Expressions,” on page 583.
3 For any required parameters, select the parameter, and enter a value. Or,
right-click the parameter field, and select Replace with to select a data item.
Replace an Operator
To replace an operator, drag and drop a new operator onto the existing operator
in the expression. You can also right-click an operator in your expression, select
Replace Operator with, and then select a new operator.
Subset an Expression
To subset an expression and delete the remainder:
Editing a Filter Expression 213
2 Right-click, and select Keep Operand. The parts of the expression that were
not selected are removed.
27
Exporting Content
Export an Exploration as a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Export an Exploration as a PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Save a Visualization as an Image File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Export Data from a Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
E-mail an Exploration as a Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Note: If you have only one visualization in your exploration, the Save As
window is displayed at this point. Select the location where you want to save
the report, and then click Save to export it as a report.
2 In the Export as Report window, select the visualizations that you want to
include in the report.
Note: The following types of visualizations are not available to include in the
report:
n visualizations that do not contain any data
n decision trees
n network diagrams
n Sankey diagrams
n word clouds
n line charts with forecasting analysis are not available if the visualization
has not been displayed during the current session
n geo maps that use calculated geography data items
216 Chapter 27 / Exporting Content
Note: If your scatter plot or heat map contains correlation data, the
correlations are not included in the report.
The Export to Report window enables you to perform the following tasks:
Task Action
Change the order of the selected In the Selected list, drag and drop the
visualizations. visualizations in the order that you want,
or select a visualization and click the up
and down arrows to move it.
Filter the available visualizations. Click , and then select your filter
parameters. You can filter either on the
visualization type or on the data items
that are used in each visualization.
Only the matching visualizations appear
in the Available list.
3 Select the location where you want to save the report, and then click Save.
4 Click OK to return to the explorer, or select Open the report now, and click
OK to view the report in the designer.
2 In the Export as PDF wizard, enter a Title and a Description for the PDF
document. Then, select the following options:
Export an Exploration as a PDF 217
Page numbers
specifies that the PDF document contains page numbers.
Summary data
specifies whether the PDF document contains summary data tables for
each visualization.
Filter descriptions
specifies whether each visualization includes a description of its active
filters.
Click Next.
3 Select the visualizations that you want to include in the PDF document.
Note: The following types of visualizations are not available to include in the
PDF document:
n visualizations that do not contain any data
n crosstabs
The Export as PDF window enables you to perform the following tasks:
Task Action
Change the order of the selected In the Selected list, drag and drop the
visualizations. visualizations in the order that you want,
or select a visualization and click the up
and down arrows to move it.
Filter the available visualizations. Click , and then select your filter
parameters. You can filter either on the
visualization type or on the data items
that are used in each visualization.
Only the matching visualizations appear
in the Available list.
Click Next.
5 Select the location where you want to save the PDF document.
Note: If the legend for a visualization is too large, then it is not included in the
PDF document.
3 Select the drop-down list from the visualization toolbar, and then select
Export Image.
4 If necessary, scroll and zoom the visualization to show the data items that
you want to include in the image. If your visualization contains filters,
legends, or hierarchy breadcrumbs, select whether to include these
elements.
3 Select the drop-down list from the visualization toolbar, and then select
Export Data to open a download window for your browser.
Note: For a crosstab visualization, select Export Data Summary instead of
Export Data.
4 Specify a filename and select the location where you want to save the file.
Note: To export data from a table visualization, your browser must allow
pop-ups.
E-mail an Exploration as a Link 219
28
Managing Hierarchies
What Is a Hierarchy? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Create a New Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Derive a Hierarchy from a Date, Time, or Datetime Data Item . . . . . . . . . . . . . . . 222
Create a Hierarchy from a Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Edit a Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Delete a Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
What Is a Hierarchy?
A hierarchy is an arrangement of category columns that is based on parent-child
relationships. The levels of a hierarchy are arranged with more general
information at the top and more specific information at the bottom.
For example, you might create a hierarchy of date-time columns with Year as the
top level, Month as the next level, and Day as the bottom level.
Creating hierarchies enables you to add drill-down functionality to your
visualizations. For example, if you use a date-time hierarchy, you can drill down
to the data for a specific year. Then, you can drill down to the data for a specific
month.
When you drill down a hierarchy, a set of breadcrumb links at the top of your
visualization enables you to drill back up the hierarchy.
3 Select the categories that you want to include in the hierarchy, and then click
to add them to the hierarchy.
To change the order of the categories in your hierarchy, select the category
that you want to move. Then, click to move the category up, or click to
move the category down.
To remove a category from the hierarchy, select the category that you want to
remove. Then, click .
Note: You can create a hierarchy from within a crosstab visualization. See
“Create a Hierarchy from a Crosstab” on page 160.
Edit a Hierarchy
To edit an existing hierarchy:
1 From the Data pane, right-click on the hierarchy that you want to edit, and
then select Edit. The Edit Hierarchy window appears.
3 To add a category to the hierarchy, select the category, and then click .
Delete a Hierarchy
To delete a hierarchy:
From the Data pane, right-click on the hierarchy that you want to delete, and
then select Delete. Click Yes to confirm that you want to delete the hierarchy.
224 Chapter 28 / Managing Hierarchies
225
29
Performing Data Analysis
Overview of Data Analysis in SAS Visual Analytics Explorer . . . . . . . . . . . . . . . 225
Types of Data Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Correlation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Fit Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Forecasting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Add a Fit Line to an Existing Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Add Forecasting to an Existing Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Working with Scenario Analysis and Goal Seeking . . . . . . . . . . . . . . . . . . . . . . . . . 228
About Scenario Analysis and Goal Seeking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Apply Scenario Analysis and Goal Seeking to a Forecast . . . . . . . . . . . . . . . . . . . 228
Remove Scenario Analysis and Goal Seeking from Your Forecast . . . . . . . . . . 229
Correlation
Correlation identifies the degree of statistical relationship between measures.
The strength of a correlation is described as a number between -1 and 1. A
value that is close to -1 implies a strong negative correlation, a value that is
close to 0 implies little or no correlation, and a value that is close to 1 implies a
strong positive correlation.
226 Chapter 29 / Performing Data Analysis
Fit Lines
A fit line plots a model of the relationship between measures. You can apply fit
lines to scatter plots and heat maps.
You can apply the following types of fit line to your visualization:
Best Fit
selects the most appropriate model (linear, quadratic, or cubic) for your data.
The Best Fit method uses backward variable selection to select the highest-
order model that is significant. To see the final model that was used, select
from the visualization legend.
Linear
creates a linear fit line from a linear regression algorithm. A linear fit line
produces the straight line that best represents the relationship between two
measures. For more information about the linear fit line, select from the
visualization legend.
For a linear fit, correlation is automatically added to the visualization.
Correlation is not available with other fit types.
Quadratic
creates a quadratic fit line. A quadratic fit produces a line with a single curve.
A quadratic fit line often produces a line with the shape of a parabola. For
more information about the quadratic fit line, select from the visualization
legend.
Cubic
creates a cubic fit line. A cubic fit line produces a line with two curves. A
cubic fit line often produces a line with an “S” shape. For more information
about the cubic fit line, select from the visualization legend.
PSpline
creates a penalized B-spline. A penalized B-spline is a smoothing spline that
fits the data closely. A penalized B-spline can display a complex line with
many changes in its curvature. For more information about the penalized B-
spline, select from the visualization legend.
Add Forecasting to an Existing Visualization 227
Forecasting
Forecasting estimates future values for your data based on statistical trends.
Forecasting is available only for line charts that contain date or datetime data
items.
A forecast adds a line with predicted values to your visualization and a colored
band that represents the confidence interval. For example, a 95% confidence
interval is the data range where the forecasting model is 95% confident what the
future values will be.
The explorer automatically tests multiple forecasting models against your data,
and then selects the best model. To see which forecasting model was used,
select from the visualization legend.
The forecast model can be any one of the following:
n Damped-trend exponential smoothing
increase the accuracy of the forecast, then they are not used. If the additional
measures do increase the accuracy of the forecast, then the forecast line is
adjusted, and the confidence bands are narrowed.
Note: Underlying factors are available only if your line chart contains a single
measure in the Measures role.
If your forecast includes underlying factors, then you can apply scenario analysis
and goal seeking to the forecast. For more information, see “Working with
Scenario Analysis and Goal Seeking” on page 228.
1 On the Roles tab, select Scenario Analysis. The Scenario Analysis window
appears.
Note: The Scenario Analysis option is available only if one or more
underlying factors contribute to the forecast.
2 For the forecast measure and for each of the measures that are assigned to
the forecast as underlying factors, a line displays the values of the measure,
and a series of points enables you to set the future values for the measure.
Note: You can also display the forecast values as a table. Click to display
the table mode.
To perform scenario analysis, set the future values for the underlying factors.
To perform goal seeking, set the target future values for the forecast
measure.
Working with Scenario Analysis and Goal Seeking 229
You can set the values by using any of the following methods:
n drag each data point upward or downward on the line chart. To select the
accuracy of the points, click the measure heading on the plot axis, and
select Snap Interval.
n enter the value for each data point. Right-click on a data point, and select
Set Point Value.
n set all of the values for the measure. Click the measure heading on the
plot axis, and select Set Series Values. The Change Future Values
window enables you to set all of the values to a specific value or to adjust
the future values relative to the forecasted values of the measure.
Note: The Progressively by option increments future values by the
amount that you specify. For example, if you specify 100, then the first
future value is increased by 100, the second future value is increased by
200, the third future value is increased by 300, and so on.
Note: If you change future values for either scenario analysis or goal
seeking, you must apply your changes before you can change future values
for a different analysis type.
To reset any data point to its original value, right-click on the data point, and
then select Reset Point.
To reset all of the data points for a measure, click the measure heading on
the plot axis, and then select Reset Entire Series.
3 If you perform goal seeking and there are multiple underlying factors, then
choose which of the underlying factors are optimized to achieve the target
value.
4 (Optional) If you perform goal seeking, you can set bounds for each
underlying factor to limit the minimum and maximum values that are possible.
To set the minimum value for an underlying factor, click the measure
heading, and then select Bounds Add Lower Bound.
To set the maximum value for an underlying factor, click the measure
heading and then select Bounds Add Upper Bound.
5 When you are finished setting the future values for the scenario, click Apply
to apply the scenario to the forecast.
The forecast is updated to show the results of the scenario. The original
forecast is displayed as an additional line that is labeled (Baseline).
1 On the Roles tab, select Scenario Analysis. The Scenario Analysis window
appears.
2 For each measure, click the measure heading, and then select Reset Entire
Series.
30
Sharing Comments in the Explorer
Sharing Comments in the Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
About Comments in the Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
View Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Create a Comment under an Existing Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Create a Comment under a New Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Edit a Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Delete a Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
View Comments
To display the comments for the current exploration, select File Exploration
Comments from the main menu.
To display comments for a visualization, select the visualization and then select
the Comments tab from the right pane.
Comments are grouped by topic. If there are many comments in a topic, then
only the most recent comments are displayed. Click Show All Comments to
view all of the comments for a topic.
To search the comments, enter a search term in the Search within comments
field.
1 Enter your comment text in the Respond to topic field that is beneath the
topic that you want to comment on.
3 When you are finished with the comment, click Post. Your comment is saved
and shared immediately.
1 Enter the name of the topic in the Enter a topic name field.
4 When you are finished with the comment, click Post. Your comment is saved
and shared immediately.
Edit a Comment
To edit a comment, select the comment that you want to edit, and then click
Edit.
Note: To edit other users’ comments, you must belong to the
Comments:Administrator role.
Delete a Comment
To delete a comment, select the comment that you want to delete, and then click
Delete.
Note: To delete comments, you must belong to the Comments:Administrator
role.
233
Part 5
Building Models
Chapter 31
Overview of SAS Visual Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Chapter 32
Getting Started with SAS Visual Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Chapter 33
Modeling Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Chapter 34
Linear Regression Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Chapter 35
Logistic Regression Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Chapter 36
Generalized Linear Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Chapter 37
Decision Trees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Chapter 38
Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Chapter 39
Model Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
234
235
31
Overview of SAS Visual Statistics
What Is SAS Visual Statistics? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Benefits of Using SAS Visual Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Specify Global Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Specify Your Preferences for SAS Visual Statistics . . . . . . . . . . . . . . . . . . . . . . . . 236
3 Specify a value for the p-value precision property. This value determines
the minimum number of decimal places used when displaying p-values.
32
Getting Started with SAS Visual
Statistics
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Create the Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Create a Decision Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Create a Linear Regression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Create a Generalized Linear Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Perform a Model Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Overview
This is a brief overview of using SAS Visual Statistics to derive a new variable,
create two different models, and compare those models. This example uses the
Framingham Heart Study data set, located in SASHELP.HEART, to compare the
performance of a Linear Regression model and a Generalized Linear Model.
The goal is to predict a person’s age of death based on a collection of health
factors. These factors include gender, weight, height, whether the person is a
smoker, blood pressure, and more. The focus of this example is how to use SAS
Visual Statistics, not how to build the best model.
This example assumes that you have access to the SASHELP.HEART data set.
It is beyond the scope of this example to provide instructions about how to
access individual data sets at your location. Your system administrator should be
able to provide you access to this data set.
1 From the home page, click Data Explorer. This opens the explorer and
enables you to open a recent exploration or to create a new exploration.
238 Chapter 32 / Getting Started with SAS Visual Statistics
5 Click File Save from the main menu. This opens the Save As window. In
the SAS Folders pane, navigate to a location where you have Write
permission. In the Name field, enter Heart Study, and click Save.
Typically, you can save your work in My Folder.
2 From the Data pane, drag and drop the Age at Death variable into the
Response field in the right pane.
3 In the Data pane, select Diastolic, Weight, Height, Cholesterol, Age CHD
Diagnosed, Sex, and Cause of Death. Drag and drop these items into the
model pane. The decision tree automatically updates.
Create a Decision Tree 239
5 Click the Properties tab in the right pane. The most obvious property to
change is Reuse predictors. When you deselect this property, each
predictor variable is used in at most one split. However, assume that reusing
predictors creates the best split in each node for this example. This might not
always be the case for your data.
6 Set the value of Maximum levels to 10. The decision tree now has a
maximum depth of 10 levels, instead of the default 6. On the Node Rules tab
of the details table, every predictor is used at least once.
7 Set the value of Maximum branches to 4. This allows each non-leaf node to
split into at most four new nodes.
240 Chapter 32 / Getting Started with SAS Visual Statistics
8 To view the Tree Overview window, click in the upper right corner of the
exploration workspace. In the Tree Overview window, click to fit the entire
decision tree into the Tree Overview window.
Although each node is difficult to see, your decision tree should resemble the
following:
1 From the toolbar, click next to . Select Linear Regression from the
drop-down list.
3 In this example, the variable of interest is Age at Death, which should be the
first variable listed in the Measure section of the Data pane.
Because you want this variable to be the response variable, click, drag, and
drop Age at Death from the Data pane onto the model pane. Notice that Age
at Death now appears in the Response field on the Roles tab.
4 Choose the effect variables or interaction terms that you want to include in
the analysis. One option is to make every available variable an effect variable
and let SAS Visual Statistics perform variable selection. However, this is not
always feasible from a computational resources perspective. This example
creates an interaction term to use as an effect variable and includes a few
other variables as effect variables.
5 Because you suspect that systolic blood pressure and diastolic blood
pressure interact with each other, create an interaction term for these
variables.
Follow these steps to create an interaction term:
b In the New Interaction Effect window, move Diastolic and Systolic from
the Available columns area into the Effect elements area.
c Click Create.
6 Click, drag, and drop Diastolic*Systolic onto the model pane. A model is
created based on that single effect because the Auto-update model option
is selected in the right pane.
TIP Each time a change is made to the model, the Linear Regression
automatically updates. If you anticipate making many changes or if you are
experiencing server performance issues, deselect the Auto-update model
option. When auto-updates are disabled, you must click Update in the right
pane to update the model.
242 Chapter 32 / Getting Started with SAS Visual Statistics
7 Add more effects to the model. Hold down the Ctrl key, and select Blood
Pressure Status, Cause of Death, Leaf ID 1, Sex, Smoking Status,
Cholesterol, Height, Smoking, and Weight. Drag and drop these variables
onto the model pane. The Linear Regression updates to include these
effects.
Create a Generalized Linear Model 243
8 In the right pane, select the Properties tab. In this model, Informative
missingness and Use variable selection are not selected. Disabling
Informative missingness means that observations with missing values are
not included in the analysis. Disabling Use variable selection means that all
variables are used in the model, regardless of how significant they are to the
model. For this model, keep the default properties settings.
The Fit Summary window indicates that Cause of Death, Leaf ID (1), and
Height are the three most important effects in this model.
The Assessment window indicates that the observed average and predicted
average are approximately equal for most bins.
1 From the toolbar, click next to . Select Generalized Linear Model from
the drop-down list.
3 From the Data pane, drag and drop the Age at Death variable into the
Response field in the right pane.
244 Chapter 32 / Getting Started with SAS Visual Statistics
4 In the Data pane, hold down the Ctrl key, and select Blood Pressure
Status, Cause of Death, Leaf ID (1), Sex, Smoking Status, Cholesterol,
Height, Smoking, Weight, and Diastolic*Systolic. Drag and drop these
variables onto the model pane.
5 Click the Properties tab in the right pane. The Distribution property enables
you to specify the distribution of the response variable and to build a model
based on that distribution. The default distribution is Normal.
To determine whether the normal distribution applies to the response
variable, click in the Data pane, and select Measure Details. In the
Measure Details window, select Age at Death.
Create a Generalized Linear Model 245
6 Notice that Age at Death is not normally distributed and is slightly skewed
left. Click Close.
7 Although the distribution is not exactly Poisson, use the Poisson distribution
for this example. For the Distribution property, select Poisson. Next, select
Identity for Link function.
Note: You are encouraged to repeat this example with different distributions
and link functions and compare their performance and to familiarize yourself
with SAS Visual Statistics.
246 Chapter 32 / Getting Started with SAS Visual Statistics
1 From the toolbar, click to create a new model comparison. The Model
Comparison window appears.
Perform a Model Comparison 247
The Response variable is already set to Age at Death, and Level and
Group By are unavailable. With these settings, the available models are
Visualization 2 (the Linear Regression) and Visualization 3 (the
Generalized Linear Model).
3 By default, the fit statistic average squared error, ASE, is used to compare
the models. The other available fit statistics are SSE and Observed
Average. Because smaller values are preferred, the Linear Regression is
chosen as the champion when ASE or SSE is the criterion. The models are
very similar.
When the fit statistic is Observed Average, the Percentile slider is
available. This slider specifies the percentile where the observed average
and predicted average are compared. In some percentiles, the Generalized
Linear Model might be chosen over the Linear Regression.
If you view the Assessment plot, both the Observed Average and Predicted
Average plots show that the models are relatively similar.
4 Now that you have a champion model, you can export the model score code
for that model to score new data.
Here are the steps to export the model score code:
d In the Save As window, navigate to where you want to save the code, and
click Save.
249
33
Modeling Information
Available Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Overview of Variables and Interaction Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Interaction Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Variable Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Missing Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Group By Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Filter Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Score Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Derive Predicted Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Available Models
The following models are available in SAS Visual Statistics:
n Linear Regression on page 257 attempts to predict the value of an interval
response as a linear function of one or more effect variables.
n Logistic Regression on page 265 attempts to predict the probability that a
binary or ordinal response will acquire the event of interest as a function of
one or more effects.
n Generalized Linear Model on page 273 is an extension of a traditional linear
model that allows the population mean to depend on a linear predictor
through a nonlinear link function.
n Decision Tree on page 281 creates a hierarchical segmentation of the input
data based on a series of rules applied to each observation.
n Cluster on page 289 segments the input data into groups that share similar
features.
250 Chapter 33 / Modeling Information
Variables
Category Variables
Category variables are numeric or nonnumeric variables with discrete levels.
The levels of a category variable are considered unordered by SAS Visual
Statistics. Examples of category variables include drink size (small, medium, or
large), number of cylinders in an engine (2, 4, 6, or 8), or whether a customer
has made a purchase (yes or no).
You can create a category variable from a response variable by right-clicking the
variable, and selecting Category. In this case, each distinct value of the
measure variable is turned into a level for the category variable.
Category variables can be used as response variables for classification models,
classification effect variables, decision tree predictors, filter variables, and group
by variables.
Note: To ensure proper performance and valid modeling results, the maximum
number of distinct levels allowed for a category variable is limited based on the
model type and variable role.
Measure Variables
Measure variables are continuous numeric variables that can assume an infinite
number of possible values between two numbers. Even though some numeric
variables are not continuous, such as count variables, these variables can be
treated as continuous values for the purpose of modeling. Examples of measure
variables include the temperature of a drink, engine displacement amount, or a
customer’s total purchase amount.
Summary statistics and a histogram for each measure variable are obtained by
right-clicking the variable in the Data pane, and selecting Properties. Use the
Name drop-down menu to specify the variable that you want to view.
Measure variables can be used as response variables for continuous models,
continuous effect variables, decision tree predictors, offset variables, frequency
variables, weight variables, and filter variables.
Interaction Terms
Two variables, A and B, interact if the effect of one variable on the model
changes as the other variable changes. That is, the effects of variables A and B
are not additive in the model.
SAS Visual Statistics enables you to create interactions between two or more
input variables, including squared interactions. A squared interaction is the
interaction of a variable with itself. You cannot create squared interactions for
category variables.
Group By Variables 251
Variable Selection
Variable selection is the process of reducing the number of input variables to
include just the most significant variables. The Linear Regression and Logistic
Regression models provide a property to automatically perform variable
selection. When you use this property, SAS Visual Statistics performs backward
selection on the input variables to determine the most significant variables.
Modeling with just the most significant variables is intended to avoid creating a
model that overfits the data. Automated variable selection can actually take
longer to run than not performing variable selection.
Missing Values
By default, SAS Visual Statistics handles missing values by dropping all
observations that contain a missing value in any assigned role variable.
However, the Linear Regression, Logistic Regression, and Generalized Linear
Model models provide the Informative missingness property. In some cases,
the fact that an observation contains a missing value provides relevant modeling
information. Selecting this property explicitly models missing values of variables
as a separate variable. For measure variables, missing values are imputed with
the observed mean, and an indicator variable is created to denote missingness.
For category variables, missing values are considered a distinct level.
Group By Variables
A group by variable enables you to fit a model for each data segment defined by
one or more category variables. Each unique combination of levels across all of
the group by variables is a specific data segment. For example, if you have one
group by variable with three levels, then there are three data segments. But, if
you have two group by variables, one with three levels and the other with four
levels, then there are at most 12 data segments. A data segment is not created
when there are no observations in a combination of classification levels.
252 Chapter 33 / Modeling Information
The Group By field enables you to select the variable that is used for grouping.
Select the Use advanced features option to display aggregation statistics for a
specified measure variable. Specify the measure variable in the Measure field.
The Aggregation field specifies whether the Average or Sum is computed. Use
the Count field to specify whether you want the Top or Bottom n values. The
field below Count enables you to specify the value of n.
Score Code 253
Filter Variables
Filter variables are used to subset the modeling data. You can filter on any
variable included in the data, not just on variables used in the model. Filter
variables are applied only to the current model.
When you filter on a category variable, you are presented with a list of the levels
for that variable. Select only values that you want to include in the model. In the
following image, all levels are available.
When you filter on a measure variable, a slider lets you specify a range of
values. Use the triangles to specify the lower and upper limits of the filter
variable.
Score Code
Model scoring refers to the process of generating predicted values for a data set
that might contain the response variable of interest. Score code is exported as a
SAS DATA step that can be executed on new data sets in any SAS environment.
All variables used by the model in any capacity are included in the score code.
This includes interaction terms, group by variables, frequency variables, and
weight variables. Score code is not available for interactive decision trees.
To generate model score code, click , and select Export Score Code. In the
Export Model Score Code window, click Export. In the Save As window,
navigate to where you want to save the code, and click Save.
Score code is saved as a .sas file and can be viewed in any word processing
program.
254 Chapter 33 / Modeling Information
Note: It is possible for your exported score code to have lines of code that
exceed the maximum line length of 32768. There are two solutions for this issue.
The first solution requires that you edit the exported text file to include a line
break on each of the long lines and to insert / lrecl=1000000 in the %include
statement. The second solution requires that you open the exported text file in a
SAS Program Editor and insert a line break on each of the long lines. In the SAS
Program Editor there is a limit of 6000 characters per line.
2 Click in the upper right corner of the visualization and select Derive
Predicted Values.
3 In the New Prediction Variables window, enter a name for the Predicted
Values and either the Residual Values or the Probability Values. Residual
Values are available for linear regressions and generalized linear models.
Probability Values are available for logistic regressions.
4 Click OK. The predicted values for the logistic regression appear in the
Category variables section. All other variables, including the predicted
values for the other models, appear in the Prediction variables section.
34
Linear Regression Model
Overview of the Linear Regression Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Linear Regression Model Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Working with the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
About the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Including a Group By Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Working with the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
About Residual Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Use the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Working with the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
About the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Use the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Influence Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Fit Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Informative missingness
specifies whether the informative missingness algorithm is used. For more
information, see Missing Values on page 251.
Use variable selection
specifies whether variable selection is performed. For more information, see
Variable Selection on page 251.
Significance level
specifies the significance level that is required in order for variables to be
considered for the model. This property is available only when Use variable
selection is selected.
Assessment
n Use default number of bins specifies whether you want to use the
default number of bins or to set your own value. By default, measure
variables are grouped into 20 bins.
n Number specifies the number of bins to use when the Use default
number of bins property is not selected. You must specify an integer
value between 5 and 100.
n Tolerance specifies the tolerance value that is used to determine the
convergence of the iterative algorithm that estimates the percentiles.
Specify a smaller value to increase the algorithmic precision.
Show diagnostic plots
specifies whether the Residual Plot, Assessment, and Influence Plot appear
in the model pane.
The Variable Importance plot enables you to select a single variable to inspect
within each level of the group by variable. Use the drop-down menu to select
which variable you want to inspect. Each dot in the Variable Importance plot
represents a model effect. The bars are drawn for the effect selected in the drop-
down menu.
The Goodness of Fit plot, which is not available when there is no group by
variable, displays how well the model predicts the response variable within each
level of the group by variable. Use this plot to determine whether your model has
a significantly different fit within different levels.
Notice that when you select a group by variable, the Residual Plot,
Assessment, and Influence Plot are updated. These plots enable you to
further inspect the variable within each level of the group by variable.
and the color of each point indicates the relative number of observations in that
bin.
Residual plots have several uses when examining your model. First, obvious
patterns in the residual plot indicate that the model might not fit the data.
Second, residual plots can detect nonconstant variance in the input data when
you plot the residuals against the predicted value. Nonconstant variance is
evident when the relative spread of the residual values changes as the predicted
values change. Third, in combination with other methods, the residual plot can
help identify outliers in your data.
Influence Plot
The Influence Plot displays several measurements that are computed for each
observation. A histogram of the displayed measurements is also displayed.
When the input data contains a large number of observations, the observations
are binned. Use these measurements to help identify outliers and other data
points that greatly affect the predicted regression model.
Fit Statistics
The linear regression model computes several assessment measures to help
you evaluate how well the model fits the data. These assessment measures are
available at the top of the model pane. Click the currently displayed assessment
measure to see all of the available assessment measures.
Adjusted R-square
The Adjusted R-squared value attempts to account for the addition of more
effect variables. Values can range from 0 to 1. Values closer to 1 are
preferred.
AIC
Akaike’s Information Criterion. Smaller values indicate better models, and
AIC values can become negative. AIC is based on the Kullback-Leibler
information measure of discrepancy between the true distribution of the
response variable and the distribution specified by the model.
AICC
Corrected Akaike’s Information Criterion. This version of AIC adjusts the
value to account for sample size. The result is that extra effects penalize
AICC more than AIC. As the sample size increases, AICC and AIC converge.
262 Chapter 34 / Linear Regression Model
Details Table
When you click at the upper right of the model pane, the details table is
displayed at the bottom of the model pane. The details table contains the
following information:
Overall ANOVA
The analysis of variance results for the model, error, and corrected total.
Dimensions
An overview of the effect variables used in the model. This tab identifies how
many measures and classification effects were chosen for the model, the
rank of the cross-product matrix, how many observations were read, and how
many observations were used in the model.
Fit Statistics
Lists all of the fit statistics described in the previous section.
Model ANOVA
The analysis of variance results for the model.
Details Table 263
35
Logistic Regression Model
Overview of the Logistic Regression Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Logistic Regression Model Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Working with the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
About the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Including a Group By Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Working with the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
About Residual Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Use the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Working with the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
About the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Use the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Influence Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
About the Influence Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Use the Influence Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Fit Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Convergence
n Override function convergence enables you to manually specify the
function convergence value.
n Value specifies the function convergence value when Override function
convergence is selected. When you specify a larger value, the model will
converge sooner. This reduces the amount of time spent training the
model, but it can create a suboptimal model.
n Override gradient convergence enables you to manually specify the
gradient convergence value.
n Value specifies the gradient convergence value when Override gradient
convergence is selected. When you specify a larger value, the model will
converge sooner. This reduces the amount of time spent training the
model, but it can create a suboptimal model.
n Maximum iterations specifies the maximum number of iterations
performed during model training. If you specify a relatively small value,
you reduce the amount of time spent training the model, but it can create
a suboptimal model.
Working with the Fit Summary Window 267
Lift
The default lift chart displays the cumulative lift of the model. To view the
noncumulative lift, click on the vertical axis, and select Lift.
For comparison, the lift chart plots a best model based on complete knowledge
of the input data.
ROC
The specificity of a model is the true negative rate. To derive the false positive
rate, subtract the specificity from 1. The false positive rate, labeled 1 –
Specificity, is the X axis of the ROC chart. The sensitivity of a model is the true
positive rate. This is the Y axis of the ROC chart. Therefore, the ROC chart plots
how the true positive rate changes as the false positive rate changes.
A good ROC chart has a very steep initial slope and levels off quickly. That is,
for each misclassification of an observation, significantly more observations are
correctly classified. For a perfect model, one with no false positives and no false
negatives, the ROC chart would start at (0,0), continue vertically to (0,1), and
270 Chapter 35 / Logistic Regression Model
then horizontally to (1,1). In this instance, the model would correctly classify
every observation before a single misclassification could occur.
The ROC chart includes two lines to help you interpret the ROC chart. The first
line is a baseline model that has a slope of 1. This line mimics a model that
correctly classifies observations at the same rate it incorrectly classifies them.
An ideal ROC chart maximizes the distance between the baseline model and the
ROC chart. A model that classifies more observations incorrectly than correctly
would fall below the baseline model. The second line is a vertical line at the false
positive rate where the difference between the Kolmogorov-Smirnov values for
the ROC chart and baseline models is maximized.
Influence Plot
In either view, you can change the measurement that is plotted by clicking on
the horizontal axis.
Fit Statistics
The logistic regression model computes several assessment measures to help
you evaluate how well the model fits the data. These assessment measures are
available at the top of the model pane. Click the currently displayed assessment
measure to see all of the available assessment measures.
-2 Log Likelihood
The likelihood function estimates the probability of an observed sample given
all possible parameter values. The log likelihood is simply the logarithm of
the likelihood function. The likelihood function value is -2 times the log
likelihood. Smaller values are preferred.
AIC
Akaike’s Information Criterion. Smaller values indicate better models, and
AIC values can become negative. AIC is based on the Kullback-Leibler
information measure of discrepancy between the true distribution of the
response variable and the distribution specified by the model.
Details Table 271
AICC
Corrected Akaike’s Information Criterion. This version of AIC adjusts the
value to account for sample size. The result is that extra effects penalize
AICC more than AIC. As the sample size increases, AICC and AIC converge.
BIC
The Bayesian Information Criterion (BIC), also known as Schwarz’s Bayesian
Criterion (SBC), is an increasing function of the model's residual sum of
squares and the number of effects. Unexplained variations in the response
variable and the number of effects increase the value of the BIC. As a result,
a lower BIC implies either fewer explanatory variables, better fit, or both. BIC
penalizes free parameters more strongly than AIC.
R-Square
The R-squared value is an indicator of how well the model fits the data. R-
squared values can range from 0 to 1. Values closer to 1 are preferred.
Max-rescaled R-Square
The observed R-squared value divided by the maximum attainable R-
squared value. This value is useful when there are multiple independent
category variables. Values can range from 0 to 1. Values closer to 1 are
preferred.
Details Table
When you click at the top of the model pane, the details panel is displayed at
the bottom of the model pane. The details table contains the following
information:
Dimensions
An overview of the effect variables used in the model. This tab identifies how
many measures and classification effects were chosen for the model, the
rank of the cross-product matrix, how many observations were read, and how
many observations were used in the model.
Iteration History
The function and gradient convergence results. This tab shows at which
iteration the function and gradient converged.
Convergence
Provides the reason for convergence.
Fit Statistics
Lists all of the fit statistics described in the previous section.
Type III Test
Provides details for the Type III test. A Type III test examines the significance
of each partial effect with all other effects in the model. For more information,
see the chapter “The Four Types of Estimable Functions,” in the SAS/STAT
User’s Guide.
Parameter Estimates
Gives the estimated values for the model parameters.
Response Profile
Displays the event and nonevent counts.
272 Chapter 35 / Logistic Regression Model
273
36
Generalized Linear Model
Overview of the Generalized Linear Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Generalized Linear Model Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Working with the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
About the Fit Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Including a Group By Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Working with the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
About Residual Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Use the Residual Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Working with the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
About the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Use the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Fit Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Convergence
n Override function convergence enables you to manually specify the
function convergence value.
n Value specifies the function convergence value when Override function
convergence is selected. When you specify a larger value, the model will
converge sooner. This reduces the amount of time spent training the
model, but it can create a suboptimal model.
n Override gradient convergence enables you to manually specify the
gradient convergence value.
n Value specifies the gradient convergence value when Override gradient
convergence is selected. When you specify a larger value, the model will
converge sooner. This reduces the amount of time spent training the
model, but it can create a suboptimal model.
n Maximum iterations specifies the maximum number of iterations
performed during model training. If you specify a relatively small value,
you reduce the amount of time spent training the model, but it can create
a suboptimal model.
Note: When you specify a gradient convergence or function convergence
criterion, it is possible for the model to converge based on an internal
convergence criterion before your specified criterion is reached. The reason
for convergence is on the Convergence tab of the details table.
Assessment
n Use default number of bins specifies whether you want to use the
default number of bins or to set your own value. By default, measure
variables are grouped into 20 bins.
n Number specifies the number of bins to use when the Use default
number of bins property is not selected. You must specify an integer
value between 5 and 100.
n Tolerance specifies the tolerance value that is used to determine the
convergence of the iterative algorithm that estimates the percentiles.
Specify a smaller value to increase the algorithmic precision.
Show diagnostic plots
specifies whether the Residual Plot and Assessment windows appear in the
model pane.
Fit Statistics
The Generalized Linear Model computes several assessment measures to help
you evaluate how well your model fits the data. These assessment measures
are available at the top of the model pane. Click the currently displayed
278 Chapter 36 / Generalized Linear Model
Details Table
When you click at the top of the model pane, the details panel is displayed at
the bottom of the model pane. The details table contains the following
information:
Dimensions
An overview of the effect variables used in the model. This tab identifies how
many measures and classification effects were chosen for the model, the
rank of the cross-product matrix, how many observations were read, and how
many observations were used in the model.
Iteration History
The function and gradient iteration results. This tab shows the value of the
objective (likelihood) function, its change in value, and its maximum gradient.
Convergence
Provides the reason for convergence.
Fit Statistics
Lists all of the fit statistics described in the previous section.
Type III Test
Provides details for the Type III test. A Type III test examines the significance
of each partial effect with all other effects in the model. For more information,
Details Table 279
see the chapter “The Four Types of Estimable Functions,” in the SAS/STAT
User’s Guide.
Parameter Estimates
Gives the estimated values for the model parameters.
280 Chapter 36 / Generalized Linear Model
281
37
Decision Trees
Overview of the Decision Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Decision Tree Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Information Gain and Gain Ratio Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Pruning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Working with the Tree Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Working with the Leaf Statistics Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Working with the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
About the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Use the Assessment Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
in the right pane. To leave interactive mode, click Use Non-Interactive Mode on
the Roles tab.
Note: When you leave interactive mode, you lose all of your changes.
n Number specifies the number of bins to use when the Use default
number of bins property is not selected. You must specify an integer
value between 5 and 100.
n Prediction cutoff specifies the value at which a computed probability is
considered an event.
n Tolerance specifies the tolerance value that is used to determine the
convergence of the iterative algorithm that estimates the percentiles.
Specify a smaller value to increase the algorithmic precision.
Show diagnostic plots
specifies whether the Leaf Statistics and Assessment windows appear in the
model pane.
Show tree overview
displays the tree overview. The tree overview enables quick navigation of
large decision trees. When you zoom in to view a specific area of the
decision tree, the tree overview shows the entire decision tree and highlights
the area that you are viewing. You can click and drag the highlighted area to
change the display of the decision tree. Click in the upper left corner of
the tree overview to view the entire decision tree. Click in the upper left
corner of the tree overview to minimize the tree overview.
Here, n is the total number of response values. This value is also referred to as
the entropy of the training data.
Next, consider a split S on a variable X with m possible attributes. The expected
information provided by that split is calculated by the following equation:
m
Tj
IS T = ∑ T
× I Tj
j=1
In this equation, Tj represents the observations that contain the jth attribute.
The information gain of split S is calculated by the following equation:
G S = I T − IS T
As its name suggests, the information gain ratio is the ratio of the information
gain to the split information:
GS
GR S = SI S
Pruning
The Pruning property of the decision tree visualization determines how
aggressively your decision tree is pruned. The growth algorithm creates a
decision tree based on the properties that you specify. The pruning algorithm
considers each node to be a root node of its own subtree, starting from the
bottom. If the misclassification rate of the subtree is significantly better than the
misclassification rate of the root node, then the subtree is kept. If the
misclassification rate of the subtree is similar to the misclassification rate of the
root node, then the subtree is pruned. In general, smaller decision trees are
preferred.
If the Pruning property slider is closer to Lenient, then the difference in the
misclassification rates must be relatively small. If the Pruning property is closer
to Aggressive, then the difference in the misclassification rates must be
relatively large. That is, a lenient pruning algorithm allows the decision tree to
grow much deeper than an aggressive pruning algorithm.
Variables that are not used in any split can still affect the decision tree, typically
due to one of two reasons. It is possible for a variable to be used in a split, but
the subtree that contained that split might have been pruned. Alternatively, the
variable might include missing values, but the Include missing property is
disabled.
Note: If a predictor does not contribute to the predictive accuracy of the
decision tree or the contribution is too small, then it is not included in the final,
displayed decision tree.
Working with the Tree Window 285
TIP To navigate the decision tree, you can use the mouse and keyboard.
Hold down the Shift key and click anywhere in the Tree window to move the
decision tree within the window. Use your mouse’s scroll wheel to zoom in and
out of the decision tree. Scroll up to zoom in, and scroll down to zoom out.
The zoom is centered on the position of your cursor.
The color of the node in the icicle plot indicates the predicted level for that node.
When you select a node in either the decision tree or the icicle plot, the
corresponding node is selected in the other location. When you select a leaf
node, that node is selected in the Leaf Statistics window. A legend is available at
the bottom of the model pane.
When the response variable is a measure variable, a gradient is used to denote
the predicted bin. Darker colors represent larger values.
Right-click outside of a node in the Tree window to open a pop-up menu. The
first item in this menu is Derive a Leaf ID Variable. When you click this item,
SAS Visual Statistics creates a category variable that contains the leaf ID for
each observation. You can use this variable as an effect in other models.
Right-click inside a node to open a different pop-up menu. The available menu
options depend on whether you clicked a leaf node.
For leaf nodes, you can select from the following menu options:
Split
opens the Split Decision Tree window. Use this window to select the variable
that is used to split the node. Click OK to split the node based on the
selected variable. Click Cancel to not split the node. Variables are sorted in
descending order by their log worth.
Some variables are not available for a split if the value of the split is too small
or the split would violate the Leaf size property.
Split Best
splits the node based on the variable with the best information gain ratio
when Rapid growth is enabled. In addition, splits the node based on the
variable with the best information gain when Rapid growth is disabled.
Train
opens the Train Decision Tree window. Use this window to train more than
one level beyond the leaf node. First, select every variable that you want to
be available for training. Only those variables selected in the Train Decision
Tree window are available for training. Specify the maximum depth of training
in the Maximum depth of subtree property. Click OK to train the decision
tree.
For other nodes, select Prune to remove all nodes that follow the selected node.
This turns the selected node into a leaf node. After pruning a node, you can
select Restore to undo the prune.
286 Chapter 37 / Decision Trees
Lift
The default lift chart displays the cumulative lift of the model. To view the
noncumulative lift, click on the vertical axis, and select Lift.
For comparison, the lift chart plots a best model based on complete knowledge
of the input data.
ROC
The specificity of a model is the true negative rate. To derive the false positive
rate, subtract the specificity from 1. The false positive rate, labeled 1 –
Specificity, is the X axis of the ROC chart. The sensitivity of a model is the true
Details Table 287
positive rate. This is the Y axis of the ROC chart. Therefore, the ROC chart plots
how the true positive rate changes as the false positive rate changes.
A good ROC chart has a very steep initial slope and levels off quickly. That is,
for each misclassification of an observation, significantly more observations are
correctly classified. For a perfect model, one with no false positives and no false
negatives, the ROC chart would start at (0,0), continue vertically to (0,1), and
then horizontally to (1,1). In this instance, the model would correctly classify
every observation before a single misclassification could occur.
The ROC chart includes two lines to help you interpret the ROC chart. The first
line is a baseline model that has a slope of 1. This line mimics a model that
correctly classifies observations at the same rate it incorrectly classifies them.
An ideal ROC chart maximizes the distance between the baseline model and the
ROC chart. A model that classifies more observations incorrectly than correctly
would fall below the baseline model. The second line is a vertical line at the false
positive rate where the difference between the Kolmogorov-Smirnov values for
the ROC chart and baseline models is maximized.
Misclassification
The misclassification plot displays how many observations were correctly and
incorrectly classified. A significant number of misclassifications might indicate
that the model does not fit the data.
When the ratio of events to non-events in your data is relatively large, the
misclassification plot might show a large number of true positives and false
positives. In this case, your model predicts most observations as events and is
correct more often than not.
Assessment
When the number of Response bins is set to more than 10, the Assessment
window plots the predicted average and observed average values. Use this plot
to determine how well the model fits the data.
The Assessment window bins the data based on the values specified in the
Assessment properties. At each bin, you can hold the mouse over one or both
of the lines to display a tooltip.
Details Table
When you click at the top of the model pane, the details panel is displayed at
the bottom of the model pane. The details table contains the following
information:
Node Statistics
provides summary statistics for each node in the decision tree. Available
statistics include Depth, Parent ID, N Children, Type, Observations, %
Observations, N Missing, Gain, Predicted Value, Split, and the number
and percentage of observations in each bin.
Node Rules
provides the sorting rule used for each node in the decision tree. Every
available variable is listed as a column in the table. If a rule was applied for a
288 Chapter 37 / Decision Trees
variable in a node or any of its parent nodes, then it is listed in the table.
Otherwise, the entry is blank.
289
38
Clustering
Overview of the Cluster Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Cluster Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Working with the Cluster Matrix Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
About the Cluster Matrix Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Use the Cluster Matrix Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Working with the Parallel Coordinates Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
About the Parallel Coordinates Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Use the Parallel Coordinates Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Cluster Properties
The following properties are available for the cluster tool:
Name
enables you to specify the name for this model.
Cluster Matrix
n Number of clusters specifies the number of clusters that are generated.
n Seed specifies the seed value of the random number generator that is
used during initial cluster assignments.
n Initial assignment specifies the method that is used to create the initial
cluster assignments. The available methods are:
290 Chapter 38 / Clustering
Details Table
When you click at the top of the model pane, the details table is displayed at
the bottom of the model pane. The details table contains the following
information:
n Cluster Summary provides summary statistics for each cluster. Available
statistics include Observations, RMS of STD, Within-Cluster SS, Min
centroid-to-observation, Max centroid-to-observation, Nearest Cluster,
and Centroid Distance.
293
39
Model Comparison
Overview of Model Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Model Comparison Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Model Comparison Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Model Comparison Results Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Assessment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Fit Statistic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Details Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
The Model Comparison window enables you to specify the response variable of
interest, the level of interest, a group by variable, and the models for
comparison. You must specify a response variable and at least two models.
Note: You are able to compare two or more models only when the response
variable, level of interest, and group by variable are identical.
Fit statistic
specifies the comparison criterion that is plotted in the Fit Statistic window
and used to determine the champion model. The fit statistics available
depend on the models being compared.
For the error sum of squares (SSE) fit statistic, the linear regression model
and logistic regression model use the weighted SSE. The generalized linear
model uses the unweighted SSE.
Prediction Cutoff
specifies the cutoff probability that determines whether an observation is a
modeled event.
Percentile
when available, specifies the percentile at which the specified fit statistic is
plotted.
Assessment
The assessment plots available depend on the models being compared. For
classification models, the plots displayed are Lift, ROC, and Misclassification.
For numerical models, the plots displayed are observed response value and
predicted response value.
Fit Statistic
The Fit Statistic plot displays the criterion specified in the Fit statistic property.
In the following image, the observed average value is plotted for a linear
296 Chapter 39 / Model Comparison
regression and a GLM model. The champion model is indicated in the plot. It is
displayed different from the other models.
Details Table
When you click at the top of the model pane, the details panel is displayed at
the bottom of the model pane. The details table contains the following
information:
Statistics
Provides summary statistics for each model in the comparison. The value in
the Selected column, either Yes or No, indicates which model the model
comparison tool prefers based on the criterion specified in the Fit statistic
property. However, the statistics listed in the details table can differ from
those listed in the Fit statistic property.
Variable Importance
Indicates which variables had the greatest impact on each of the models in
the comparison.
297
Part 6
Designing Reports
Chapter 40
Overview of SAS Visual Analytics Designer . . . . . . . . . . . . . . . . . . . . . . . . . 299
Chapter 41
Creating and Working with Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Chapter 42
Using Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Chapter 43
Working with Data in SAS Visual Analytics Designer . . . . . . . . . . . . . . . . . 355
Chapter 44
Working with Display Rules for Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Chapter 45
Working with Report Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Chapter 46
Working with Report Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Chapter 47
Working with Report Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Chapter 48
Ranking Values in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
298
Chapter 49
Working with Parameters in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Chapter 50
Maintaining Multi-Section Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Chapter 51
Sharing Reports with Other Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
299
40
Overview of SAS Visual Analytics
Designer
About the SAS Visual Analytics Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Your First Look at the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Understanding the Tabs in the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Tabs in the Left Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Tabs in the Right Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
About the Canvas in the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
About Report Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Specifying Your Preferences for the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Specify Global Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Specify General Preferences for the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Specify Preferences for the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
1 The application bar enables you to return to the home page and to access
other parts of SAS Visual Analytics and other SAS applications that integrate
with the home page. You can access your recently created or viewed reports,
explorations, stored processes, data queries, or other objects in your recent
history. Buttons are displayed for each open application.
2 The menu bar provides menu items that apply to the entire report or to the
currently displayed report section. Actions include creating a new report,
adding a new section, inserting new report objects, adding interactions, and
Understanding the Tabs in the Designer 301
launching the viewer without returning to the home page. You can also sign
out of SAS Visual Analytics.
3 The toolbar contains icons that enable you to manage and print your reports.
You can click to hide the left and right panes. Or, you can click to
display the left and right panes.
4 The tabs in the left pane enable you to work with new report objects, data,
imported report objects, and shared rules.
5 The canvas is the workspace for building a report. The appearance of the
canvas is affected by the report theme.
6 The tabs in the right pane enable you to work with details about the report
and report objects.
Tab Description
Objects This tab provides a list of the tables, graphs, gauges, controls,
containers, other objects, and custom objects that can be used
in a report or dashboard.
Note: You can use the Show or Hide Objects window to specify
which report objects are displayed on the Objects tab. For more
information, see “Show or Hide Report Objects in the Objects
Tab” on page 321.
302 Chapter 40 / Overview of SAS Visual Analytics Designer
Tab Description
Data This tab enables you to select a data source (or data sources)
and the data items for your report. You can add, refresh, import,
or remove a data source using the icons above the list of data
items. Using the menu, you can change the data source, define
a hierarchy, define a calculated item, define an aggregated
measure, show or hide data items, and filter on a data item. You
can check the details for the measures in the data set. You can
use this tab to add parameters to a filter, a calculated item, a
display rule, or a rank.
The data item table on the Data tab provides information about a
selected item, including the name, classification, format,
aggregation, sort options, and parameters. These data item
properties can be modified, which impacts all of the report
objects that use the data item.
When a report has multiple data sources, the Data tab provides
information about the data source and data items for the
selected report object. When you select a report object that has
a different data source, the Data tab updates automatically to
provide information about the selected data source.
Imports This tab provides a list of reports and report objects that have
been created in the designer or exported from the explorer. This
enables you to create reports from multiple data sources and
create full-featured reports. You can choose objects or sections
in these reports to include in either a new report or an existing
report.
Shared Rules This tab enables you to create a new display rule for a gauge,
which is used by other gauges to designate intervals and colors
for ranges. You can edit or delete an existing shared display
rule. These display rules are shared across multiple gauges and
can be created at any time.
Tab Description
Properties This tab lists the properties for the currently selected report,
section, info window, or report object.
n When a report is selected, the report’s title and description
are listed.
n When a section is selected, the section’s name and layout
are listed, as well as any section prompts. When an info
window is selected, the name and layout, any section
prompts, and the size of the window are listed. For more
information, see “Overview of Report Sections and Info
Windows” on page 471.
n When a report object is selected, the object’s name, title, and
description are listed. Information that is specific to the report
object type, such as the axes and legend, is listed.
n If a report object is not selected on the canvas, then the
properties are for the section, info window, or report.
Styles This tab enables you to specify the data styling, frame styling,
text styling, and data colors for a selected report object. You can
specify the report theme for the report.
Display Rules This tab enables you to populate intervals, add intervals, or add
color-mapped values to an object that is currently selected on
the canvas. You can edit or delete an existing display rule for the
selected table, graph, gauge, or control.
Roles This tab enables you to add or update data role assignments in
a selected report object that has a data source.
Alerts This tab enables you to add, update, or delete alerts for report
objects.
Comments This tab enables you to add comments to the report after you
save it.
Filters This tab enables you to add a filter (or filters) to the selected
report object.
Ranks This tab enables you to add rankings to report objects. For
example, you might want to see the top 10 products that sold
last year.
You can change the report view by clicking the icons at the top of the canvas.
You can access the report views by clicking beside the icon. For more
information about report views, see “Choose a Report View” on page 309.
Above the canvas, there is an Auto-update check box. You can clear this check
box so that you can design your report without waiting for a query to finish.
When you are finished designing your report, select the Auto-update check box
to run and refresh all of the queries.
There is an area at the top of the canvas on which you can drag and drop filter
controls and then categories to create report-level prompts. If you do not want to
see this area, clear the Show report prompts check box. For more information,
see “Use a Control to Create a Report Prompt” on page 334.
A report can have multiple sections or info windows, which can be accessed by
using the tabs at the top of the canvas.
There is an area below the section tabs on which you can drag and drop filter
controls and then categories to create section prompts. For more information,
see “Use a Control to Create a Section Prompt” on page 335.
TIP If you change the User locale setting or preference, then you must sign
out and sign in to SAS Visual Analytics for the change to take effect.
For information about global preferences for the classic home page, see
“Specifying Your Preferences for the Classic SAS Visual Analytics Home Page”
on page 637.
3 Specify your Alert Notifications preference. The options are Send e-mail
messages, Send SMS text messages, or Use the system default for alert
notifications.
Note: If your preference for alert notifications is set to e-mail when you add
an alert, you will always receive notifications for that alert via e-mail. If you
decide later that your preference for alert notifications is a text message, then
after you change your preference to Send SMS text messages, you will
have to delete your existing alerts and create new ones.
The Use the system default for alert notifications option specifies that you
want to use the system default that is set by your system administrator in the
SAS Preferences Manager. For more information, see the SAS Preferences
Manager topic in SAS Intelligence Platform: Middle-Tier Administration
Guide. When you select either Send e-mail messages or Send SMS text
messages, you override the system default.
TIP If you select the Send SMS text messages preference, and do not
receive alerts via text message, contact your system administrator. Your
mobile number must be set up correctly as an SMS type in SAS
Management Console.
To specify general preferences for SAS Visual Analytics, see “Specify Settings
Using SAS Home” on page 10.
306 Chapter 40 / Overview of SAS Visual Analytics Designer
n Specify your default view for new or existing reports. Select Full screen,
Tablet, or Wide-screen tablet.
n Select your preferred report theme. The designer provides the following
report themes: Application theme, SAS Snow, SAS Light, SAS Dark,
or SAS High Contrast. Your site might also have custom report themes.
5 Specify your Data Tab preference. If you are trying to optimize performance,
then select the Bypass cardinality checks check box.
Note: If you select the Bypass cardinality checks check box, then the
distinct counts of data items are not displayed on the Data tab.
41
Creating and Working with Reports
About Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Create a New Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Choose a Report View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Choose a Report Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
View Report Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Change a Report’s Name or Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Import a Report or Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Repurpose an Existing Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Open a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Refresh a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Delete a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
About Reports
You can drag and drop tables, graphs, gauges, and controls to create a well-
designed report in SAS Visual Analytics Designer (the designer). You can add
text, images, and other controls to reports. A report can be divided into one or
more sections. (Sections are like pages.) Each section can have a different
layout and contain different report objects.
When you design a report, keep in mind that it might look slightly different on a
mobile device or in the viewer. For example, the layout of the tiles in the treemap
is dependent on the size of the display area. This means that the same treemap
might appear slightly different in the designer than it does in the viewer or on a
mobile device.
Reports that are imported from SAS Visual Analytics Explorer (the explorer)
might look slightly different in the designer.
The designer provides a report view that enables you to change the size of the
canvas that you use for laying out reports. For more information, see “Choose a
Report View” on page 309.
Two report layouts are available in the designer: Precision and Tiled. For more
information, see “Choose a Report Layout” on page 309.
308 Chapter 41 / Creating and Working with Reports
1 Select one or more data sources with the associated data items.
2 (Optional) Select the layout (Precision or Tiled) for the first section of the
report using the Properties tab for Section 1.
3 Add report objects by dragging and dropping them onto the canvas or by
double-clicking the report object on the Objects tab. You can tab over a
report object and press Enter to add the report object to the canvas.
4 Add data items to report objects by dragging and dropping one or more data
items onto the report object or by right-clicking on the report object and using
the pop-up menu.
Note: If you add a graph to your report, and there is not enough space for
both the graph and the legend to display, then the legend will be dropped.
6 (Optional) View the report in SAS Visual Analytics Viewer (the viewer) by
selecting File View Report. Once you have viewed the report, you can
return to the designer by selecting File Edit Report.
7 Save the report. The default location for the first save is My Folder. After
that, the default save location is the last accessed folder.
Choose a Report Layout 309
8 (Optional) View or change the report properties using the File menu.
You can create a new report based on an existing report or on existing report
objects. For more information, see “Repurpose an Existing Report” on page 314.
3 For Layout, select either Precision or Tiled. The Tiled layout is the default.
4 (Optional) If you select Precision, then you can specify Fit to screen. The
Fit to screen option prevents objects from being sized too wide or too tall,
which can cause the report viewing area for the section to scroll.
Note: The Fit to screen option is only for designing reports. Your Fit to
screen selection is not saved with the report, so it does not affect the web
viewer or mobile devices.
TIP Starting in the 7.2 release, text in the Location field in the Report
Properties window is now selectable, which makes it easier for you to share
the location of your report with other users.
View Report Properties 311
By comparison, the Properties tab in the right pane of the designer can be used
to update the properties for individual report objects or report sections. The
available properties depend on the selected report object. To move to the
properties of different report objects or report sections, click after the report
name, and then select another report object or report section from the list.
312 Chapter 41 / Creating and Working with Reports
This example shows a report title and description and lists two sections.
For information about updating report object properties, see “About Report
Objects” on page 318.
2 Enter a new Name, and click Save. The new report name is displayed as the
title on the Properties tab and as the name in the Report Properties window.
Import a Report or Report Objects 313
1 Click Imports in the left pane. If the Imports tab is not visible, select View
Imports.
Note: Report objects that cannot be imported from the explorer are not
displayed on the Imports tab.
3 In the tree view on the Imports tab, a list of the report name, the sections,
and the report objects is displayed. Drag the report, a single report object,
multiple report objects, or an entire section and drop it onto the canvas.
4 Select File Save As, or click , which displays the Save As window.
Enter a Name. Report names cannot use these characters: / \
5 Modify the report objects, properties, styles, roles, filters, display rules, ranks,
and interactions as needed.
2 Select File Save As, or click , which displays the Save As window.
Enter a Name. Report names cannot use these characters: / \
n For existing objects, modify the properties, styles, roles, filters, display
rules, ranks, and interactions.
n To import objects from other reports, click Imports in the left pane. If the
Imports tab is not visible, select View Imports. From the Imports tab,
drag a single report object, multiple report objects, or an entire section
and drop it onto the canvas.
Open a Report
Reports in the designer are saved when you use either the Save window or the
Save As window. A saved report contains at least one section. Typically, a
section uses data items from a data source to perform queries. The section
displays the results with one or more report objects (for example, a table, a
graph, a gauge, a control, and so on). For more information about sections, see
“Overview of Report Sections and Info Windows” on page 471.
A section is not required to contain any report objects. For example, you might
have a report that you use only as a template to create other reports if you want
all reports to have a similar appearance. A template-like report might contain
data sources, calculated items, global data filters, and shared display rules, but it
might not contain report objects.
Delete a Report 315
To open a report:
TIP If you search for a single word, then the search assumes a wildcard
character before and after the word. For example, if you perform a search
with low in the Name field, then the search results include report names
such as Low Activity, Regions with Lowered Sales, and Monthly Travel
Allowance.
TIP The search is not case sensitive. For example, if you search for profit,
then the search results include report names such as Sports Equipment
Profits and Company profits last year.
3 Select a report name, and then click Open. The report is displayed in the
canvas.
Alternatively, you can open a report using the object inspector on the SAS Visual
Analytics home page. For more information, see “Discover Details Using the
Object Inspector on the Classic Home Page” on page 633.
Refresh a Report
You can reopen the current report and save any unsaved changes by selecting
File Refresh Report. When you are prompted to save changes, choose Save
or Don’t Save. Unsaved changes can include changes to the underlying data
sources or changes that another user might have saved to the report.
This is especially useful if you have closed the current report without saving your
changes.
Note: You are not prompted to save the report if there are no unsaved changes.
Delete a Report
To delete a report:
2 Select the report that you want to delete, and then click .
316 Chapter 41 / Creating and Working with Reports
You can also delete a report from the home page. Click , and then click
Manage (next to My Content or Other Content). For more information, see
“Manage Content on the Classic Home Page” on page 628.
317
42
Using Report Objects
About Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Insert a Report Object into a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Show or Hide Report Objects in the Objects Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Using Tables to Display Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
About List Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
About Crosstabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
Specify Table Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Specify Table Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Add Sparklines to a List Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Use the Combine Excluded Rows (or Cells) into “All Other” Properties . . . . 327
Using Graphs to Display Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
About Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Specify Graph Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Specify Graph Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Using Controls to Display Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
About Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Specify Control Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Specify Control Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Use a Control to Create a Report Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Reorder Report Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Use a Control to Create a Section Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Reorder Section Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Using Container Object Types in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
About Container Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Specify Container Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Specify Container Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Using Other Object Types in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Use a Text Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Use an Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Use a Stored Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Use a Geo Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Use a Gauge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Use a Word Cloud Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
Using Custom Graphs to Display Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
About Custom Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
Specify Custom Graph Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
318 Chapter 42 / Using Report Objects
List Table
Crosstab
Bar Chart
Waterfall Chart
Line Chart
Pie Chart
About Report Objects 319
Scatter Plot
Bubble Plot
Treemap
Note: You can display the additional graph objects using the Show or Hide
Objects window. For more information, see “Show or Hide Report Objects in the
Objects Tab” on page 321. The additional graph objects are displayed in the
gallery in the graph builder.
The following table lists the available controls:
Drop-down List
List
Button Bar
Text Input
Slider
Vertical Container
Horizontal Container
Stack Container
320 Chapter 42 / Using Report Objects
Prompt Container
Text
Image
Stored Process
Gauge
Word Cloud
Report objects of the Custom type are created using the graph builder. They are
identified by the icon. For more information, see “Using Custom Graphs to
Display Results” on page 348.
In the designer, you have access to report objects from SAS Visual Analytics
Explorer (the explorer). You can open a histogram, heat map, box plot, or
correlation matrix in a report that has been exported from the explorer. However,
you cannot create new histograms, heat maps, box plots, or correlation matrices
in the designer.
TIP Use the Show or Hide Objects window to specify which report objects
are displayed on the Objects tab. For more information, see “Show or
Hide Report Objects in the Objects Tab” on page 321.
n Use the Insert menu to select the report object that you want to insert. The
report object is automatically placed in the canvas. If you want the report
object to appear in a different location, then drag and drop it in a new
location.
Additional steps are required for some report objects.
n If you insert a container, then you can drag and drop other report objects
onto the container.
n Inserting images requires additional steps. For more information, see “Insert
an Image into a Report” on page 340.
n Inserting stored processes requires additional steps. For more information,
see “Use a Stored Process” on page 341.
TIP Use the Clear Selection or Select All option on the report object’s pop-
up menu to clear the selected data or to select data in the report object.
TIP To quickly hide a report object on the Objects tab, right-click the object,
and select Hide Object.
Note: Custom graphs appear under the Custom heading on the Objects tab if
they are saved to your My Folder location or if custom graphs are selected in
the Show or Hide Objects window.
To show or hide report objects:
1 On the Objects tab, click , and then select Show or Hide Objects. The
Show or Hide Objects window is displayed. Report objects that are available
in the designer by default are selected. The list of report objects includes
additional graph objects, which are not selected by default. Graph objects are
also displayed in the graph builder gallery.
2 Select the report objects that you want to show on the Objects tab. If there
are report objects that you do not want to see on the Objects tab, then clear
one or more check boxes for one or more report objects.
322 Chapter 42 / Using Report Objects
3 (Optional) To find a custom graph object that is not listed, click Select
Custom. The Choose an Item window is displayed. Select the custom graph
object, and click OK to return to the Show or Hide Objects window.
TIP To rearrange the columns in a list table, drag and drop the column
headings.
You can add sparklines to a column (if the data source contains a date data
item) when aggregated data is displayed in the list table. For more information,
see “Add Sparklines to a List Table” on page 325.
Starting in the 6.4 release, list tables are sorted in ascending order by the first
data item that you add. Only new list tables have a default sort selection. The
sorting of data items in list tables in existing reports does not change. To sort the
list table by a column, click on the column heading. An arrow appears in the
column heading to indicate the sorting.
Here are some key points about list tables:
n If you sort a list table, then the list table displays only the first 5,000 sorted
rows. For more information, see “Sort Data in a List Table” on page 395.
n You cannot select the totals in a list table.
n List tables that show detail data cannot be the source of an interaction or a
link.
About Crosstabs
You can show subtotals and totals by selecting the appropriate check box (or
check boxes) on the Properties tab for the crosstab. You can show a
percentage of total or percentage of subtotal in a crosstab. For more information
about percentage of total or percentage of subtotal, see “Create Derived Items
for Measures” on page 369.
You cannot add a sparkline to a crosstab.
You should consider placing lower cardinality (fewer distinct values) categories
on the columns and higher cardinality (more distinct values) categories on the
rows. Crosstabs can help you improve readability especially when there are
several category data items to include in your table.
Using Tables to Display Results 323
1 If it is not already selected, select the table in the canvas that you want to
update.
3 Update the general properties for the table. You can update the Name, Title,
Format (for the title's font style), and Description.
4 Update the object-specific properties for the table. The available properties
depend on the selected table type.
Here are some details about the properties for list tables:
n By default, the Enable selection in the viewers property is selected for
list tables. This means that users who use the web viewer or a mobile
device can select the list table, and click to see the list table name and
any incoming filter information.
n You can use the Data Options properties to enable sorting, show detail
data, combine excluded rows into “all other,” and to show totals. These
properties are available when you use summarized data. They apply to
both ranks and post-aggregate filters.
Note: By default, a list table contains aggregated data with one row for
each distinct combination of category values. However, if the Show detail
data check box has been selected, then all of the data is not aggregated.
List tables that show detail data cannot be the source of an interaction or
a link.
For list tables, you can select the Combine excluded rows into “All
Other” property, under the Data Options heading, to summarize all
excluded rows. For more information, see “Use the Combine Excluded
Rows (or Cells) into “All Other” Properties” on page 327.
TIP Select the Show labels for totals property to turn off or turn on
the aggregation labels for totals.
n You can specify that you want to display missing labels as blanks instead
of the string (missing) being displayed.
n You can specify that you want an indented layout and totals and subtotals
for columns, rows, or both.
n You can specify the placement of totals and subtotals.
1 If it is not already selected, select the table in the canvas that you want to
update.
3 Update the styles for the table. The available styles depend on the selected
table type. For example, you can specify Border and Fill, Cells, Column
Headings, and Totals for list tables and crosstabs.
Here are some details about the styles for list tables:
n Select Wrap text to wrap text in the cells of a list table.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. Here is an example:
The data tip values on the sparkline show the high and low values of the
sparkline and the last value in the sparkline. The data tip values are affected by
the boundary at which the data is binned and by the aggregation of the data
item. For example, suppose that the aggregation is Sum. If the data is binned by
day, then the minimum and maximum values for a given day are displayed in the
data tip. However, if the data changes and it is binned by month, then the
minimum and maximum values for the sum of all days in the month are
displayed in the data tip.
Note: The designer does not let users control the binning of the sparkline.
The data for each sparkline is displayed as a miniature time series plot. Here is
an example of a report that contains a simple list table with a sparkline and a
time series plot, which is filtered to represent the data shown in the sparkline:
In the example, both the time series plot and the sparkline are using Profit for
the measure. The time series plot has more detail than the sparkline because in
the time series plot, the data is grouped at a more granular level. The sparkline
shows the same overall line as the time series plot, but has less detail.
The sparkline does not display the trend at the most granular date, datetime, or
time level. Instead, the sparkline summarizes the trend depending on the unit of
time that is used in the list table. For example, the sparkline might be
summarized for the month, quarter, or year, depending on the data. The report
designer cannot change the level of summary in the sparkline.
To add a sparkline:
1 If it is not already selected, select the list table in the canvas that you want to
update.
2 Right-click the list table, and then select Add Sparkline. The Add Sparkline
window is displayed.
4 For Time Axis, select a date, datetime, or time data item in the current data
source.
Use the Combine Excluded Rows (or Cells) into “All Other” Properties 327
6 (Optional) Select the Set baseline check box. Enter a Value, and select a
Fill type. Your choices are Gradient or Solid.
The Set baseline option draws a horizontal line through the graph at the
point on the Y axis where the baseline value resides. Everything above or
below the baseline is filled in with either a solid or gradient color.
7 Click OK. The sparkline is added to the last column in the list table. You can
move the sparkline to another location in the table.
To edit a sparkline, right-click in the sparkline column in the list table, and then
select Edit Sparkline. The Edit Sparkline window is displayed. Update the
information, and then click OK to save your changes.
To delete a sparkline, right-click in the sparkline column in the list table, and then
select Remove Sparkline.
The following list table shows how the content of combining visible categories is
factored into “All Other”. The list table has two categories and a measure. The
Combine excluded rows into “All Other” property is selected on the
Properties tab. The list table is filtered by aggregate quantity values using the
adjacent slider control.
Here are some key points about the Combine excluded rows into “All Other”
property and the Combine excluded cells into “All Other” property:
n The property cannot be set when the report object is displaying detail data.
n The property cannot be set when the report object includes a rank with the
per-category All Other option selected.
n The property cannot be set for pie charts when the Create “Other” slice for
minimal values property is selected.
n The property cannot be set when a hierarchy is assigned to the report object.
n The property cannot be set for line charts that are imported from the explorer.
Using Graphs to Display Results 329
About Graphs
For a definition and a picture of each graph type, see “Graphs, Charts, and
Plots” on page 555.
Some graphs are available by default in the designer. (These graphs are listed
under the Graphs heading on the Objects tab.) There are additional graph
objects, which are displayed in the graph builder gallery. For more information
about the gallery, see “About the Graph Template Gallery” on page 496. You can
also display the additional graph objects using the Show or Hide Objects
window in the designer. For more information, see “Show or Hide Report Objects
in the Objects Tab” on page 321.
You can also create custom graphs. For more information, see “Using Custom
Graphs to Display Results” on page 348.
1 If it is not already selected, select the graph in the canvas that you want to
update.
3 Update the general properties for the graph. You can update the Name, Title,
Format (for the title's font style), and Description.
4 Update the specific properties for the graph. The available properties depend
on the selected graph type.
Here are details about the properties for graphs:
n By default, the Enable selection in the viewers property is selected for
graphs. This means that users who use the web viewer or a mobile
device can select the graph, and click to see the graph name and any
incoming filter information.
n For select graphs only, you can use the Combine excluded cells into
“All Other” property under Data Options. This property applies to both
ranks and post-aggregate filters. For more information, see “Use the
Combine Excluded Rows (or Cells) into “All Other” Properties” on page
327.
n To add a new horizontal or vertical reference line to all graph types except
the pie chart and the treemap, select Create new reference line. You
can specify a Label, an Axis, a Value, and the Style of the new line.
Note: Properties for the axes or reference lines are not displayed for a
custom graph that has merged or common axes.
n To rotate a graph’s X-axis category labels by 45 degrees, select the
Rotate value label property. This property is available for the bar chart,
targeted bar chart, waterfall chart, line chart, dual axis bar chart, dual axis
330 Chapter 42 / Using Report Objects
line chart, the dual axis bar-line chart, and custom graphs with a single X
axis that has discrete values.
Note: You cannot use the Rotate value label property if you assign a
data item to a lattice row or lattice column data role.
n For bar charts that are assigned multiple measure data items (in the
Measures role) or if you group a data item, you can create a 100%
stacked bar chart using the Grouping style and Grouping scale
properties. Select Cluster or Stack for the Grouping style. Select
Normalize groups to 100% for the Grouping scale.
Note: The Grouping scale property is not available for the dual axis bar
chart, the dual axis bar-line chart, or any custom graph with at least one
bar chart and a second Y axis.
Note: Negative values are ignored in the 100% stacked bar chart.
Note: If you select Normalize groups to 100% for a bar chart, then the
Set baseline property is not available.
Note: The Callout and Outside options for the Data label location are
not supported for grouped pie charts. Selecting either of these options
has no effect on the pie chart.
n Use the Set baseline property to place a baseline on the response axis
using a value that you specify in the text field. When this property is not
selected, the graph defaults to placing the baseline at 0. The Set
baseline property is available for bar charts, targeted bar charts, waterfall
charts, line charts, dual axis bar charts, dual axis line charts, dual axis
bar-line charts, needle plots, and butterfly charts.
Note: The Set baseline property is not available for bar charts if you
select Normalize groups to 100% for the Grouping scale property.
n To fill a line chart or a time series plot with color, select a Grouping style.
The style choices are Overlay Unfilled, Overlay Filled, and Stack
Filled. The default grouping style is Overlay Unfilled.
n To change the percentage for the “other” slice in a pie chart, change the
amount listed in the Minimum percentage for “Other” field. The default
is 4%.
n To display the measure label at the top of a pie chart, select the Show
label check box.
n To change the transparency of the markers in a scatter plot, needle plot,
step plot, or dot plot; or for the bubbles in a bubble plot or a bubble
change plot; or for the bars in a schedule chart, move the slider for
Transparency to any value between 0% and 100%. The default value for
transparency is 0%.
n For the treemap, the Layout property determines how the tiles are
arranged. The Show level indicator check box determines whether the
label of the data item that is in the Tile role is displayed above the
treemap.
n Use the Binning interval for a time series plot or a dual axis time series
plot when you have an uneven grouping of time data. The options are:
Automatic
Determines the best bin size for your data. This option is the default.
Using Graphs to Display Results 331
Fixed count
Enables you to specify an interval between 10 and 500 in the Fixed
bin count field.
Use format
Uses the format of the date data item as the interval.
n To remove the arrowheads for the vector plot or the stock high-low plot,
clear the Show arrowheads property. To change the transparency of the
vector plot or the stock high-low plot, move the slider for Transparency to
any value between 0% and 100%. The default value for transparency is
0%.
1 If it is not already selected, select the graph in the canvas that you want to
update.
3 Update the styles for the graph. The available styles depend on the selected
graph type. For example, you can specify Border and Fill, Data Styling,
Frame Styling, Text Styling, and Data Colors for all graphs.
Here are some details about the styles for graphs:
n By default, the background of a graph is set to white. Use the Wall
background option (under Frame Styling) to specify a different color.
n Move the slider beside the color palette to set the transparency for the
Wall background, the Legend background, or the Header background
for graphs, except for treemaps. The default value for transparency is 0%.
n A three-color Gradient data color style is available for bubble plots,
treemaps, some bar charts, some waterfall charts, and word clouds.
n To modify the colors that are used in a graph, use the styles that are
available under Data Colors.
To change a color, click its tile to open the color palette. Using the palette,
select a new color. The new color is automatically applied to the graph,
and the tile changes to the new color.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
332 Chapter 42 / Using Report Objects
About Controls
A control is a report object that filters or narrows the scope of the data that you
are currently viewing. A control enables you to group your data by a selected
category, and then select which group you want to view. When you drag and
drop a data item onto a control, the control creates a group based on that data
item. For example, you might have a data item called Cars that contains all of
the models that a manufacturer produces. When you drag and drop the Cars
data item onto a drop-down list, the control groups the car models, and then you
can select a car model to use as a filter. Controls can be used in a report with
interactions.
Report prompts are controls that are placed in the special area at the top of the
canvas. A report prompt automatically filters all of the other report objects as
long as the report object uses the same data source as the report prompt
control. For more information, see “Use a Control to Create a Report Prompt” on
page 334.
Section prompts are the controls that are placed in the special row area below
the section tabs at the top of the canvas. A section prompt automatically filters
all of the other report objects in the same section, as long as the report object
uses the same data source as the section prompt control. For more information,
see “Use a Control to Create a Section Prompt” on page 335.
You can place any control in the main area of the canvas below the section
prompt row. You must define explicit interactions (using either the Interactions
tab or the Interactions view) between these controls (as the source report
objects) and one or more target report objects. For more information about
interactions, see “Overview of Report Interactions” on page 433.
The text input control, button bar control, drop-down list control, and slider
control (single-point only) support parameters. For more information, see
Chapter 49, “Working with Parameters in Reports,” on page 463.
Here are some key points about filtering using controls:
n Filters use the AND operator.
n Filters are applied as separate steps.
n The filter results are impacted by the type of data used in the control.
1 If it is not already selected, select the control in the canvas that you want to
update.
3 Update the general properties for the control. You can update the Name,
Title, Format (for the title's font style), and Description.
4 Update the specific properties for the control. The available properties
depend on the selected control.
Here are some details about the properties for controls:
n By default, the Enable selection in the viewers property is not selected
for controls. This means that users who use the web viewer or a mobile
device cannot select the control, and click to see the control name and
any incoming filter information. However, users can still modify values for
the control.
n For drop-down lists, lists, and button bars, select the Required property if
you want to require users to make a selection in the control. If you select
the Required property for a list, at least one check box must always be
selected.
n By default, the Allow multiple selection property is selected for lists. If
you clear the Allow multiple selection check box, radio button are
displayed instead of check boxes and the Required property is applied
automatically.
n For button bars and sliders, the Horizontal property is selected by
default.
n For sliders, select the Interact on the data in view property if you want
to have the control interactively filter the post-aggregated data.
n For sliders, the Set value to dynamic minimum and Set value to
dynamic maximum properties automatically adjust the slider to the
minimum or maximum values in the current data query. These properties
are available for only dates and measures.
n For sliders, select the Set fixed range property so that you can specify
the Minimum and Maximum properties for the slider end points.
Note: You cannot have a filter or rank when the Set fixed range property
is selected for a slider.
1 If it is not already selected, select the control in the canvas that you want to
update.
3 Update the styles for the control. The available styles depend on the selected
control type. For example, for a drop-down list, you can specify Border and
Fill, Drop-down Styling, and Text Styling.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
334 Chapter 42 / Using Report Objects
1 Drag the control icon from the Objects tab in the left pane and drop it onto
the area above the tabs on the canvas. (Look for the hint text that says,
“Drop controls here to create a report prompt.”) The control appears above
the tabs on the canvas.
Note: You can also use a prompt container to create a report prompt.
2 Drag and drop a category, measure, or parameter onto the control. For
example, if you drag and drop a drop-down list control, then you can assign a
category like Facility City or Facility State. Then, the drop-down list is
populated with the cities or states that are used in that category.
You can also use the Roles tab in the right pane to specify the Category and
Frequency roles for the report prompt.
3 (Optional) Update the general properties for the report prompt. You can
update the Name and Description.
4 (Optional) Update the specific properties for the report prompt. The available
properties depend on the selected control.
Here are some details about the properties for controls:
n By default, the Enable selection in the viewers property is not selected
for controls. This means that users who use the web viewer or a mobile
device cannot select the control, and click to see the control name and
any incoming filter information. However, users can still modify values for
the control.
n For drop-down lists and button bars, select the Required property if you
want to require a user to make a selection in the control. If you select the
Required property for a drop-down list, at least one check box must
always be selected.
n For sliders, for Value, the Range property is selected by default. Select
the Interact on the data in view property to have the control filter only
the aggregated data that is currently displayed in the report. If you clear
this property, then the detail data is filtered.
Note: If the Interact on the data in view property is not selected, then a
slider does not filter crosstabs or time series plots.
Using Controls to Display Results 335
If the report prompt uses one data source and the report objects on the canvas
use another data source, you can change the data source mappings by right-
clicking the control, and then selecting Edit Data Source Mapping. For more
information, see “Map Data Sources” on page 444.
Starting in the 7.4 release, you can create cascading (or dependent) section
prompts. Cascading section prompts enable you to create filter interactions
between objects in the section prompt bar. Cascading section prompts do not
allow data brushing.
To use a control to create a section prompt:
1 Drag the control icon from the Objects tab in the left pane and drop it onto
the area above the report objects and below the tabs on the canvas. (Look
for the hint text that says, “Drop controls here to create a section prompt.”)
The control appears below the tabs on the canvas.
Note: You can also use a prompt container to create a section prompt.
2 Drag and drop a category, a measure, or a parameter onto the control. For
example, if you drag and drop a drop-down list control, then you can assign a
category like Facility City or Facility State. Then the drop-down list is
populated with the cities or states that are used in that category.
336 Chapter 42 / Using Report Objects
You can also use the Roles tab in the right pane, and then specify the
Category and Frequency roles.
TIP If you move a section prompt from one section to another section in a
report, you must edit the data source mapping for an interaction to work.
Right-click the control, and select Edit Data Source Mapping. For more
information, see “Map Data Sources” on page 444.
If the section prompt uses one data source and the report objects on the canvas
use another data source, you can change the data source mappings by right-
clicking the control, and then selecting Edit Data Source Mapping.
n Stack containers. The report objects are displayed as if they are in a slide
deck. Only one report object is displayed at a time. The stack container has a
control bar instead of a scroll bar that lets you move between report objects.
You cannot nest stack containers. However, you can place them side by side.
When you use precision layout, you can resize the stack container.
n Prompt containers. These containers group prompt controls. Prompt
containers are affected by report prompts, but not by other section prompts.
They are not affected by interactions. Report objects inside prompt
containers are filtered by the same rules as other objects.
Prompt containers can be added to the report prompt area and section
prompt area on the canvas. This enables you to add control types (for
example, list controls) that are not otherwise allowed in those prompt areas.
TIP If a prompt container is open and there are unsaved changes, then
the button bar changes. An Apply button is displayed so that you can
apply changes.
1 If it is not already selected, select the container in the canvas that you want
to update.
3 Update the general properties for the container. You can update the Name,
Title, Format (for the title's font style), and Description.
4 Update the object-specific properties for the container. Here are some details
about the properties for containers:
n By default, the Enable selection in the viewers property is selected for
containers. This means that users who use the web viewer or a mobile
device can select the container, and click to see the container name
and any incoming filter information.
n Update the order in which the report objects appear inside the container.
1 If it is not already selected, select the container in the canvas that you want
to update.
3 Update the styles for the container. The available styles depend on the
selected container type. Border and Fill is available for all containers.
Prompt containers also have Drop-down Styling and Text Styling options.
The Button bar color style option for the prompt container enables you to
change the background around the Close button.
338 Chapter 42 / Using Report Objects
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
1 If it is not already selected, select the text object in the canvas that you want
to update.
3 Update the general properties for the text. You can update the Name, Title,
Format (for the title's font style), and Description.
Using Other Object Types in Reports 339
4 (Optional) Update the object-specific properties for the text object. By default,
the Enable selection in the viewers property is not selected for text objects.
This means that users who view the report in the web viewer or on a mobile
device cannot select the text in a report.
TIP You can use the pop-up menu to cut, copy, and delete text. However, you
have to use the keyboard shortcut (Ctrl+V) to paste text.
Note: You cannot change text styles using the Styles tab.
n Parameter values
n A timestamp for the most recent update of the current data source
To add a filter description, click in the floating toolbar, and then select
Interactive Filters.
Note: If you replace or remove the data source that is associated with the text
object, then all dynamic text is removed.
Use an Image
About Images
You can use images to include your corporate logo or other graphics in your
reports. You can insert images from a repository or from your local machine. If
you select an image from your local machine, it is saved to the repository. You
can also add tooltip text to an image.
340 Chapter 42 / Using Report Objects
None
The actual size of the image is maintained. The image might or might not
fill the entire area of the image's visual container. If the image is larger
than the visual container, then scroll bars are displayed.
Stretch
The height and width of image are set to the height and width of the
image’s visual container. The image’s original aspect ratio is not
maintained.
Fit All
The image is modified to fit best into the image's visual container. The
image’s original aspect ratio is maintained.
Fit Width
The width of the image is set to the width of the image's visual container.
The height maintains the image's original aspect ratio. Scroll bars are
displayed if the set height of the image is greater than the height of the
visual container.
Fit Height
The height of the image is set to the height of the image's visual
container. The width maintains the image's original aspect ratio. Scroll
bars are displayed if the set width of the image is greater than the width of
the visual container.
Tile
The image is tiled in the visual container. The image’s original size is
maintained. There are no scroll bars.
5 Click OK.
1 If it is not already selected, select the image in the canvas that you want to
update.
3 Update the general properties for the image. You can update the Name,
Title, and Description.
4 Update the properties specific for the image. Your choices are Location,
Scale type, and Tooltip text.
By default, the Enable selection in the viewers property is not selected for
images. This means that users who use the web viewer or a mobile device
cannot select the image, and click to see the image name.
Note: Users who view stored processes using the SAS Visual Analytics Apps
(previously called SAS Mobile BI) cannot be prompted. Instead, the stored
342 Chapter 42 / Using Report Objects
process runs using the prompt values that were added when the report was
created.
Note: The stored process output in a report is rendered as HTML regardless of
the requested output type.
For information about creating a stored process and registering it in metadata,
see SAS Stored Processes: Developer’s Guide.
1 If it is not already selected, select the stored process in the canvas that you
want to update.
3 Update the general properties for the stored process. You can update the
Name, Title, Format (for the title's font style), and Description.
4 Update the properties specific to the stored process. Your choices are Show
metadata view and Show SAS log in the output. If the stored process
contains prompts, the Edit Prompts button is displayed.
view, you can see information about when the stored process was created
and last modified. You can also see the name of the stored process file.
Here is an example of the metadata view for a stored process:
Selecting the Show SAS log in the output option means that both the log
output and the stored process output are displayed in the report. This can
assist you in debugging problems.
1 If it is not already selected, select the geo bubble map, geo coordinate map,
or geo region map in the canvas that you want to update.
3 Update the general properties for the geo bubble map, geo coordinate map,
or geo region map. You can update the Name, Title, Format (for the title's
font style), and Description.
4 Update the properties that are specific to the geo bubble map, geo
coordinate map, or geo region map. You can update Show map navigation
control, Transparency, and Show legend.
Here are some details about the properties for geo maps:
n Use the Map Service property to change the map provider for a geo
bubble map, geo coordinate map, or geo region map after you have
placed it on the canvas. This property changes the map type from
OpenStreetMap to any available Esri service if an Esri service is
available.
n For a geo bubble map, you select the Transparency for the bubble plot.
For a geo coordinate map, you select the Transparency for the scatter
plot. For a geo region map, you select the Transparency for the regions.
Using Other Object Types in Reports 345
n There are Legend properties for geo coordinate maps. However, geo
coordinate maps cannot have a legend. Any changes that you make to
the Legend properties will be discarded.
1 If it is not already selected, select the geo bubble map, geo coordinate map,
or geo region map in the canvas that you want to update.
3 Update the styles for the geo bubble map, geo coordinate map, or geo region
map. You can specify Border and Fill, Data Styling, Frame Styling, Text
Styling, and Data Colors for the geo bubble map, geo coordinate map, or
geo region map.
Note: Performance for geo maps is negatively impacted when you change
the Data skin style. The recommendation is to leave it as None.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
Use a Gauge
About Gauges
A gauge is a dashboard indicator (also known as a KPI) that displays the status
or measure of a variable or variables in relation to a target, goal, or interval.
Gauges are designed to achieve this goal in a way that is familiar to users. Many
real-life objects use gauges, such as cars and machines. Gauges can be used
to display a quantity, range, variable, or status. They often appear in business
intelligence dashboards.
Qualitative ranges are required for all gauges in the designer. You can populate
the range intervals manually, or you can have them generated for you based on
the range of the actual data.
Gauges in the designer support high cardinality.
For a definition and a picture of each gauge type, see “Gauges” on page 573.
3 Update the general properties for the gauge. You can update the Name,
Title, Format (for the title's font style), and Description.
346 Chapter 42 / Using Report Objects
4 Update the specific properties for the gauge. The available properties
depend on the selected gauge type.
Here are some details about the properties for gauges:
n By default, the Enable selection in the viewers property is selected for
gauges. This means that users who use the web viewer or a mobile
device can select the gauge and click to see the gauge name and any
incoming filter information.
n (Optional) Clear Show value label, Show range labels, or both
properties.
n Select a Type for the gauge. You can choose Bullet, Dial, Slider,
Speedometer, or Thermometer.
n For the bullet, slider, and thermometer gauges, you can specify the
Direction for displaying the gauge. The default for the bullet and slider
gauges is Horizontal. The default for the thermometer gauge is Vertical.
1 If it is not already selected, select the gauge in the canvas that you want to
update.
3 Update the styles for the gauge. The available styles depend on the selected
gauge type. For example, you can specify Border and Fill, Data Styling,
Frame Styling, Text Styling, and Data Colors for gauges.
Note: The Header value enables you to set only the text color.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
TIP There is a limit of 100 rows for a word cloud. To reduce the amount of
data, add a rank for the word cloud, and use a number less than 100. For
more information, see “Add a New Rank” on page 459.
1 If it is not already selected, select the word cloud in the canvas that you want
to update.
3 Update the general properties for the word cloud. You can change the Name,
Title, Format (for the title’s font style), and Description.
4 Update the object-specific properties for the word cloud. Here are some
details about the properties for word clouds:
n By default, the Enable selection in the viewers property is selected for
word clouds. This means that users who use the web viewer or a mobile
device can select the word cloud, and click to see the word cloud
name and any incoming filter information.
n Use the Arrangement property to specify how the words are displayed in
the word cloud. Cloud is the default. Use Rows to display the words in
rows as if you were reading text in a book.
n Use the Font scale to control the difference in the size of the smallest
and largest words. If you select 1, there is a one-to-one ratio, so the
smallest and largest words are displayed as the same size.
n By default, the word cloud has a limit of 100 terms. After the results of a
query come back, only the top 100 terms, based on a descending sort of
the size measure, will be displayed. Use the Word display limit property
to display fewer terms. The slider can be set to a number between five
and 100.
1 If it is not already selected, select the word cloud in the canvas that you want
to update.
3 Update the styles for the word cloud. For example, you can specify Border
and Fill, Frame Styling, Text Styling, and Data Colors.
TIP A three-color Gradient data color style is available for word clouds
that have at least two measures.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
348 Chapter 42 / Using Report Objects
1 If it is not already selected, select the custom graph in the canvas that you
want to update.
3 Update the general properties for the graph. You can update the Name, Title,
Format (for the title’s font style), and Description.
4 Update the specific properties for the graph. The available properties depend
on the selected custom graph type.
By default, the Enable selection in the viewers property is selected for
custom graphs. This means that users who use the web viewer or a mobile
device can select the custom graph and click to see the custom graph
name and any incoming filter information.
Note: No properties are available for the schedule chart.
1 If it is not already selected, select the custom graph in the canvas that you
want to update.
3 Update the styles for the graph. The available styles depend on the selected
custom graph type. For example, you can specify Border and Fill, Data
Styling, Frame Styling, Text Styling, and Data Colors for custom graphs.
By default, the background of a graph is set to white. Use the Wall
background option (under Frame Styling) to specify a different color.
Note: A three-color Gradient data color style is available for custom graphs
that have a Color role.
Your custom colors are saved between SAS Visual Analytics sessions. Your
custom colors are displayed in the color palette. For an example of the color
palette, see Figure 42.1 on page 325.
Setting the Overlaid plot colors property affects the Fill colors on the Styles
tab when you open the custom graph in the designer.
If a custom graph contains more than eight groupings, the Fill colors are
repeated. Here is the pattern for colors:
Colors Pattern
1 On the canvas, right-click the report object that you want to duplicate.
3 (Optional) Move the duplicate report object to another section. Right-click the
report object that you want to move. Select Move <ReportObject> to
<SectionName>, where <ReportObject> is the name of the report object
and <SectionName> is the name of the section.
Working with Alerts for Report Objects 351
4 (Optional) If you want the report object to appear in a different location, then
drag and drop it in a new location.
If you move an object to a section with precision layout, then you must
manually move the object to its proper location. All objects are put in the top
left corner by default.
Overview of Alerts
You can create alerts for a report object so that subscribers are notified via e-
mail or a text message when the alert condition is met. You can specify how
frequently the system checks to see whether the alert condition is been met.
You can add alerts to report objects using the Alerts tab. You can also add
alerts when you create a display rule. For more information about display rules,
see “Adding Table-Level Display Rules” on page 403.
Note: You can specify a preference for receiving alert notifications via e-mail or
a text message in both the designer and the viewer. For more information, see
“Specify General Preferences for the Designer” on page 305.
Add an Alert
To add an alert to a report object:
1 If it is not already selected, select the report object in the canvas to which
you want to add an alert.
3 On the Expression tab, specify the criteria for the alert. You can create a
new expression or use an existing expression.
4 (Optional) Specify how often you want the system to check for the criteria.
You can use the system default, which is set by your administrator, or you
can limit the check to a minute or hourly increment.
352 Chapter 42 / Using Report Objects
6 Click OK. The details for the alert are displayed at the bottom of the Alerts
tab.
Note: An alert notification has a blank subject. Some cellular carriers convert
text messages to e-mail messages. When a subject is not specified in an e-mail,
these carriers try to add a subject. Some carriers add the alert condition as the
subject. Other carriers cannot add the subject, so the e-mail message has a
blank subject.
Edit an Alert
To edit an alert:
2 Select the alert that you want to edit, and click . The Edit Alert window is
displayed.
3 Update the alert criteria, and then click OK to save your changes.
Working with Alerts for Report Objects 353
Delete an Alert
Alerts are not automatically deleted when a report is deleted. You can delete an
alert on the Alerts tab. Select the alert that you want to delete, and click .
Then, click Delete in the confirmation message that is displayed.
354 Chapter 42 / Using Report Objects
355
43
Working with Data in SAS Visual
Analytics Designer
Overview of Data Sources and Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Working with Data Sources in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
About Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Import a Data Source for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Add a Data Source to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Refresh a Data Source for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Remove a Data Source from a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Change a Data Source in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
View Measure Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Show or Hide Data Items on the Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Sort Data Items on the Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Group Data Items on the Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Working with Hierarchies in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
About Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Create a New Hierarchy for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Edit a Hierarchy for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Delete a Hierarchy for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Working with Data Items in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
About Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Assign Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Automatic Data Item Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Duplicate Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Rename Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Search for Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Create a Distinct Count for a Category Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Create Derived Items for Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Create a Percentage of Total Using the Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Create a Custom Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Modify Data Item Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
Delete Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Working with Geography Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
About Geographic Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Use a Predefined Geography Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Create a Custom Geography Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Working with Calculated Items in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
About Calculated Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
356 Chapter 43 / Working with Data in SAS Visual Analytics Designer
All data sources contain data items, which can refer to calculations or columns in
physical data (tables). Reports can include query results from more than one
data source.
1 On the Data tab, click beside the Select a data source text to display the
Add Data Source window.
2 In the Import Data pane, select a data source that you want to import.
TIP If you select a delimited text file, then you can specify additional
options. For example, you can specify the delimiter, whether the first row
contains column heading names, and where the data rows begin.
TIP If you select a spreadsheet, then you can specify additional options.
For example, you can specify which worksheets to import, whether the first
row contains column heading names, and where the data rows begin.
3 Click Add.
358 Chapter 43 / Working with Data in SAS Visual Analytics Designer
1 On the Data tab, click beside the Select a data source text.
2 In the Add Data Source window, select one or more data sources.
TIP Use the Search field to narrow the list of data sources that are
displayed in the Add Data Source window. The search searches the Name
and Description fields. It is a “begins with” search rather than a “contains”
search. If you receive a message that a data source is not available,
contact your data administrator.
3 Click Add. The list of available data items is displayed on the Data tab.
4 (Optional) To add additional data sources, click on the Data tab, which
displays the Add Data Source window. Select the data sources that you
want, and then click Add. The Data tab is populated with a list of all of the
data items that are in the data sources.
When you add multiple data sources, the last data source that you selected
is displayed on the Data tab. If one of the data sources that you selected is
not available, the last available data source that you selected is displayed on
the Data tab.
Note: When you open a saved report that has multiple data sources, the
designer displays the same data source that was displayed in the Data tab
when the report was saved.
Working with Data Sources in Reports 359
1 On the Data tab, select the data source, and then click .
1 On the Data tab, click , and then select Change Data Source. The
Change Data Source window is displayed.
3 Click Change.
360 Chapter 43 / Working with Data in SAS Visual Analytics Designer
If a data item with the same name does not exist in the replacement data
source, then it is automatically removed from the replacement data source if
there are no report objects that use the data item. If there are report objects
that use the data item, then those report objects will not work. The Repair
Report window is displayed so that you can repair the objects that use the
data item. For more information about repairing reports, see Appendix 8,
“Troubleshooting in SAS Visual Analytics Designer,” on page 615.
Data items in the replacement data source that have names that do not exist
in the original data source are added to the Data tab automatically.
Note: For data item names, the case is ignored when data sources are
compared by the designer.
1 On the Data tab, click , and then select Measure Details. The Measure
Details window is displayed.
2 Click Close.
1 On the Data tab, click , and then select Show or Hide Items. The Show
or Hide Data Items window is displayed.
2 Select the data items that you want to appear on the Data tab. If there are
data items that you do not want to see on the Data tab, then clear the check
box (or check boxes) for that data item (or data items).
Alternatively, you can select a data item that you want to hide on the Data tab.
Right-click the data item, and select Hide Data Item.
TIP Starting in the 7.2 release, you can hide all of the data items that are not
used in the current report. On the Data tab, click , and then select Only
Show Used Items.
You can also use a data source filter to restrict the data that is displayed in a
report. For more information, see “Use a Data Source Filter in a Report” on page
427.
Working with Hierarchies in a Report 361
The data items are sorted on the Data tab within each grouping. The default sort
is Ascending By Name.
For information about sorting data values in report objects, see “Sorting Data in
Reports” on page 395.
The data items are grouped on the Data tab. The default is grouping By Role.
About Hierarchies
Creating hierarchies enables you to add drill-down functionality to your reports.
A hierarchy is an arrangement of category columns that is based on parent-child
relationships. The levels of a hierarchy are arranged with more general
information at the top and more specific information at the bottom. For example,
you might create a hierarchy of datetime columns with Year as the top level,
Month as the next level, and Day as the bottom level.
You can also have a geographic hierarchy. For example, you might have a
hierarchy with Region as the top level, State as the next level, and City as the
bottom level.
You can have a maximum of two hierarchies for a report object.
Keep the following considerations in mind:
n List tables, controls, and gauges do not support hierarchies.
n Geo bubble maps, geo coordinate maps, and geo region maps allow only
geographic data items in a hierarchy.
You can also have a date hierarchy.
1 On the Data tab, click , and then select New Hierarchy. The New
Hierarchy window is displayed.
2 Enter a Name.
3 Select at least two categories, and drag them to the Hierarchy list.
4 (Optional) Use the up and down arrows to arrange the data items in the
Hierarchy list.
5 Click OK to save the new hierarchy. The icon identifies the new hierarchy
in the list of data items on the Data tab.
TIP You can create a date hierarchy by right-clicking a date or datetime data
item on the Data tab, and selecting Create Date Hierarchy. If you use a date
data item, it must have a format that specifies the year or the Create Date
Hierarchy option is not available.
Crosstab report objects enable you to create hierarchies from the categories on
a crosstab axis. To create a hierarchy, right-click a category heading, and then
select Create Hierarchy. The categories are replaced with a new hierarchy. The
name of the new hierarchy is generated from the name of the outermost
category with the suffix Hierarchy.
1 Right-click the hierarchy name on the Data tab, and select Edit Hierarchy.
The Edit Hierarchy window is displayed.
If the hierarchy that you edit is already used in a report object and is drilled or
expanded, it returns to the top level after it is edited.
Working with Data Items in a Report 363
1 Right-click the hierarchy name on the Data tab, and select Delete Hierarchy.
Date and Time A category data item whose distinct values are used to
group and aggregate measures. There are three types
of date categories: date, datetime, and time.
Examples of date, datetime, and time categories are
Order Year, Date and Time of Sale, and Customer
Wait Time.
Working with Data Items in a Report 365
Note: Report objects that are imported from SAS Visual Analytics Explorer (the
explorer) use either live or on-demand data. For on-demand data, you can
update the properties and styles for these report objects in the designer, but you
cannot change the data assigned to them.
366 Chapter 43 / Working with Data in SAS Visual Analytics Designer
1 On the Data tab in the left pane, click the down arrow to display a list of
available data sources. Select a data source, and the Data tab is populated
with a list of all of the data items that are in the data source.
If the data source that you want is not in the list, click , which displays the
Add Data Source window. Select the data source that you want, and then
click Add. The Data tab is populated with a list of all of the data items that
are in the data source.
If you do not want to use the data source that you originally selected, click
. Click Delete in the confirmation message that is displayed.
2 Select an existing report object that uses the same data source name or add
a new report object to the section.
3 Drag and drop a data item onto the canvas. The data item is automatically
assigned a data role. For more information, see “Automatic Data Item
Assignments” on page 367.
TIP You can use the Ctrl key to select multiple data items, and then drag
and drop them onto the canvas.
Alternatively, you can right-click on a data item, and select Add Data Item to
<ReportObject>, where <ReportObject> is the name of the report object in
the report. (For example, List Table 1, Bar Chart 1, and so on.)
Note: You cannot double-click the icon for a data item and assign it to the
report.
4 If the selected data item can replace a current data item in the report object
or if the selected data item is valid for multiple data roles, then select the data
assignment from the Assign <DataItemName> as window. A data
assignment that is marked with a red asterisk (*) is required before the query
can be run.
5 (Optional) To see more information about a data item, select it in the list. The
Name, Classification, Format, and Aggregation are displayed in the data
Working with Data Items in a Report 367
item table below the list of data items. For a category data item with a user-
defined format that has an underlying numeric value, you can specify Sort
Options.
1 On the Data tab in the left pane, right-click the data item that you want to
duplicate. Select Duplicate Data Item.
All of the properties of the original data item are copied to the duplicate data
item. The duplicate data item appears in the list of data items on the Data
tab. For example, if the original data item name is Engine Size, then the
duplicate data item is displayed as Engine Size (1). If you choose to
duplicate the same data item again, then it is displayed as Engine Size
(2).
3 (Optional) Change the format or aggregation for the duplicate data item.
5 (Optional) Change the sort options for a category data item with a user-
defined format that is based on an underlying numeric value.
6 (Optional) Change the classification for the data item. For example, a
numeric data item that has been duplicated and is not yet assigned to a
report object can be a category or a measure.
1 On the Data tab, right-click on a data item, and then select Rename Data
Item. The Rename Data Item window is displayed.
2 Enter a new name. The name cannot be used by another data item in the
same data source.
3 Click OK.
Working with Data Items in a Report 369
Alternatively, you can use the data item table at the bottom of the Data tab to
rename a data item. For the Name property, enter a new name for Value.
1 Enter the name of a data item in the search field on the Data tab. The field is
located above the list of data items.
3 Click to clear the search term and display all of the data items in the data
source.
1 On the Data tab in the left pane, right-click the category data item that you
want to use for the distinct count.
The distinct count data item appears in the list of data items with a name that
is derived from the original name. For example, if the original data item name
is Date, then the distinct count data item is displayed as Date (Distinct
Count). The icon identifies the new distinct count data item on the Data
tab.
1 In the report object, right-click on the measure data item that you want to use
for the derived item.
2 Select Create and Add, and then select one of the following:
Difference from Previous Period
Displays the difference between the value for the current time period and
the value for the previous time period. For example, you might derive the
difference between sales for the current month and sales for the previous
month.
Note: This derived item is not available if your data source does not
contain a date data item that includes the year.
Difference from Previous Parallel Period
Displays the difference between the value for the current time period and
the value for the previous parallel time period within a larger time interval.
For example, you might derive the difference between sales for the
current month and sales for the same month of the previous year.
Note: This derived item is not available if your data source does not
contain a date data item that includes the year.
Percent Difference from Previous Period
Displays the percentage difference between the value for the current time
period and the value for the previous time period. For example, you might
derive the percentage difference between sales for the current month and
sales for the previous month.
Note: This derived item is not available if your data source does not
contain a date data item that includes the year.
Percent Difference from Previous Parallel Period
Displays the percentage difference between the value for the current time
period and the value for the previous parallel time period within a larger
time interval. For example, you might derive the percentage difference
between sales for the current month and sales for the same month of the
previous year.
Note: This derived item is not available if your data source does not
contain a date data item that includes the year.
Percent of Subtotals
Displays the percentage of the subtotal value for the measure on which it
is based. You can create a percentage of subtotal only when the source
data item has an aggregation of Sum or Count.
Note: The Percent of Subtotals derived item is available only for
crosstabs.
Note: The Percent of Subtotals derived item is relative to the subset of
data that is selected by your filters and ranks.
Percent of Total
Displays the percentage of the total value for the measure on which it is
based. You can create a percentage of total only when the source data
item has an aggregation of Sum or Count. For example, you might create
the percentage of the total value for a measure that contains revenue
Working with Data Items in a Report 371
Alternatively, you can use the Data tab to create derived data items.
372 Chapter 43 / Working with Data in SAS Visual Analytics Designer
1 On the Data tab in the left pane, right-click on the measure data item that you
want to use for the percentage of total.
TIP The labels for your custom categories must use characters that are
compatible with the locale of the data source. If the data source uses Unicode,
then your labels can contain characters from any locale.
1 On the Data tab, right-click on the category or measure data item that you
want to use to create the new custom category. Select New Custom
Category. The New Custom Category window is displayed.
Working with Data Items in a Report 373
Note: In the New Custom Category window, Based on identifies the type
and the name of the data item that the custom category is based on.
2 Select the Values that you want to include. Drag and drop the values onto
the right pane under New label.
TIP To rename a custom group label, right-click the label name, and
select Edit.
3 (Optional) Specify the Options for remaining values. You can specify a
name when you select Group remaining values as. The default label for
Group remaining values as is Other. Alternatively, you can specify Show
as missing or Show as is.
Note: The Show as is option is available only for data items that are based
on string categories. It is not available for numeric or date values.
4 Specify a Name for the new custom category. The default name is
CustomCategory1.
5 Click OK. The new custom category is displayed on the Data tab.
2 In the data item table, select the existing name for the data item, and then
enter a new name. The name cannot be used by another data item in the
same data source. Your change is saved automatically.
374 Chapter 43 / Working with Data in SAS Visual Analytics Designer
Alternatively, you can right-click the data item, and select Rename Data Item.
n You cannot convert calculated data items into geography data items.
TIP For geography data items, use the pop-up menu instead of the drop-
down menu to change the classification. The pop-up menu enables you to
specify additional classification information for the geography data item.
2 In the data item table, select the existing classification for the data item.
2 In the data item table, select the existing format. A list is displayed with the
Format type, Width, and Decimals (for numeric data items). Make your
selections. A sample of your selection is displayed under the list.
Note: There are different format variations available for some format types
for date, datetime, and time data items. Select the format variation based on
the sample value displayed in the Format drop-down list.
Here is an example of the list for a numeric data item:
Note: The Reset to Default option is displayed only if the format has been
changed from the default.
Note: The Reset to Default option is available for user-defined format data
items after they have been modified to a standard numeric format as long as
the data item is still a category data item.
data item, you can restore the user-defined format by selecting Reset to
Default.
The Format property of the data item displays the name for a user-defined
format.
The icon identifies a category data item with an active user-defined format on
the Data tab.
2 In the data item table, select the existing aggregation, and then click .A
drop-down list is displayed with aggregations. For a list of the available
aggregation types, see Appendix 4, “Aggregations for Measures,” on page
581.
When you select an aggregation, your change is saved automatically.
Note: All of the report objects in the report that use this data item are
affected by this change unless you have selected a local aggregation
override.
Note: Depending on the aggregation, formats might be overridden when
they are used in report objects. For example, skewness becomes a floating
point number with four decimals.
Working with Data Items in a Report 377
To change the aggregation method when you are working with a report object in
the canvas:
TIP You can hide a data item that you cannot delete by right-clicking on the
data item name in the Data tab, and then selecting Hide Data Item. For more
information, see “Show or Hide Data Items on the Data Tab” on page 360.
1 On the Data tab in the left pane, right-click the data item that you want to
delete.
3 Click Delete in the confirmation message that is displayed. The data item is
removed from the list of data items, as well as from any report objects, filters,
or ranks that were using it.
Working with Geography Data Items 379
n US State Names
n US State Abbreviations
n US ZIP Codes
Note: For predefined geographic roles, the values of your geography data items
must match the lookup values that are used by SAS Visual Analytics. To view
the lookup values, see http://support.sas.com/va72geo.
TIP To get geographic maps to work with any data set, add a column with
the predefined lookup values to your data set.
n Longitude
For example, suppose you have data that includes airport location identifiers,
latitude, and longitude. You can convert the airport location identifiers to custom
geography data items.
To create a custom geography data item:
1 On the Data tab in the left pane, right-click the data item that you want to use
for the custom geography data item. Select Geography, and then select
Custom. The Geography window is displayed.
TIP Make sure that the data item that you select is a category data item
other than the latitude or the longitude.
2 Select a measure for the Latitude. You can also enter the first letter of the
name of the latitude column to quickly search for it in the drop-down menu.
3 Select a measure for the Longitude. You can also enter the first letter of the
name of the longitude column to quickly search for it in the drop-down menu.
5 Click OK. The icon identifies the new geography data item on the Data
tab.
n Starting in the 7.2 release, calculated data items can be changed into
geographic data items and used in geo maps.
Using the designer, you can work with calculated data items or aggregated
measures.
For information about deleting calculated data items, see “Delete Data Items” on
page 378.
1 On the Data tab, click , and then select New Calculated Item. The New
Calculated Item window is displayed.
2 Enter a Name.
3 Select a Result type from the drop-down list. Numeric is the default data
type.
The following table lists the available result types:
Character
Date
Datetime
Numeric
Time
382 Chapter 43 / Working with Data in SAS Visual Analytics Designer
Calculated data items in the designer always default to the following formats,
which are based on the data type:
n Date: DATE9
n Datetime: DATETIME10
n Time: TIME8
n Numeric: COMMA12.2
After you create the new calculated data item, you can change its format
using the data item table on the Data tab unless it is a character calculated
data item. You cannot specify a format for a character calculated data item.
Sum is the default aggregation for new numeric calculated data items in the
designer. You can change the aggregation for numeric calculated data items
using the data item table on the Data tab.
4 (Optional) Click beside Detail mode to clear the Show all drop zones
option. You can also select Show display text, which adds a new tab
between the Messages and Scratch tabs.
5 Use the Visual tab to build the expression for your calculated data item by
dragging Data Items and Operators onto the expression in the right pane.
For each rectangular field in the expression, you can insert a data item, an
operator, or a specific value.
When you drag and drop data items or operators onto your expression, the
precise location of the cursor determines where and how the new element is
added to the expression. As you drag the new element over the expression,
a preview appears that displays how the expression changes if you drop the
element at that location.
For example, if your current expression is ( Profit / Revenue ), and you
drag and drop the x - y (subtract) operator inside the open parenthesis
symbol, then the expression changes to ( [number] – ( Profit /
Revenue )). If you drag and drop the operator over the division symbol,
then the expression changes to ( Profit – Revenue ), and so on.
Alternatively, you can use the Text tab to enter the expression.
You can use the Scratch tab to build temporary expressions.
There are a large number of operator types available to perform
mathematical functions, process datetime values, handle text, and evaluate
logical processing such as IF clauses. For more information, see Appendix 5,
“Operators for Data Expressions,” on page 583.
7 Click OK. The new calculated data item appears on the Data tab. The ,
, or icon identifies the new calculated data item on the Data tab.
1 Right-click on a calculated data item on the Data tab, and select Edit
Calculated Item. The Edit Calculated Item window is displayed.
2 Modify the Data Items and Operators for the calculated data item as
needed. For information about the operators that are available, see Appendix
5, “Operators for Data Expressions,” on page 583.
Note: If the calculated data item has not been used in a report, then you can
modify the Result type.
3 Click OK.
You can duplicate, rename, hide, and delete calculated data items using the
same steps as any other data item. If a calculated data item is used inside
another calculated data item, then it cannot be removed.
TIP You can cut and paste from the Text area between different reports as
well as between the explorer and the designer to transfer calculations or to e-
mail them to others. For more information, see “Editing a Data Expression in
Text Mode” on page 577.
384 Chapter 43 / Working with Data in SAS Visual Analytics Designer
1 On the Data tab, click , and then select New Aggregated Measure. The
New Aggregated Measure window is displayed.
2 Enter a Name.
3 (Optional) Click to Show all drop zones. You can also choose to Show
scratch area to build temporary expressions.
4 Use the Visual tab to build the expression for your aggregated measure by
dragging and dropping Data Items and Operators onto the expression in the
right pane. For each field in the expression, you can insert a data item, an
operator, or a specific value.
When you drag and drop data items and operators onto the expression, the
precise location of the cursor determines where and how the data item or
operator is added to the expression. As you drag the new element over the
expression, a preview appears, which displays how the expression would
change if you drop the element at the current location.
Alternatively, you can use the Text tab to enter the expression.
There are a large number of operator types available to perform
mathematical functions and evaluate logical processing such as IF clauses.
For more information, see Appendix 5, “Operators for Data Expressions,” on
page 583.
Working with Calculated Items in Reports 385
7 Click OK. The new aggregated measure appears on the Data tab. The
icon identifies the new aggregated measure.
2 Modify the Data Items and Operators for the aggregated measure as
needed. For information about the operators that are available, see Appendix
5, “Operators for Data Expressions,” on page 583.
3 Click OK.
You can duplicate, rename, hide, and delete aggregated measures using the
same steps as any other data item.
TIP You can cut and paste from the Text area between different reports, as
well as between the explorer and the designer, to transfer calculations or to e-
mail them to others. For more information, see “Editing a Data Expression in
Text Mode” on page 577.
386 Chapter 43 / Working with Data in SAS Visual Analytics Designer
1 Select a report object in the canvas that has one or more data items
assigned.
3 Click beside the role that you want to edit. For data roles that allow
multiple data items, the menu items that are available can vary.
If you select a data item in Roles, then the Aggregation (if appropriate),
Add, Remove, and Replace menu items are displayed. You can also right-
click on a data item and the actions specific to that data item are displayed.
Different data roles are available for different report objects.
In addition to the basic data roles, you can assign additional data roles. Here
is a list of all the data roles available for each report object:
Tables
Graphs
Controls
390 Chapter 43 / Working with Data in SAS Visual Analytics Designer
Containers
Other
* For line charts with multiple measures, formats are removed from all of the measure labels if
the formats are different.
** This report object is not displayed by default in the designer.
If you select a bubble for one frame in the animation and click , then any
downstream interactions play with the animation. This means that as the
animation is running, the interaction targets are filtered with each frame in the
animation.
TIP To improve animation performance, use a color for the graph’s reference
line instead of a pattern.
TIP When you add animation to a pie chart, it is recommended that you sort
the Category in ascending or descending order. To sort, right-click on a
category name in the pie chart, and select Sort. Then, select either
Ascending or Descending.
To add animation:
1 Select an existing chart, bubble plot, or geo bubble map, or create a new
one.
3 Assign a data item with a datetime format to the Animation data role.
Task Action
Track the movement of a specific bubble. Click the bubble that you want to track.
Note: If you select a bubble to track, the selected bubble is highlighted in the
current animation frame.
Working with Data Role Assignments 393
1 Select a report object in the canvas that has one or more data items
assigned and that allows a lattice data role.
3 Click beside the Lattice columns or Lattice rows role that you want to
edit.
The following example shows a bar chart with a lattice column specified for the
data role:
TIP Scroll bars are generated by the graph if you have a lot of data. These
scroll bars work differently than other scroll bars in the designer. They initially
fill the maximum area so that you can see all of the bars in the lattice row or
lattice column. To zoom in and see specific bars, you have to drag the top or
the bottom of the scroll bar to adjust the height of the scrolling bar. Labels are
added as space becomes available.
394 Chapter 43 / Working with Data in SAS Visual Analytics Designer
The following example shows a horizontal bar chart with lattice columns. It has a
scroll bar activated so that you are zoomed in on the bars for the West region.
2 Select Remove All Data Items. All data items are removed from the
assigned data roles as well as the data-dependent features like filters, ranks,
conditions, and so on. The report object turns gray, and the status icon
appears in the lower right corner to let you know that the required data roles
are not assigned.
Sorting Data in Reports 395
Here is an example of what a bar chart looks like after all the data items have
been removed from their assigned data roles:
n You can also press the spacebar to sort a single column in a table.
You can also sort categories, rather than measures, by clicking the category
name.
Sorting Data in Reports 397
1 On the Data tab, select a category data item. Right-click, and select New
Custom Sort. The New Custom Sort window is displayed.
2 Select the category data items that you want to sort. Click to move the
data items to the Sorted Items list. You can also drag and drop data items in
the New Custom Sort window. Use the Ctrl key to select multiple data items.
3 (Optional) Use the up and down arrows to arrange the data items in the
Sorted Items list.
4 Click OK.
1 On the Data tab, select a category data item, calculated item that is a
category, or a custom category. Right-click, and select Edit Custom Sort.
The Edit Custom Sort window is displayed.
3 Click OK.
Figure 43.4 The Progress Indicator for List Table with a Slow-Running Query
After you cancel the query, the progress indicator is replaced by the refresh icon.
To resume a query that you canceled, click .
400 Chapter 43 / Working with Data in SAS Visual Analytics Designer
Figure 43.5 The Progress Indicator for List Table with Query That Has Been Stopped
401
44
Working with Display Rules for
Reports
Overview of Display Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Add Report-Level Display Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Adding Table-Level Display Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Add Display Rules to a List Table Using an Expression . . . . . . . . . . . . . . . . . . . . . 404
Add Display Rules to a List Table Using a Gauge . . . . . . . . . . . . . . . . . . . . . . . . . . 406
Add Display Rules to a List Table Using Color-Mapped Values . . . . . . . . . . . . . . 408
Add Display Rules to a Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
Adding Graph-Level Display Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Add Display Rules to a Graph Using an Expression . . . . . . . . . . . . . . . . . . . . . . . . 411
Add Display Rules to a Graph Using Color-Mapped Values . . . . . . . . . . . . . . . . . 413
Adding Gauge-Level Display Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Add Display Rules to a Gauge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Add a Shared Display Rule for Gauges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
TIP The Shared Rules tab is not displayed by default. To display the tab,
click after the last tab name, and select Shared Rules.
Display rules can accept parameters. For more information, see Chapter 49,
“Working with Parameters in Reports,” on page 463.
For list tables and graphs, you can create display rules that reference a measure
that is not included in the currently displayed report object. This feature is not
available for crosstabs.
Here are some key points about color-mapped display rules:
n Color-mapped display rules are not allowed if there are multiple overlays.
n Color-mapped values for a report object can be applied only to category data
items.
n Color-mapped values cannot be applied to date or datetime data items.
n Color-mapped display rules are not applied if there are two measures.
1 Without any report objects or the section selected in the canvas, click the
Display Rules tab in the right pane. Click New. The Add New Display Rule
window is displayed.
4 (Optional) Repeat the steps for entering a value and selecting a color.
5 (Optional) Select the Other check box. Then, select a color so that any of the
other categories that do not have a color will have the one that you just
selected.
Adding Table-Level Display Rules 403
In the following example, values and colors have been specified for each
region in a list table. And, a color has been selected for the Other check box.
6 Click OK. The report objects in the report update with the new display rule.
And, the display rule appears on the Display Rules tab in the right pane.
The following table illustrates the report-level display rules that were defined in
the Add New Display Rule window above.
1 If it is not already selected, select the table in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
3 Click Expression. The Add New Display Rule window expands to show the
details for the expression.
4 On the Expression Details tab, select the Column or any measure value.
5 Select the Operator. You can select =, < >, BetweenInclusive, <, <=, >, >=,
Missing, or NotMissing. The default is >.
7 Modify the style, size, and color of the font. There is no default style for list
table display rules. You must specify a style to enable the OK button in the
Add New Display Rule window.
9 (Optional) On the Alert Options tab, select the Create an alert based on
this rule check box. For more information about alerts, see “Working with
Alerts for Report Objects” on page 351.
Adding Table-Level Display Rules 405
a Click beside the Manage subscribers list to add users who you want
notified when the alert condition is met. The Add Recipients window is
displayed.
b Select one or more users. Click OK to return to the Add New Display Rule
window.
Note: A user’s e-mail address must be stored in metadata to be
displayed on the View All tab in the Add Recipients window.
10 Click OK. The table updates with the new display rule. The display rule
appears on the Display Rules tab in the right pane.
Here is an example of a display rule that uses an expression:
11 (Optional) Click on the Display Rules tab to edit the new display rule.
406 Chapter 44 / Working with Display Rules for Reports
1 If it is not already selected, select the table in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
3 Click Gauge. The Add New Display Rule window expands to show the
details for the gauge.
4 Select a Gauge type from the drop-down list. Your choices are a bullet, an
icon, a slider, or a thermometer. Icon is the default.
5 Using the Based on column drop-down list, specify which column the rule
should be based on in the report.
6 Specify where the gauge should appear in the column for the Cell
placement. Your choices are Left of text, Right of text, or Replace text.
n Enter the individual values for the intervals and then select a color. You
can click the operator between the intervals to change it.
n Click to automatically populate the intervals. The Populate Intervals
window is displayed.
Adding Table-Level Display Rules 407
9 Click OK. The table updates with the new display rule. The display rule
appears on the Display Rules tab in the right pane.
Here is an example of an automatically populated display rule that uses an
icon:
Note: If a value falls outside the bounds of the display rule intervals, no icon
is displayed in the list table
10 (Optional) Click on the Display Rules tab to edit the new display rule.
408 Chapter 44 / Working with Display Rules for Reports
1 If it is not already selected, select the list table in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
3 Click Color-mapped Values. The Add New Display Rule window expands to
show the details for the color-mapped values.
4 Select the Column or value to which you want to apply the display rule.
Note: Color-mapped values for a report object can be applied only to
category data items.
Note: Color-mapped values cannot be applied to date or datetime data
items.
7 (Optional) Repeat the steps for entering a value and selecting a color.
9 Using the list, specify where you want to apply the colors.
Adding Table-Level Display Rules 409
In the following example, values and colors have been specified for products
in a list table.
The display rule appears on the Display Rules tab in the right pane.
1 If it is not already selected, select the crosstab in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
410 Chapter 44 / Working with Display Rules for Reports
3 On the Expression Details tab, select the Column or any measure value.
4 Select the Operator. You can select =, < >, BetweenInclusive, <, <=, >, >=,
Missing, or NotMissing. The default is >.
6 If your crosstab contains a hierarchy, then you can specify the hierarchy
levels in which the display rule is applied.
b Select one or more hierarchy levels, the grand total, or all of the levels.
Click OK to return to the Add New Display Rule window. The intersections
that you selected are displayed above the Edit Intersections button.
8 Select the row or column in the Applies to drop-down list. For crosstabs, the
Applies to drop-down list displays only the measures that have been added
to the crosstab. There are no row or column options.
Adding Graph-Level Display Rules 411
9 (Optional) On the Alert Options tab, select the Create an alert based on
this rule check box. For more information about alerts, see “Working with
Alerts for Report Objects” on page 351.
a Click beside the Manage subscribers list to add users who you want
notified when the alert condition is met. The Add Recipients window is
displayed.
b Select one or more users. Click OK to return to the Add New Display Rule
window.
Note: A user’s e-mail address must be stored in metadata to be
displayed on the View All tab in the Add Recipients window.
10 Click OK. The crosstab updates with the new display rule. The display rule
appears on the Display Rules tab in the right pane.
11 (Optional) Click on the Display Rules tab to edit the new display rule.
1 If it is not already selected, select the graph in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
3 Click Expression. The Add New Display Rule window expands to show the
details for the expression.
412 Chapter 44 / Working with Display Rules for Reports
4 On the Expression Details tab, select the Column or any measure value.
5 Select the Operator. You can select =, < >, BetweenInclusive, <, <=, >, >=,
Missing, or NotMissing. The default is >.
7 If your graph contains a hierarchy, then you can specify the hierarchy levels
in which the display rule is applied.
b Select one or more hierarchy levels. Click OK to return to the Add New
Display Rule window. The intersections that you selected are displayed
above the Edit Intersections button.
Note: Background is available only for bar charts, waterfall charts, line
charts, scatter plots, time series plots, and bubble plots. It is also available
for needle plots, which are created in the SAS Visual Analytics Graph Builder
(the graph builder).
9 (Optional) On the Alert Options tab, select the Create an alert based on
this rule check box. For more information about alerts, see “Working with
Alerts for Report Objects” on page 351.
Adding Graph-Level Display Rules 413
Use the Manage subscribers list to add users who you want notified when
the alert condition is met.
10 Click OK. The graph updates with the new display rule. The display rule
appears on the Display Rules tab in the right pane.
Here is an example of a display rule that uses an expression:
11 (Optional) Click on the Display Rules tab to edit the new display rule.
1 If it is not already selected, select the graph in the canvas that you want to
update.
2 In the right pane, click the Display Rules tab. Click New. The Add New
Display Rule window is displayed.
3 Click Color-mapped Values. The Add New Display Rule window expands to
show the details for the color-mapped values.
4 Select the Column or value to which you want to apply the display rule.
Note: Color-mapped values for a report object can be applied only to
category data items.
Note: Color-mapped values cannot be applied to date or datetime data
items.
7 (Optional) Repeat the steps for entering a value and selecting a color.
9 Using the list, specify where you want to apply the colors.
Adding Gauge-Level Display Rules 415
In the following example, values and colors have been specified for products
in a graph.
The display rule appears on the Display Rules tab in the right pane.
1 If it is not already selected, select the gauge in the canvas that you want to
update.
3 Specify (or modify) the display rules for the gauge. You can populate
intervals, edit the display rule, and specify the Type.
To automatically populate the intervals:
a Click beside the Add an interval field to display the Populate Intervals
window.
c Click OK. The gauge updates and the new display rule is displayed on
the Display Rules tab.
To edit the display rule for a gauge, use the fields on the Display Rules tab. You
can update the conditions for the values, the intervals, and the color for the
range. Select a color to open the color palette. To add new intervals to the
display rule, enter a number, and click beside the Add an interval field.
1 Click on the Shared Rules tab. The Create Display Rule window is
displayed.
Adding Gauge-Level Display Rules 417
2 Enter a Name.
a Click beside the Add an interval field to display the Populate Intervals
window.
4 Click OK. The new shared display rule is added to the Shared Rules tab.
To create a shared display rule for a gauge using the Display Rules tab:
1 Click on the Display Rules tab. The Shared Rule Name window is
displayed.
2 Enter a Name.
3 Click OK. The new shared display rule is displayed below the Type field on
the Display Rules tab. The new shared display rule is also added to the
Shared Rules tab.
1 Select the shared display rule on the Shared Rules tab, and then click .
The Edit Display Rule window is displayed.
2 Update the conditions for the values, the intervals, and the color for the
range. Select a color to open the color palette. To add new intervals to the
418 Chapter 44 / Working with Display Rules for Reports
shared display rule, enter a number, and click beside the Add an interval
field.
3 Click OK.
419
45
Working with Report Filters
About Report Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Using Detail Report Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Use a Basic Report Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Use an Advanced Report Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Use a Data Source Filter in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
Using Post-Aggregate Report Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
About Post-Aggregate Report Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Create a Post-Aggregate Report Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Edit a Post-Aggregate Report Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Delete a Post-Aggregate Report Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Basic filters
subset the data for individual report objects in your reports by using a
single data item. A basic filter is constrained to use only the data item that
was selected when the basic filter was created. Basic filters can be
created and modified by using the pop-up menu for a report object or by
using the Edit Filter window. For more information, see “Use a Basic
Report Filter” on page 420.
Advanced filters
subset the data for individual report objects in your reports by using any
number of data items and operators (for example, OR and AND) in the
same expression. Advanced filters can be created and modified by using
the Advanced Filter window. For more information, see “Use an Advanced
Report Filter” on page 424.
Data source filters
subset the data for the entire report. The data source filters that you
create are applied to every report object in the report that uses that data
source. For more information, see “Use a Data Source Filter in a Report”
on page 427.
n Post-aggregate Report Filters
420 Chapter 45 / Working with Report Filters
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
TIP Clear the Auto-update check box above the report canvas until you
are ready to apply your filter changes.
3 Click beside the Add Filter button, and select a data item from the list.
Then, click Add Filter. The filter appears on the tab.
TIP Use the arrow to the left of the filter name on the Filters tab to
expand or collapse the filter details when you are working with multiple
filters.
n For a basic filter that uses discrete values, a check box is displayed for
each distinct value that uses the current format applied to the data item.
To the right of each value, a bar indicates the frequency. Select the data
values that you want to filter or clear the selections for the data values
that you do not want to filter. Select All to select all of the values.
Here is an example of a basic filter for discrete values:
n For a filter that uses continuous values, a slider shows you the maximum
values and the minimum values that exist for the data item using the
current data item format. Use the slider to select a range of target values.
Here is an example of a basic filter for continuous values:
5 (Optional) If your data contains missing values, and you want to exclude
those missing values from your report, then clear the Include missing
values check box.
6 Click (to the left of the delete icon) for options. The available options
depend on whether you are filtering characters, dates, or numerics. You can
sort the values or frequencies in the filter.
422 Chapter 45 / Working with Report Filters
Option Availability
Filter using This option is available only for measure data items.
continuous
values
Filter using This option is available for measure and category data items.
discrete values
Include Missing This option is available when you filter continuous values. It
Values works the same as selecting the Include missing values
check box.
Exclude Missing This option is available when you filter continuous values. It
Values works the same as clearing the Include missing values
check box.
Select All This option is available when you filter discrete values. It
selects all of the current discrete values that are listed. This
option does not affect the Include missing values setting.
Clear All This option is available when you filter discrete values. It
clears the selections of all of the current discrete values that
are listed. This option does not affect the Include missing
values setting.
Invert Selection This option is available when you filter discrete values. It
changes all of the discrete value check boxes so that if they
are selected, then they are cleared. If they are cleared, then
they are selected. This option does not affect the Include
missing values setting.
Sort by Values This option enables you to sort by the values in the filter.
Sort by This option enables you to sort by the frequencies in the filter.
Frequency
Show Selected at This option is available for basic filters that use discrete
Top values.
7 (Optional) If you cleared the Auto-update check box above the report
canvas while you worked on your filter, then select it when you are ready to
apply your filter changes.
Using Detail Report Filters 423
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
3 Click beside the filter name. Then, select Edit Filter. The Edit Filter
window is displayed.
n You can create an expression using both the Visual and Text tabs in the
right pane.
For information, see Appendix 6, “Conditions for Filters,” on page 607.
Note: The AND and OR operators can accept more than two conditions. To
add a condition to the operator, drag and drop a condition onto the operator
name in the right pane. For example, to add a third condition to an AND
operator, drag and drop the new condition onto AND in the expression.
424 Chapter 45 / Working with Report Filters
TIP Right-click the AND or OR operator in the expression, and then select
Add New Condition.
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
TIP Clear the Auto-update check box above the report canvas until you
are ready to apply your filter changes.
5 Specify a Filter name. The filter name identifies the advanced filter on the
Filters tab.
6 Create a condition for the filter. You can use the Visual tab, Text tab, or a
combination of both tabs.
To create a condition using the Visual tab:
a From the Data Items list, select the data item on which the condition is
based.
b From the Column Templates list, select a condition. For information, see
Appendix 6, “Conditions for Filters,” on page 607.
d For any required parameters, select the parameter, and enter a value, or
right-click on the parameter field, and select Replace with to select a
data item.
7 (Optional) Add operators to the expression. You can use the Visual tab, Text
tab, or a combination of both tabs.
To add operators using the Visual tab:
a From the Operators list, select an operator to join the conditions in your
expression. For more information, see Appendix 6, “Conditions for
Filters,” on page 607.
c From the Column Templates list, select another condition. Then, drag
and drop the additional condition onto the expression. Complete any
required parameters.
9 (Optional) If you cleared the Auto-update check box above the report
canvas while you worked on your filter, then select it when you are ready to
apply your filter changes.
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
3 Click beside the advanced filter name. Then, select Edit Filter. The Edit
Advanced Filter window is displayed.
4 Edit or add a condition for the filter. You can use the Visual tab, Text tab, or
a combination of both tabs.
To add conditions using the Visual tab:
a From the Data Items list, select the data item on which the condition is
based.
d For any required parameters, select the parameter, and enter a value, or
right-click the parameter field, and select Replace with to select a data
item.
6 (Optional) Add an operator to the expression. You can use the Visual tab,
Text tab, or a combination of both tabs.
To add an operator using the Visual tab:
a From the Operators list, select an operator to join the conditions in your
expression. For more information, see Appendix 6, “Conditions for
Filters,” on page 607.
2 Add a condition for the filter. You can use the Visual tab, Text tab, or a
combination of both tabs.
To add conditions using the Visual tab:
a From the Data Items list, select the data item on which the condition is
based.
d For any required parameters, select the parameter, and enter a value, or
right-click the parameter field, and select Replace with to select a data
item.
4 (Optional) Add an operator to the expression. You can use the Visual tab,
Text tab, or a combination of both tabs.
To add an operator using the Visual tab:
a From the Operators list, select an operator to join the conditions in your
expression. For more information, see Appendix 6, “Conditions for
Filters,” on page 607.
2 On the Data tab, click , and then select Edit Data Source Filter. The Edit
Data Source Filter window is displayed.
3 Add or modify the condition for the filter. You can use the Visual tab, Text
tab, or a combination of both tabs.
To edit conditions using the Visual tab:
a From the Data Items list, select the data item on which the condition is
based.
d For any required parameters, select the parameter, and enter a value, or
right-click the parameter field, and select Replace with to select a data
item.
4 Edit the operator in the expression. You can use the Visual tab, Text tab, or
a combination of both tabs.
n Crosstabs, time series plots, and dual axis time series plots do not support
post-aggregate filters.
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
TIP Clear the Auto-update check box above the report canvas until you
are ready to apply your filter changes.
3 Click beside the Add Filter button, and select a measure data item from
the list. Then, click Add Filter. The filter appears on the Filters tab.
4 Select the data values for the post-aggregate filter. If the data item allows
aggregate values, the Filter aggregated values check box is displayed. A
slider shows you the maximum and minimum data values that exist for the
data item using the current data item format. Use the slider to select a range
of target values.
430 Chapter 45 / Working with Report Filters
Note: The post-aggregate filter tracks the aggregation associated with the
data item. If you change the Aggregation using the data item table on the
Data tab, then the filter name on the Filter tab reflects that change. For
example, if you create a post-aggregate filter for a data item called Sales, it is
initially displayed on the Filters tab as Sales(Sum). In the data item table,
you change the aggregation to Average. On the Filters tab, the filter name is
displayed as Sales(Average). The post-aggregate filter attempts to keep
the same range of data values that you originally selected for the
aggregation.
TIP Use the arrow to the left of the filter name on the Filters tab to
expand or collapse the filter details when you are working with multiple
filters.
5 (Optional) Click beside the filter name to change the operator. Select
Condition Type, and then select an operator.
6 (Optional) Change the lower and upper values for the post-aggregate filter by
clicking the value, and then entering a new value.
7 (Optional) If your data contains missing values, and you want to exclude
those missing values from your report, then clear the Include missing
values check box.
8 (Optional) If you cleared the Auto-update check box above the report
canvas while you worked on your filter, then select it when you are ready to
apply your filter changes.
1 If it is not already selected, select the report object in the canvas that you
want to filter. The report object must have at least one data item assigned.
3 Click beside the filter name. Then, select Edit Filter. The Edit Filter
window is displayed.
Using Post-Aggregate Report Filters 431
n You can create an expression using both the Visual and Text tabs in the
right pane.
For information, see Appendix 6, “Conditions for Filters,” on page 607.
Note: The AND and OR Boolean operators can accept more than two
conditions. To add a condition to the operator, drag and drop a condition onto
the operator name in the right pane. For example, to add a third condition to
an AND operator, drag and drop the condition onto AND in the expression.
TIP Right-click the AND or OR operator in the expression, and then select
Add New Condition.
46
Working with Report Interactions
Overview of Report Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Creating a Report Interaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Create a Filter Interaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Create a Data Brushing Interaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Map Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Delete a Report Interaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
n Forecast plots
n Geo maps
Imported correlation matrices, histograms, scatter plots with fit lines, heat maps
without a selectable relational category measure, and box plots without a
selectable relational category measure cannot be the source of an interaction.
Hierarchy data items are not supported for interactions.
Here are some key points about creating filter interactions:
n You cannot create interactions from list tables, bubble plots, and scatter plots
that use detail data. However, a list table that uses detail data can be the
target of an interaction.
n Scatter plots cannot be the source of an interaction.
1 Add the report objects that you want to use to the canvas. For example, you
might have a bar chart, a line chart, and a list table.
3 In the interactions view, draw a connection between the source and target
report objects. When you have created an interaction, the is displayed
between the report objects. Here is an example of an interaction between a
bar chart (the source) and a list table (the target):
Note: The source and target of an interaction should be based on the same
data source. If you have multiple data sources, you are prompted to map the
data sources to create the interaction. For more information, see “Map Data
Sources” on page 444.
Select data in the source report object to filter data in the target report object (or
objects). In the following example, the promotional product line was selected in
Creating a Report Interaction 437
the bar chart. Simultaneously, the line chart and the list table show the same
filter.
Figure 46.1 A Filtering Example with a Bar Chart, a Line Chart, and a List Table
Clicking on another selection applies the filter based on your new selection. For
example, in the report above, you can click on the game product line to change
the filter. An icon is added to the report object that is filtered.
Here is the line chart that was used in the previous example. The incoming filter
icon appears above the report object when it is selected in the canvas. Click
to get details about the filter that has been applied. Click Details to find out more
438 Chapter 46 / Working with Report Interactions
about the filter. The Visual Element Filters window is displayed. It shows the
exact query that was sent to the server.
TIP To clear the selection and reset the filter (or filters), press Ctrl+click while
viewing the original report object.
1 Select a report object in the canvas. For example, you might have a bar
chart.
3 Click New, and then select Interaction. The Edit Interaction window is
displayed.
Creating a Report Interaction 439
4 In the Edit Interaction window, select the report object that you want to use
as the source of a filter or brush interaction. For example, if your report has a
list table, and you want it to filter a line chart, the first line should read List
Table 1 filters Line Chart 1.
The Edit Interaction window disables options for filter or brush interactions if
they are not possible.
5 When you are finished working with interactions, click OK. The new
interaction is displayed in the Interactions tab.
n Forecast plots
n Geo maps
1 Add the report objects that you want to use to the canvas. For example, you
might have a bar chart, a line chart, and a list table.
4 In the interactions view, draw a connection between the source and target
report objects. When you have created an interaction, the is displayed
between the report objects.
Note: The source and target of a data brushing interaction should be based
on the same data source. If you have multiple data sources, you are
prompted to map the data sources to create the interaction. For more
information, see “Map Data Sources” on page 444.
Select data in the source report object to brush data in the target report object
(or objects). In the following example, the stuffed animal product line was
selected in the bar chart. Simultaneously, the line chart and the list table
highlight the same data.
440 Chapter 46 / Working with Report Interactions
Figure 46.2 A Data Brushing Example with a Bar Chart, a Line Chart, and a List Table
Here is an example of a report with three list controls that have brush
interactions:
The first list contains three countries listed as the Origin. The second list
contains six types of vehicles. The third list contains 38 car manufacturing
companies. There is a brush interaction between the first list and the second list.
There is a second brush interaction between the second list and the third list.
442 Chapter 46 / Working with Report Interactions
In step 1, the user has selected Europe as the country of Origin in the first list.
Notice the changes in the second list. Hybrid and Truck are grayed out, and
their frequency values have both changed to 0. In the third list, all of the car
Creating a Report Interaction 443
manufacturers that are not located in Europe are grayed out, and their frequency
values have all changed to 0.
Figure 46.5 Example: Three List Controls in a Report with One Brush Interaction
In step 2, the user has selected Porsche as the car manufacturing company in
the third list. Notice the changes in the second list. Hybrid, Sedan, Truck, and
Wagon are grayed out, and their frequency values have all changed to 0.
Figure 46.6 Example: Three List Controls in a Report with Two Brush Interactions
444 Chapter 46 / Working with Report Interactions
Here are some key points about mapping columns in data sources:
n A column in one data source can be mapped only once to another data
source. If you need to map a column more than once, then the column needs
to be duplicated in the data source.
n Mapped columns must share the same format for filters to work. For
example, if the format of the source column is MMDDYYYY and the format of
the target column is DDMMYYYY, then a filter will not work.
To map data sources using the Map Data Sources window:
1 Use the Source drop-down list to select a column from the first data source.
2 Use the Target drop-down list to select a corresponding column from the
second data source.
Creating a Report Interaction 445
TIP If there are multiple data sources, and you do not want to link to all of
them, you can select the Enable data source mapping check box. For
more information, see “Map Data Sources” on page 444.
For section links, you are not required to map the data sources. If you
choose not to map the data sources, then the filters are not carried over. For
more information, see “Create a Link to One or More Sections in a Report”
on page 451.
446 Chapter 46 / Working with Report Interactions
Here is an example of the Create Section Link window with the map data
sources information.
3 Map additional data items. Click . A new row is displayed in the Map Data
Sources window.
Note: If you create interactions between multiple objects on the same data
source, but on different columns in that data source, then you must map
each and every column in a Map Data Sources window. If you do not do this,
then a subsequent mapping for the data source overrides a previous
mapping.
4 The lower half of the window shows you how the mappings are applied to the
objects shown in the Source and Target relationship. Depending on the
interaction or link, you might need to map additional Source and Target
objects.
5 Click OK.
To delete either a filter or data brushing interaction using the interactions view:
2 Click Interactions View to switch to the interactions view. You can also
select View Show Interactions.
You can delete an interaction using the Interactions tab. Click next to the
interaction that you want to delete. Then, click Delete in the confirmation
message that is displayed.
448 Chapter 46 / Working with Report Interactions
449
47
Working with Report Links
Overview of Report Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Creating Report Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
Create a Link to Another Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
Create a Link to One or More Sections in a Report . . . . . . . . . . . . . . . . . . . . . . . . . 451
Create a Link to One or More Info Windows in a Report . . . . . . . . . . . . . . . . . . . . 452
Create a Link to an External URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
Create a Link from a Text Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
Edit a Report Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
Delete a Report Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
Example: How Report Links and Report Interactions Work Together . . . . . . . 455
Linking has elements of both a filter and an interaction. A report section that is
the target of a link is filtered by the values that are selected in the linked report
object. And, like interactions, objects that display detail data cannot be the
source of a link.
For information about how links appear in the viewer, see “View Links in
Reports” on page 544.
Imported box plots and heat maps with a relational category measure and
imported forecast plots can be the source of section, report, or external links.
Starting in the 7.4 release, you can synchronize prompt values and parameters
across linked reports. For example, suppose that you have two reports, Report 1
and Report 2. When you follow a link from Report 1 to Report 2, all of the
prompts and their values are displayed in Report 2, and their states are
synchronized. The same is true when you move from Report 2 to Report 1.
1 If a report object is not already selected, select the object that you want to
link from.
3 Click New, and then select Report Link. The Choose an Item window is
displayed.
4 Select a target report, and then click OK. The Create Report Link window is
displayed.
5 Verify the name of the target report. If you want to select a different target
report, click Browse.
Creating Report Links 451
Note: The source and target of report link should be based on the same
data source. If you have multiple data sources, you are prompted to map the
data sources to create the report link. For more information, see “Map Data
Sources” on page 444.
If the target report contains more than one section, then select the report
section that you want to open first.
If you want to set values in the target report, select the Set the value for
controls in the target report prompt bar option.
Note: This option sets values only on the controls that use the same data
item as the source object or only on data items that filter the source object.
6 Click OK. The new report link is displayed on the Interactions tab in the right
pane.
Double-click on an item in the report object (for example, a bar, a row in a table,
a pie slice, and so on) to activate the report link. You are prompted to save
changes to the report object before you can follow the link to the target report. To
return to the source report object, use the button above the canvas.
Here is an example of the button that enables you to return to the source report
object: .
1 If a report object is not already selected, select the object that you want to
link from.
3 Click New, and then select Section Link. The Create Section Link window is
displayed.
452 Chapter 47 / Working with Report Links
4 Select All to link to all of the sections in the report or select a specific section
(or sections) in the report.
Note: The source and target of section link should be based on the same
data source. If you have multiple data sources, you are prompted to map the
data sources to create the section link. For more information, see “Map Data
Sources” on page 444.
If you want to set values in the target section, select the Set the value for
controls in the target section prompt bar option.
Note: This option sets values only on the controls that use the same data
item as the source object or only on data items that filter the source object.
5 Click OK. The new section link is displayed on the Interactions tab in the
right pane. If you selected multiple sections, those links are displayed on the
Interactions tab.
Alternatively, you can create a section link using the interactions view.
Note: If you use a section link to navigate to another section, and then you
change the value of a report prompt, the section link filter is removed.
2 Click New, and then select Info Window Link. The Create Info Window Link
window is displayed.
3 Select All to link to all of the info windows in the report, or select a specific
info window in the report.
Note: The source and target of the info window link should be based on the
same data source. If you have multiple data sources, you are prompted to
map the data sources to create the info window link. For more information,
see “Map Data Sources” on page 444.
4 Click OK. The new info window link is displayed on the Interactions tab in
the right pane. If you selected multiple info windows to link to, those links are
displayed on the Interactions tab.
Creating Report Links 453
TIP Click the Link to Stored Process button in the Create External Link
window to link to a stored process without having to enter the required link
information.
2 Click New, and then select External Link. The Create External Link window
is displayed.
TIP Do not add parameters to the URL field. Click to specify additional
parameters, such as a Target. These additional parameters are
automatically added to the URL.
5 (Optional) Click to specify additional parameters for the link. You can
specify the Format value option, a Source, and a Target. The Format value
option applies only to dates and numbers. You can add multiple parameters.
For example, you might have a report for your company’s product lines.
When a user views the report, you want them to be able to double-click a
product line in the line chart, and then link to a Google search for that product
line. In the Create External Link window for this example, you would enter
http://www.google.com/search as the URL, select ProductLine as the
Source, and then enter q as the Target.
454 Chapter 47 / Working with Report Links
6 Press Enter or Tab to activate the OK button. Click OK. The new external link
is displayed on the Interactions tab in the right pane.
1 Double-click inside a text object on the canvas and enter the text.
2 Selecting some or all of the text, and then click in the floating toolbar.
Select Hyperlink. The Link Setup window is displayed.
TIP To change the default color of the hyperlinked text, you need to select
a leading blank space and a trailing blank space around the hyperlinked
text.
TIP You can use the pop-up menu to cut, copy, and delete text. However,
you have to use the keyboard shortcut (Ctrl+V) to paste text. Do not copy
or paste text with hyperlinks. Instead, duplicate or import the text object.
4 Click OK. The text that you selected is a link in the text object.
1 Click next to the link on the Interactions tab. For a report link, the Edit
Report Link window is displayed. For an external link, the Edit External Link
window is displayed.
To delete a link from a text object, select the linked text, and then click .
Select Delete Link.
When you double-click the CANADA bar in the first report, the second report
(which is the target of the report link) is displayed. The filter interaction for
country in the first report is automatically passed to the second report when you
link to it. Here is an example of the second report:
Example: How Report Links and Report Interactions Work Together 457
You can remove the applied filter by clicking beside the in the upper left
corner. Select the Apply report link filters option. After you remove the applied
filter, you can choose to apply it again by selecting the Apply report link filters
option.
48
Ranking Values in Reports
Overview of Ranking in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Add a New Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Delete a Rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
2 Select a data item. You can select any category or geography data item,
regardless of whether it is assigned to the current report object.
For list tables only, you can select All visible categories. This rank ranks
across the intersection. The top or bottom combination of the visible
categories is displayed. For example, you select the region and product data
items. You rank on the top 10 by profit. The top 10 region and product
combinations are displayed. In this case, the column is no longer considered
a single column, it is considered the crossing of the columns.
Note: If a list table has a rank for All visible categories, then that is the
only rank that it can have.
The Detail rank option is available for list tables, bubble plots, and scatter
plots that show detail data. If the report object has a detail rank, then it is the
only rank that it can have. Otherwise, report objects can have multiple ranks.
4 Select the type of rank from the drop-down list. These types are available:
n Top Count specifies that the rank selects the greatest values.
n Bottom Count specifies that the rank selects the least values.
n Top Percent specifies that the rank selects the greatest percentages.
n Bottom Percent specifies that the rank selects the least percentages.
5 If you selected Top Count or Bottom Count for the rank, then specify one of
the following:
n Select Count, and then select a number for the rank. For example, if you
select 5, then the rank selects the five greatest values.
n Select a Parameter. If there is more than one parameter available, use
the drop-down list to select the one that you want. For more information,
see Chapter 49, “Working with Parameters in Reports,” on page 463.
6 If you selected Top Percent or Bottom Percent for the rank, then specify
one of the following:
n Select Percent, and then enter a number between 0.1 and 99.9 in the %
field.
n Select a Parameter. If there is more than one parameter available, use
the drop-down list to select the one that you want. For more information,
see Chapter 49, “Working with Parameters in Reports,” on page 463.
Add a New Rank 461
7 From the By drop-down list, select the measure that is used to create the
rank. You can select any measure.
9 (Optional) For category-specific ranks, you can select All Other to show the
measurements for the categories that did not qualify as a top or bottom
value. This option is not available if the report object is showing only detail
values.
Here are some key points about the All Other option:
n The option is available when you are ranking visible categories in certain
types of report objects.
n The option applies only to the category that is being ranked. For example,
suppose that you have Region and Product categories assigned to a list
table. Then, you apply a Region rank with the All Other option set, so the
“All Other” value might appear as a Region value, but not as a Product
value.
If you want to combine category values that are excluded by rank into “All
Other”, then you need to use the All Other property. For more
information, see “Use the Combine Excluded Rows (or Cells) into “All
Other” Properties” on page 327.
n The option is not available if the rank is on a prompt control, geo bubble
map, geo coordinate map, or geo region map.
n When the option is specified for a report object, the total, subtotal, and
percent of total show values with respect to all of the data, rather than
data just relative to data qualifying under the rank. The data that does not
fit into the top or bottom of the rank is aggregated in the All Other
category.
n You can use this option with a ranking to reduce the number of slices in a
pie chart. However, this means the “Other” slice must be removed from
the pie chart.
n If this option is selected, then any All Other value that appears in a table
or graph cannot be selected. This means that the All Other value cannot
be the source value for an interaction.
n If you do not select All Other, then the rank shows only the data as
filtered by the category values that qualify as the top or bottom value.
Here is an example of a pie chart that shows the profit for multiple product lines
before a rank is applied:
Figure 48.1 Pie Chart with Profits for Each Product Line Displayed
Here is the same pie chart after a rank of the top five product lines is added. The
All Other option was selected, so the “Other” slice is not displayed.
Figure 48.2 Pie Chart with Profits for the Top Five Product Lines Displayed
Delete a Rank
To delete a rank, click on the rank on the Ranks tab.
You can also right-click on the report object, and select Delete Rank, as long as
there is only one rank for the report object.
463
49
Working with Parameters in Reports
Overview of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Where Parameters Can Be Used in the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Create a New Parameter for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Edit a Parameter for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Delete a Parameter for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Example: Using Parameters in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Example: Using a Numeric Parameter in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Overview of Parameters
A parameter is a variable whose value can be changed and that can be
referenced by other report objects. The SAS Visual Analytics Designer (the
designer) supports parameters for controls in reports. If a control has an
associated parameter, then when the value of the control changes, the
parameter is assigned that changed value. When the value of the parameter
changes, any report objects that reference the parameter detect the change
accordingly.
Starting in the 7.4 release, you can create parameters for date and datetime
data items. You can also create parameters that store multiple values.
Here are some key points about parameters:
n The type of parameter is required to match the type of data that is assigned
to the control.
n If you duplicate a control with a parameter, the parameter is not copied from
the original control.
n You cannot delete a parameter that is being used by a calculation, rank, filter,
display rule, or text object.
Whenever a parameter value is updated, then all display rules, ranks,
calculations, and filters that use that parameter are updated. Any report object in
the report that uses the display rule, rank, calculation, or filter is updated
accordingly. For an example of how parameters can be used in a complex
report, see “Example: Using Parameters in a Report” on page 467.
464 Chapter 49 / Working with Parameters in Reports
1 Click , and then select New Parameter. The Create Parameter window is
displayed.
3 Select the Type for the parameter. You can select one of the following:
n Numeric
n Character
n Date
n Datetime
n Numeric list
n Character list
n Date list
n Datetime list
n Format.
466 Chapter 49 / Working with Parameters in Reports
Click Select to open the Select Format window, where you can select a
Format type, Width, and Decimals. Click OK in the Select Format
window.
For date, datetime, numeric list, date list, and datetime list parameters, select
a Format. The date and datetime parameters also require the following:
n Minimum value
n Maximum value
n Current value
4 Click OK in the Create Parameter window. The icon identifies the new
parameter in the list of data items on the Data tab.
You can create and edit parameters from the filter window and the calculated
item window.
1 Right-click the parameter on the Data tab, and select Edit Parameter. The
Edit Parameter window is displayed.
1 Right-click the parameter on the Data tab, and select Delete Parameter.
The report has two sliders, a list table, and a bar chart. One slider lets you adjust
the number of miles that you drive each day. The other slider lets you adjust the
price per gallon of gasoline. The results of the selections in the sliders are
calculated, and the values are used in a calculated data item that is displayed in
the list table. For example, you can see what happens to the list table when you
change the parameter for Miles driven per day from 25 to 100.
The values of the calculated data item are also used in the bar chart. The bar
chart has a display rule, (MPG (City) > Miles per day), so that vehicles that have
a fuel economy value that is better than the number of miles that you drive per
day are highlighted.
468 Chapter 49 / Working with Parameters in Reports
1 Drag a button bar control from the Objects tab, and drop it onto the canvas.
2 Convert the Cylinders data item by right-clicking on it in the Data tab, and
then selecting Category.
a Right-click the Cylinders data item in the Data tab, and then select Create
Parameter from Data Item. The Create Parameter window is displayed.
d Specify the Minimum value, Maximum value, and Current value for the
numeric parameter.
Here is an example of the Create Parameter window:
e Click OK. The new numeric parameter is added to the Data tab, under
the Parameter heading.
Example: Using a Numeric Parameter in a Report 469
4 Drag the Cylinders data item, and drop it onto the button bar control.
5 Drag the Cylinders parameter, and drop it onto the button bar control. The
button bar is populated with the values for the numeric parameter.
470 Chapter 49 / Working with Parameters in Reports
471
50
Maintaining Multi-Section Reports
Overview of Report Sections and Info Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Add a Section to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Add an Info Window to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Reorder Report Sections or Info Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Rename a Report Section or an Info Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Duplicate a Report Section or an Info Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Move a Report Object to Another Section or Info Window . . . . . . . . . . . . . . . . . . 474
Delete a Report Section or an Info Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
Info windows can be created only in the designer. A report can have one or more
info windows, which are displayed as private tabs in the designer. Info windows
are identified by the icon on the tab above the canvas. Info windows can
have one or more report objects. You must provide a link to an info window from
an existing report object to display a new window in the viewer.
Note: Section prompts are not allowed in info windows.
To add a new section to a report, click to the right of the first section tab (or
the last section tab that was added) in the report. The new tab appears to the
right of the existing tab (or tabs).
Here is an example of multiple section tabs:
You can use the Properties tab for the report to add a new section. In the
Sections area, click . The new tab appears to the right of the existing tab (or
tabs).
To add an info window, click on the Section tab, and then select Display as
Info Window. The tab name changes to Info Window. The Properties tab also
updates.
For information about adding a link to an info window, see “Create a Link to One
or More Info Windows in a Report” on page 452.
Duplicate a Report Section or an Info Window 473
3 In the Sections area, select the name of a section or an info window. Click
or to reorder the sections or info windows.
1 Right-click the section tab or the info window tab that you want to rename.
Select Rename. The existing name is highlighted.
2 Type a new name, and then press Enter. The new name also appears on the
Properties tab in the right pane.
1 Right-click the section tab or the info window tab that you want to duplicate.
2 Select Duplicate. All of the report objects and the data in the original section
or info window are copied to the duplicate section or info window. The
duplicate appears on a new tab. For example, if the original section’s name is
Marketing Reports, then the duplicate section is named Marketing
Reports (1).
3 Rename the duplicated section or info window using the pop-up menu or the
Properties tab.
474 Chapter 50 / Maintaining Multi-Section Reports
TIP You can drag an object from one section and drop it onto the tab for
another section to move it to that section.
Note: You cannot move a section prompt from a section to an info window.
If you move an object to a section with precision layout, then you must manually
move the object to its proper location. All objects are put in the top left corner by
default.
TIP If you move a section prompt from one section to another section in a
report and there are multiple data sources, you must edit the data source
mapping for an interaction to work. Right-click the control, and select Edit
Data Source Mapping. For more information, see “Map Data Sources” on
page 444.
Alternatively, click on the section tab or info window tab, and then select
Delete <Section Name or Info Window Name>, where <Section Name or
Info Window Name> is the name of the section or the info window. (For
example, Section 1, Info Window 1, and so on.)
Note: The Delete menu option is not available if the report has only one
section.
475
51
Sharing Reports with Other Users
Overview of Sharing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
E-mail a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
Printing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
General Considerations for Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
Considerations for Printing a Stored Process or Stored Process Report . . . . . 478
Print a Report, a Report Section, or a Report Object . . . . . . . . . . . . . . . . . . . . . . . 478
Exporting Content from the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
Overview of Exporting from the Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
Export an Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
Export Data from a List Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Export Data from a Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Export Data from a Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Add Comments to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Distributing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Overview of Distributing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Add a New Report Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
Create a Report Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Manage Report Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
Localize Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
n print reports
n localize (or translate) labels, tooltips, and other descriptive text in reports
476 Chapter 51 / Sharing Reports with Other Users
E-mail a Report
You can e-mail a link to a report to someone using the designer. Here are some
key points about what happens when a recipient clicks the link to a report:
n If the recipient has already signed in to SAS, the report is displayed when the
report link is clicked.
n If the recipient is not signed in to SAS, they are prompted for a user ID and
password. Starting in the 7.3 release, recipients can sign in as a guest by
clicking Guest on the standard sign-in window for SAS applications.
n If the recipient opens the e-mail message on a PC or Mac with a Flash-
enabled viewer, and then clicks the e-mail link, then the report is displayed in
SAS Visual Analytics Viewer (the viewer).
n If the recipient opens the e-mail message on a mobile device, and then clicks
the e-mail link, then the report is displayed using the SAS Visual Analytics
App (previously called SAS Mobile BI) if the user has it installed.
TIP Recipients who use SAS Home (the home page) can use the
Application Shortcuts setting to specify which application opens the report
when they click on an e-mail link. For more information about settings, refer to
the online Help that is available for the home page.
TIP Recipients who use the classic SAS Visual Analytics home page can use
the Order the actions associated with a content type preference to specify
which application opens the report when you click on an e-mail link. For more
information, see “Specifying Your Preferences for the Classic SAS Visual
Analytics Home Page” on page 637.
1 Select File E-mail. The new e-mail message opens in your default e-mail
application.
The designer automatically adds a subject line with the report name. The
URL for the report is automatically generated and appears in the e-mail
message.
Note: Only locally installed e-mail clients are supported. If your default e-
mail application is web-based (for example, Gmail), you cannot e-mail a
report.
2 Add recipients.
Printing Reports
You can create a PDF for a report, a report section, or a report object. The PDF
can then be printed.
TIP In the generated PDF, click to see the content that was clipped in
the layout of the report section in the designer.
n If a list table or a crosstab has scroll bars, then some of the scrolled content
might not be printed. However, more columns or rows might be printed than
are visible in the designer. The print feature attempts to fill the space
available on the page in the PDF.
n A list table or crosstab that is printed from the designer might show more
rows than when the same list table or crosstab is printed after the report has
been distributed. This happens because the state of the report in the
designer is taken into consideration when it is printed. The print feature
attempts to match what the user sees in the designer. When you print a
report that has been distributed, there is no report state for the print feature
to match.
n If a report object has a high-cardinality filter, and the Show appendix
information option is selected, then the filter description might be truncated
in the printed appendix.
n A crosstab with more than 5,000 selected cells cannot be printed.
n There can be differences in the fonts in a printed report if the fonts that are
used to create a report do not match the fonts that are available on the
server that generates the PDF.
n If you want to print from the designer using Mozilla Firefox, you must have
Firefox configured to open a link in a new tab instead of in a new window.
Instructions for making this change might vary between Firefox releases, so
refer to the Firefox documentation. As an alternative, you can use a different
supported browser, such as Microsoft Internet Explorer or Google Chrome.
478 Chapter 51 / Sharing Reports with Other Users
n The stored process must use the %STPBEGIN and %STPEND macros.
These macros provide standardized functionality for generating and
delivering output from a stored process. For more information, see “Using the
%STPBEGIN and %STPEND Macros” in SAS Stored Processes:
Developer’s Guide.
n PDF security must be turned off for a stored process.
n The stored process report must be configured to produce PDF output. In the
stored process that is referenced by the stored process report, set the
_ODSDEST variable to PDF. Or, define a stored process parameter for the
_ODSDEST variable and configure it with a value of PDF for the stored
process report. It is recommended that you also set the _ODSOPTIONS
variable to notoc to save processing time and to reduce the size of the PDF
produced by the stored process and the final PDF. For more information
about ODS options, see “Using the %STPBEGIN and %STPEND Macros” in
SAS Stored Processes: Developer’s Guide.
2 Select the Paper size, Orientation, and Margins. Your selections are saved
for that report.
If you select Custom for the paper size, you can specify the Height, and
Width of the page. For custom paper sizes, you cannot change the page
orientation.
n The Show empty rows and columns in tables option is for both list
tables and crosstabs.
n The Show appendix information option is selected by default if the
report, report section, or report object has parameters, descriptions,
filters, warnings, errors, or display rule legends.
When the Show appendix information option is specified, and the
report, report section, or report object has parameters, descriptions,
filters, warnings, errors, or display rule legends, then an appendix is
created. Each report object that is selected to be included in the PDF is
automatically assigned a value so that you can reference that report
object in the appendix. For example, suppose that you select two report
objects in the Select the items to be printed list. The first report object is
assigned the value A1.1 and the second report object is assigned the
value A1.2. Suppose that the first report object has a description and the
second report object has a filter that has been applied. The first report
object’s description is displayed in the appendix under the A1.1 heading.
The second report object’s filter is displayed in the appendix under the
A1.2 heading.
4 Make your selections in the Select the items to be printed list. You can
select the report, the report sections, or the report objects.
6 (Optional) If you want to save any changes that you made in the Print
window, then save the report.
TIP The print options that you save with the report are used when you
distribute the report to other users. Saved print options can impact the
appearance of the report.
To print a report section, click on the Section tab, and then select Print
<section-name> to PDF.
To print a report object, right-click on the report object in the canvas, and then
select Print <report-object-name> to PDF. A stored process does not have the
same pop-up menu selection.
The following table lists the icons that can appear in the appendix:
Icon Description
Export an Image
You can export an image for any list table, crosstab, graph, or gauge in a report.
This is useful if you want to include the image of a report object in a
presentation, such as in Microsoft PowerPoint. Images are saved as PNG files.
Here are key points about exporting an image:
n An exported image does not show ranks or filters that are associated with the
report object.
n The image defaults to the size of the report object in the report.
1 If the list table, crosstab, graph, or gauge that you want to export is not
already selected, select it.
2 Right-click the report object, and select Export Image. The Save Image
window is displayed.
1 If the list table that you want to export is not already selected, select it.
6 If you select Export to, then the only option is Excel 2007 Workbook
(*.xlsx) to create a Microsoft Excel spreadsheet.
8 Click OK.
9 When you are prompted, choose either to open the file or to save it.
1 If the crosstab that you want to export is not already selected, select it.
482 Chapter 51 / Sharing Reports with Other Users
6 If you select Export to, then the only option is Excel 2007 Workbook
(*.xlsx) to create a Microsoft Excel spreadsheet.
8 Click OK.
9 When you are prompted, choose either to open the file or to save it.
Note: The designer exports data from a crosstab into a list table. This is
different from SAS Visual Analytics Explorer (the explorer), which exports data
from a crosstab into a crosstab.
1 If the graph that you want to export is not already selected, select it.
Exporting Content from the Designer 483
6 (Optional) Choose whether detail data is exported for the graph. If you select
Detailed data, then you can select the columns that you want to export.
Note: The Detailed data option is not available for imported report objects,
custom graph objects that have multiple data definitions, or for any graphs in
which detail data is not allowed.
7 If you select Export to, then the only option is Excel 2007 Workbook
(*.xlsx) to create a Microsoft Excel spreadsheet.
9 Click OK.
10 When you are prompted, choose either to open the file or to save it.
484 Chapter 51 / Sharing Reports with Other Users
TIP You must save a report before you can add comments.
Distributing Reports
TIP The print options that you save with a report are used when you
distribute the report to other users.
2 Click New Report Job. The New Report Job window is displayed.
3 Enter a Name. The report job name cannot contain blanks, white space, or
these characters: ! " $ % & ' ( ) * . + , / : ; < = > ? @ [ \ ]
^ ` | ~ ‑
Note: Report jobs cannot be renamed.
TIP If the report that you want is not displayed in the pop-up list, click
Select another report, and use the Open window to find the report that
you want to distribute.
486 Chapter 51 / Sharing Reports with Other Users
n The Show the report job owner in the message option enables you to
have your name appear in the e-mail message. Because the mail service
cannot display the report job owner’s name in the From field of the e-mail
message, this is the only way to inform recipients who created the report
job.
6 Use the Notifications tab to specify that you want to receive the report job
owner notifications. You can select Send e-mail notification when the
report job starts, Send e-mail notification when the report job ends, or
both.
Note: If there is a warning (for example, when a recipient or a report cannot
be found), then you automatically receive a notification with the details when
the report job ends.
7 Click OK. The report job is displayed in the table in the Distribute Reports
window.
2 Select a report job, and click Schedule. The Schedule window is displayed.
3 Click New to create a time event. The Specify Schedule Details window is
displayed.
4 Specify whether the distribution should happen One time only or More than
once. By default, a new time event is defined to occur only once at a time
that is approximately five minutes later than the time that you opened the
Specify Schedule Details window.
If you select One time only, then select an Hour and a Minute for the
distribution.
If you select More than once, then specify the details about when the
distribution should occur. The specific fields that are available depend on the
recurrence interval (Hourly, Daily, Weekly, Monthly, or Yearly) that you
select.
n If you select Hourly, then the time is calculated from hour zero on a 24-
hour clock. For example, if you leave Interval hour set to 1, then the data
query runs at hour zero (midnight) and runs each hour.
Select an Interval hour, and then select a Starting hour and Minute.
Distributing Reports 487
The following options are specific to the recurrence interval that you select:
5 Click OK to return to the Schedule window. The new schedule details are
displayed under the Schedule heading.
7 (Optional) Click Run Now to have the distribution run immediately. Click
Close in the information window.
8 Click Close.
TIP You can delete a distribution if it contains only report jobs that you own.
To see the history record for a selected distribution that has been run, click
Show History. The Show History window is displayed. You can see the Start
Time, Finish Time, State, and Status Message. Click Close to return to the
Distribute Reports window.
Localize Reports
The designer enables you to localize (or translate) the labels, tooltips, and other
descriptive text that is part of your report. You can export localizable text from
Localize Reports 489
your report so that you can apply one or more translations. You can translate
your report into a new language without removing the text from the designer.
There is no limit to the number of translations that you can add to the report.
490 Chapter 51 / Sharing Reports with Other Users
TIP If you localize a report and want to see the results immediately, it is
recommended that you set the User locale setting or preference. For
information about settings and the modern home page, refer to the online
Help. For more information about preferences, see “Specify Global
Preferences Using the Classic Home Page” on page 637.
To localize a report:
1 Select File Save As to save a copy of the report. This enables you to have
a backup copy of your report.
The first line in the Localize Report Text window contains the locale identifier,
which is specified by the ISO 693 two-letter language code. If a language is
created for a specific country or region, the language code can be followed
by an underscore ( _ ) and the ISO 693 two-letter country code. In the
preceding screen capture, the en_US country code is displayed.
3 Localize the original text strings. You have the following options:
n Save the text in the Localize Report Text window to a file, modify the file,
and then open the modified file in the Localize Report Text window.
n Modify the text in the Localize Report Text window.
n Copy and paste the text from the Localize Report Text window into an
editor.
CAUTION! All report text is encoded as Unicode characters using the
UTF-8 format. If you export the localizable text to an editor, make sure that the
editor is capable of saving the data as UTF-8.
The report text is displayed in the browser’s locale or in the User locale that
you specified for your global settings or preferences. For information about
settings and the modern home page, refer to the online Help. For more
information about preferences, see “Specify Global Preferences Using the
Classic Home Page” on page 637.
Part 7
Creating Custom Graph Objects
Chapter 52
Creating and Using Custom Graph Objects . . . . . . . . . . . . . . . . . . . . . . . . . 495
Chapter 53
Modifying Custom Graph Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
Chapter 54
Graph Builder Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
494
495
52
Creating and Using Custom Graph
Objects
About the Graph Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
About the Graph Template Gallery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Build a Custom Graph Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Working with Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
About Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
Create Optional Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
Types of Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Adding a Graph Element to an Existing Graph Object . . . . . . . . . . . . . . . . . . . . . . 500
Add an Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
Add a Graph Element to a New Row or Column . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
Incompatible Graph Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
Creating a Data-Driven Lattice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
About Data-Driven Lattices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
Create a Data-Driven Lattice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
Save a Custom Graph Object So It Appears in the Designer . . . . . . . . . . . . . . . . 507
Add a Graph Object to the Designer’s Objects Tab . . . . . . . . . . . . . . . . . . . . . . . . . 508
Specify Your Preferences for the Graph Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
with the graph builder. Report designers assign data when they include your
graph objects in their reports.
The graph objects that you build have a consistent appearance that is
compatible with the designer’s graph objects. The graph builder enables you to
produce a wide array of graph objects with more options for layouts and visual
properties. Using the graph objects that you build, report designers can create
simple or complex graphical views of their data.
You can do the following in the graph builder:
n drag and drop graph elements onto the canvas. Graph elements include the
plots and charts that are available from the Graph Elements pane.
For a definition and a picture of each available graph element, see “Graphs,
Charts, and Plots” on page 555.
n use a gallery of predefined graph objects as templates from which you can
build and customize custom graph objects. For more information, see “About
the Graph Template Gallery” on page 496.
n combine and arrange the graph elements as needed. For example, you can
layer multiple graph elements in a cell, create a lattice of cells in rows and
columns, or combine these layouts.
There are two types of lattice graphs:
o A data-driven lattice is a multi-cell graph in which the cell data is
determined by the values of one or more class variables. The number of
cells is determined by the unique values of the class variables. Each cell
of the lattice has the same graph elements. However, these graph
elements have different values of the class variables.
o A user-defined lattice is a multi-cell graph in which you create each cell
independently. Each cell can contain different types of plots.
n determine and configure which data roles become available for assignment.
For more information, see “Working with Roles” on page 498.
n specify the visual attributes of the graph elements. You can specify
properties for the graph, the graph cells, for individual graph elements, for the
axes, and for legends. For more information, see “Working with Properties”
on page 517.
TIP All of the graph objects in the gallery are available as is for use in
reports. However, these graph objects are not all displayed in the designer by
default. Use the designer’s Show or Hide Objects window to display the graph
objects on the designer’s Objects tab.
Build a Custom Graph Object 497
n In the gallery, select a category in the left pane to see the available graph
objects. You can then select the appropriate graph object from the right pane.
For more information, see “Build a Custom Graph Object” on page 497.
n Some of the gallery graphs are created as data-driven lattices. When you
select one of these graphs from the gallery, row and column lattice roles are
automatically created. If you want to create a user-defined lattice from one of
these gallery graphs, you must first delete the row and column lattice roles.
2 Select a category in the left pane to see the available graph objects.
The All category shows all of the graph objects that are in the gallery.
3 When you find the graph object that you want, select the object, and
click OK.
Note: Some of the gallery graphs are created as data-driven lattices. For
more information, see “About the Graph Template Gallery” on page 496.
Sample data is used in the graph object. The report designer assigns real
data when he or she includes the graph object in a report.
2 (Optional) On the Role Definitions tab, you can define roles for the graph
object.
You have the following options:
n Provide more descriptive names for the default roles.
3 (Optional) You can add additional graph elements to the graph object. See
“Adding a Graph Element to an Existing Graph Object” on page 500.
498 Chapter 52 / Creating and Using Custom Graph Objects
4 (Optional) You can change the properties for the graph object, the cell, the
graph element, the legend, or one or more axes. Select the item, and make
your changes on the Properties tab.
5 Save the graph object. Depending on where you save the graph object, it
might be immediately displayed on the Objects tab in SAS Visual Analytics
Designer (the designer). For more information, see “Save a Custom Graph
Object So It Appears in the Designer” on page 507.
About Roles
When you create a custom graph object, you determine which data roles
become available for assignment. However, you do not assign data to those
roles in the graph builder. When the graph object becomes available to report
designers for use in their reports, the report designers assign data items to the
available roles.
1 On the Role Definitions tab, click Add Role. The Add Role window is
displayed. The contents of the Add Role window vary depending on the
current graph element.
2 Select the type of role that you want to create. For more information, see
“Types of Roles” on page 499.
3 (Optional) You can change the default role name to provide a more
meaningful name.
4 Select the data type, or classification, for the role. For information about the
data types, see “Working with Data Items in a Report” on page 363.
6 If the Allow multiple data assignments check box is available, then you
can select or clear the check box. When this option is selected, the role can
have more than one measure assigned. For example, in a line chart, if
multiple measures are assigned to the Y axis, then the graph shows a line for
each measure.
7 Click OK.
Working with Roles 499
Types of Roles
In addition to the standard roles, such as Time, X, or Category, you can add the
following roles by clicking Add Role on the Role Definitions tab. The roles that
are available depend on the type of graph element.
n The Color role specifies a data column that is used to color the data.
The Color role can be any data type. In this example, the Color role is
assigned a Category data type.
Note: When you add the Color role to a graph element in a data-driven
lattice, the Measure data type is not always available. The Measure data type
is not available for a bar chart, a waterfall chart, or a scatter plot.
In some graph elements, such as a bar chart, the Group role also colors the
graph based on the values of the group variable. In those graph elements,
the Color role is used to color the data across a color gradient as shown in
the following example. In this case, the Color role must be a Measure data
type.
In this example, the color gradient indicates the age range of the students.
500 Chapter 52 / Creating and Using Custom Graph Objects
n The Group role specifies a data column that is used to group the data. The
graph elements for each unique group value are automatically distinguished
by different visual attributes, such as color, line style, and so on. The Group
role can be a Category data type or a Datetime data type.
n The Data Label role specifies a data column that is used for data labels.
n The Data Tip role specifies a data column that is used for data tips. The Data
Tip role must be numeric.
n The Target role specifies a data column that is used to generate a targeted
bar chart. A targeted bar chart compares data that is summarized by the
value of a category in reference to target values.
Add an Overlay
In an overlay, one graph element is superimposed on another graph element.
You can add an overlaid graph element to a single-cell graph as well as to a
lattice.
In this example, a step plot is overlaid on a bar chart. The example shows the
graph element with data assigned to it.
To create an overlay:
1 Drag and drop a graph element from the Graph Elements pane onto the
canvas.
Adding a Graph Element to an Existing Graph Object 501
2 Drag and drop a second graph element directly onto the existing graph
element.
If the graph elements are compatible, they are automatically assigned a
shared role. This enables both graph elements to have a common X axis
role. You can unshare the shared role if needed.
Some graph elements, such as the pie chart and the treemap, cannot be
layered in an overlay. A message is displayed when you try to drag and drop
these types of graph elements.
For more information, see the following topics:
n “Incompatible Graph Elements” on page 503
3 (Optional) On the Role Definitions tab, you can change the default role
names to provide more meaningful names.
TIP The graph elements are layered in the order in which they were added to
the canvas. You can change the order by moving a graph element to the front
or the back. For more information, see “Change the Order of Graph Elements
in a Cell” on page 513.
This example shows a user-defined lattice with four cells. One of the cells is
empty. The example shows the graph element with data assigned to it.
1 Drag and drop a graph element from the Graph Elements pane onto the
canvas. The graph element is created in the center of the graph area of the
canvas.
2 Drag and drop another graph element onto the canvas as follows:
n Drag and drop the graph element onto the right or left border of the
existing graph to create a new column. The area becomes shaded to
indicate the location of the new column.
n Drag and drop the graph element onto the top or bottom border of the
existing graph to create a new row.
Incompatible Graph Elements 503
3 To add more cells, continue dragging and dropping graph elements onto the
borders of the existing graph to create new columns or rows. You can drag
and drop a graph element onto the area between two columns to insert a
new column. Or, you can drag and drop a graph element onto the area
between two rows to insert a new row. If the existing graph contains a lattice
with an empty cell, you can drag and drop the graph element into that empty
cell.
You can create up to 10 rows and 10 columns.
4 (Optional) On the Role Definitions tab, you can change the default role
names to provide more meaningful names.
* The waterfall chart requires the X axis to have a shared role to avoid unpredictable results.
In the report, the graph object includes a three-cell lattice of bar charts showing
engine size and miles per gallon for different types of automobiles. The country
of origin is specified as the class variable. As a result, a cell is created for each
country of origin.
506 Chapter 52 / Creating and Using Custom Graph Objects
The following example shows the graph object that was created in the graph
builder. The lattice role was specified for columns.
1 Create the graph object that you want as the basis for your lattice. For more
information, see “Build a Custom Graph Object” on page 497.
2 (Optional) On the Role Definitions tab, you can change the default role
names to provide more meaningful names.
3 Specify the role for a class variable. In the Data-Driven Lattice section of the
Role Definitions tab, click Add Lattice Role.
The Add Role window is displayed.
Save a Custom Graph Object So It Appears in the Designer 507
n a Color role with a Measure data type has been added to the bar chart,
waterfall chart, or scatter plot
In addition, data-driven lattices do not allow graph elements to be overlaid
unless their aggregations are compatible. Graph elements with compatible
aggregations either perform no aggregation at all or they use the same set of
shared Category roles.
4 For the Role Type, select Row or Column to specify the layout for the cells.
6 Select the data type, or classification, for the role. For information about the
data types, see “Working with Data Items in a Report” on page 363.
8 If the Allow multiple data assignments check box is available, then you
can select or clear the check box. When this option is selected, the role can
have more than one measure assigned. For example, in a line chart, if
multiple columns are assigned to the Y axis, then the graph shows a line for
each measure.
9 Click OK.
Repeat the previous steps to specify a second role. For example, if you specified
a role for a multi-row layout, you can specify an additional role for columns.
TIP All of the graph objects in the gallery are available in the designer.
However, by default, not all of these graph objects are displayed on the
designer’s Objects tab. Use the designer’s Show or Hide Objects window to
display any of these graph objects on the designer’s Objects tab.
1 On the Objects tab in the designer, click , and select Show or Hide
Objects. The Show or Hide Objects window is displayed.
b Enter the name of the graph object that you want to find.
c Click Search.
TIP As an alternative, you can search for all graph objects. Specify Graph
template for Type.
4 Click OK.
53
Modifying Custom Graph Objects
Change a Custom Graph That Has Been Saved . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
Select Components and Elements of a Graph Object . . . . . . . . . . . . . . . . . . . . . . 512
Change the Order of Graph Elements in a Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
Remove a Graph Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
Working with User-Defined Lattices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
About User-Defined Lattices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
Move a Graph Element from One Cell to Another Cell . . . . . . . . . . . . . . . . . . . . . . 515
Resize a Row or a Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
Add a Row or a Column to a Lattice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
Remove a Cell or a Graph Element in the Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
Move or Delete a Row or a Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
Working with Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
About Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
About Style Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Create an Overview Axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Change Attribute Rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
Sharing Data Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
About Shared Data Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
Share or Unshare a Data Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
n Select File Open, and then locate and open the file for your graph object.
Note: Any changes that you make to the graph object do not appear in existing
reports that were created from the original graph object. However, new reports
512 Chapter 53 / Modifying Custom Graph Objects
that are created after a modified graph object has been saved reflect the
changes to the graph object.
TIP You can click beside the drop-down list on the Properties tab, and
then select the component that you want to modify.
n To select the entire graph object, click above the graph element or cell area.
n To select a cell in a multi-cell graph object, click the background area just
above the graph element. The cell is highlighted, and a tab appears in the
upper left corner of the cell. From the cell’s tab, you can delete and reorder
graph elements. You can move graph elements to other cells.
Change the Order of Graph Elements in a Cell 513
A1 B1 C1
A2 B2 C2
A3 B3 C3
1 From the drop-down list at the top of the Properties tab, select the cell that
you want to change. Cells are identified by a combination of a letter and a
number, such as A1, B1, A2, and so on. For more information, see “Select
Components and Elements of a Graph Object” on page 512.
In the Graph Elements area on the Properties tab, the graph elements in
the cell are listed in the order in which they were added to the cell.
When you select a cell, a tab appears in the upper left corner of the cell. From
the cell’s tab, you can delete the cell and its contents by clicking . If you click
Working with User-Defined Lattices 515
, the graph elements in the cell are listed. From this list, you can delete and
reorder the graph elements. You can move graph elements to other cells.
For more information about selecting cells and how they are labeled in the
graph, see “Select Components and Elements of a Graph Object” on page 512.
1 Select the cell whose graph element you want to move. For more
information, see “Select Components and Elements of a Graph Object” on
page 512.
2 In the cell’s tab, click to list the graph elements in the cell.
3 Drag and drop a graph element from one cell into the target cell.
You can also drag and drop the graph element so that it creates a new row or
new column. For more information, see “Add a Graph Element to a New Row
or Column” on page 501.
1 Select between the row that you want to change and an adjacent row.
To resize a column:
1 Select between the column that you want to change and an adjacent
column.
You can also right-click the graph element, and select Delete.
2 Position the cursor over a heading. A button and arrows are displayed on the
heading.
The following example shows a column heading that contains a button to
delete the column and arrows to move the column. The button to move the
column to the left is unavailable.
Some arrows might not be available. For example, the leftmost column can
be moved only to the right, as is the case in the previous example. Only is
available for the column.
About Properties
The Properties tab lists the properties for the selected graph component.
Components that have properties include graph elements, cells, axes, legends,
and the entire graph. Properties enable you to control the overall appearance of
your graph, from the graph’s background color to the tick value interval on the
axis. Report designers can override some properties in their report.
To change the properties for a graph object, cell, graph element, legend, or one
or more axes, select the item, and make your changes on the Properties tab.
See Also
“Select Components and Elements of a Graph Object” on page 512
Each color is shown in the list beside its style element. Automatic indicates the
default value for the graph element. Automatic enables the graph element to
cycle through a list of colors provided for group colors and multi-response colors.
518 Chapter 53 / Modifying Custom Graph Objects
1 Drag and drop a graph element from the Graph Elements pane onto the
canvas.
You can drag and drop another graph element to create an overlay. However,
do not create a new cell for this additional graph element. You cannot create
an overview axis when the graph object contains more than one cell.
3 On the Properties tab, select the Show overview axis check box.
The graph object displays the overview axis beneath the existing graph
elements. By default, the existing graph elements are displayed in the
overview axis, as shown in the following example:
b Drag and drop one or more graph elements from the Graph Elements
pane onto the overview axis area of the canvas.
Working with Properties 519
The graph element names that you added are displayed in the Graph
elements section on the Properties tab.
c If you added more than one graph element to the overview axis area, you
can change the order of the graph elements by dragging and dropping a
graph element to a different position.
1 Select the graph object. For more information, see “Select Components and
Elements of a Graph Object” on page 512.
Rotate color only attributes such as marker symbols and line patterns are
until all colors held constant while each color in the list is applied
used exhaustively to the graph element.
Rotate all each attribute rotates through its own list to generate a
attributes unique combination for each group value. Attributes
include colors, marker symbols, line patterns, and so
on.
For example, the following figure shows an example rotation for an age
grouping. The dotted-line pattern is held constant while red, green, and blue
colors are applied to the dotted lines for the consecutive age group values. If
there are more group values, red, green, and blue colors are applied to the solid
lines.
If you change the rotation pattern, and specify Rotate all attributes for the
attribute rotation priority, the contrasting colors and line patterns are rotated at
the same time.
A red dotted-line pattern is applied to the first group crossing. Then, a green
solid-line pattern is applied to the second crossing, a blue dotted-line pattern is
applied to the third crossing, and so on.
520 Chapter 53 / Modifying Custom Graph Objects
When the graph object is used in the designer, the data might be applied as
shown in the following example.
Sharing Data Roles 521
The bar chart shows engine sizes for different regions of the world. (The engine
size has been changed from a Sum to an Average measure.) The scatter plot
shows the miles-per-gallon trend for the different engine sizes.
To unshare a data role, click next to the shared role, and select Unshare.
522 Chapter 53 / Modifying Custom Graph Objects
523
54
Graph Builder Examples
Example: Data-Driven Lattice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
About the Data-Driven Lattice Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
Build the Graph Object for the Data-Driven Lattice Example . . . . . . . . . . . . . . . . 524
Example: User-Defined Lattice (Butterfly Chart) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
About the User-Defined Lattice Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Build the Graph Object for the User-Defined Lattice Example . . . . . . . . . . . . . . . 525
Example: Filled Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
About the Filled Overlay Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
Build the Graph Object for the Filled Overlay Example . . . . . . . . . . . . . . . . . . . . . 529
Example: Vector Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
About the Vector Plot Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Build the Graph Object for the Vector Plot Example . . . . . . . . . . . . . . . . . . . . . . . . 530
2 On the Role Definitions tab, click next to Category, and select Edit
Role. The Edit Role window is displayed.
Click OK.
Specifying Datetime forces the report designer to assign date and time data
to the Category role.
a In the Data-Driven Lattice section on the Role Definitions tab, click Add
Lattice Role. The Add Role window is displayed.
d Select Required. With this option selected, the report designer must
assign data to this role to render the report with data assigned.
e Click OK.
5 Save the graph object. See “Save a Custom Graph Object So It Appears in
the Designer” on page 507.
TIP As a shortcut, you can select a butterfly chart from the graph gallery.
1 In the graph builder, drag and drop a bar chart from the Graph Elements
pane onto the canvas.
526 Chapter 54 / Graph Builder Examples
2 Drag and drop a second bar chart from the Graph Elements pane onto the
left edge of the canvas. This action creates a new column for the second bar
chart.
3 Share the category roles. On the Role Definitions tab, click next to the
Category for either bar chart. Select Create Shared Role With Another
Role and then select the other category role.
The Add Shared Role window is displayed.
Click OK.
c Repeat the previous two steps for the other bar chart.
b On the Properties tab, click next to Y axis range (left axis only), and
select Same within each row.
c On the Properties tab, click next to X axis range, and select Same
for all cells.
The bar charts should resemble the following:
6 Reverse the order of the X (Measure) axis for the left bar chart.
7 Change the color of the right bar chart to distinguish it from the left bar chart.
b On the Properties tab, click next to Fill color, and select Data color
3. The right bar chart changes to a different color. In the default theme,
the color is deep red.
c Repeat the previous two steps for the right bar chart.
9 Save the graph object. See “Save a Custom Graph Object So It Appears in
the Designer” on page 507.
528 Chapter 54 / Graph Builder Examples
The final graph object, complete with the legend, resembles the following:
2 Drag and drop a second time series plot from the Graph Elements pane
onto the first time series plot. This action creates an overlaid plot.
Note: When you overlay the plots, the Time role is automatically shared
between the plots.
a Select the first time series plot. (On the Properties tab, the plot might be
identified as Time Series Plot 1.)
4 Save the graph object. See “Save a Custom Graph Object So It Appears in
the Designer” on page 507.
TIP As a shortcut, you can select a bubble change plot from the graph
gallery.
1 In the graph builder, drag and drop a vector plot from the Graph Elements
pane onto the canvas.
2 Drag and drop a bubble plot from the Graph Elements pane onto the vector
plot.
3 Drag and drop a second bubble plot from the Graph Elements pane onto the
vector plot.
4 On the Role Definitions tab, share the roles. This action joins the vector
origin point to the first bubble, and the vector termination point to the second
bubble.
a Click next to the Bubble Plot 1 X role. Select Create Shared Role
With Another Role Vector Plot 1 X Origin.
In the Add Shared Role window, specify Xstart as the name of the shared
role. Click OK.
b Click next to the Bubble Plot 1 Y role. Select Create Shared Role
With Another Role Vector Plot 1 Y Origin.
In the Add Shared Role window, specify Ystart as the name of the shared
role. Click OK.
c Click next to the Bubble Plot 2 X role. Select Create Shared Role
With Another Role Vector Plot 1 X.
Example: Vector Plot 531
In the Add Shared Role window, specify Xend as the name of the shared
role. Click OK.
d Click next to the Bubble Plot 2 Y role. Select Create Shared Role
With Another Role Vector Plot 1 Y.
In the Add Shared Role window, specify Yend as the name of the shared
role. Click OK.
5 On the Role Definitions tab, add a group role to all three plots.
a In the Bubble Plot 1 section, click Add Role. The Add Role window is
displayed. The Group type is selected by default.
Click OK.
c In the Vector Plot 1 section, click Add Role. The Add Role window is
displayed.
Select Group for the type of role. Click OK.
b In the Vector Plot 1 section, click next to the Group role. Select Use
Shared Role Color.
b Click next to Overlaid plot colors, and select All graphs start with
the same color.
b In the Display in legend box, deselect the Vector Plot 1 and the Bubble
Plot 2 check boxes.
9 Specify the bubble size. This is an optional change made only to improve the
appearance of the bubble sizes with respect to the vector lines.
10 Save the graph object. See “Save a Custom Graph Object So It Appears in
the Designer” on page 507.
532 Chapter 54 / Graph Builder Examples
533
Part 8
Viewing Reports
Chapter 55
Viewing Reports on a Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
Chapter 56
Viewing Reports in Modern SAS Visual Analytics Viewer . . . . . . . . . . . . . 537
Chapter 57
Viewing Reports in Classic SAS Visual Analytics Viewer . . . . . . . . . . . . . 541
534
535
55
Viewing Reports on a Mobile Device
What Are the SAS Visual Analytics Apps? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
Where Can I Find SAS Visual Analytics Apps? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
n Google Play
n Microsoft Store
536 Chapter 55 / Viewing Reports on a Mobile Device
537
56
Viewing Reports in Modern SAS
Visual Analytics Viewer
Overview of Viewing Reports in SAS Visual Analytics Viewer . . . . . . . . . . . . . . 537
Open a Report in the Modern Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
View a Report Object with SAS Graphics Accelerator . . . . . . . . . . . . . . . . . . . . . . 538
What is SAS Graphics Accelerator? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Supported Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Open SAS Graphics Accelerator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
About Guest Access in the Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Note: The layout of some charts is dependent on the size of the display area.
This means that the same treemap might appear slightly different in the viewer
than it does in SAS Visual Analytics Designer (the designer) or in a native
mobile app.
538 Chapter 56 / Viewing Reports in Modern SAS Visual Analytics Viewer
Installation
For information about installing SAS Graphics Accelerator, see http://
support.sas.com/software/products/graphics-accelerator/index.html.
n bubble plot
n line chart
n pie chart
n scatter plot
57
Viewing Reports in Classic SAS
Visual Analytics Viewer
Open a Report in the Classic Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
View Report Object Information in the Classic Viewer . . . . . . . . . . . . . . . . . . . . . . 542
Add Comments to a Report in the Classic Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . 543
Interacting with Reports in the Classic Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Filter, Brush, and Drill in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
View Links in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Subscribe and Unsubscribe to Alerts in the Classic Viewer . . . . . . . . . . . . . . . . 545
Specify Your Preferences for the Classic Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
Note: The layout of some charts is dependent on the size of the display area.
This means that the same treemap might appear slightly different in the viewer
than it does in SAS Visual Analytics Designer (the designer) or in the SAS Visual
Analytics Apps (previously called SAS Mobile BI).
542 Chapter 57 / Viewing Reports in Classic SAS Visual Analytics Viewer
If you have the Create Report capability, then you can select File Edit Report
in the current report. The designer is displayed, and then you can edit the report.
You can e-mail and print reports to share with other users, and export data and
images of report objects. For more information about sending reports to other
users, prerequisites and conditions for printing, and exporting, see Chapter 51,
“Sharing Reports with Other Users,” on page 475.
Note: Info windows are not included in the PDF that is generated when you
print. An info window can be printed separately by clicking Print report to PDF
in the info window.
Icon Description
Icon Description
Click to maximize the report object. This icon is displayed only if there is
more than one report object being displayed.
Click to restore the report object to its original size. This icon is displayed
only if you previously maximized the report object.
Click to display incoming filter information for a report object. This icon is
displayed only if the data for the report object has been filtered as a result of
selecting data in another report object.
Click to display the prompt dialog box for a stored process. This icon is
displayed only for prompted stored processes. You can use the prompt
dialog box to change prompt values for a stored process and to re-execute
the stored process.
Note: Report authors can disable object selection, so you might not be able to
select some report objects.
1 Expand the right pane. Click the Comments tab. (If you are adding a
comment to a report object, then select the report object.)
4 Click Post to add your comment. Your comment is added to the Comments
tab in the right pane.
1 Expand the right pane. Click the Comments tab. Select an existing
comment, and then enter a reply.
3 Click Post. Your reply is added to the Comments tab in the right pane.
Note: To edit another user's comments or to delete comments, you must have
the Comments:Administrator predefined role.
To search for a comment:
1 Expand the right pane. Click the Comments tab. Enter the word or phrase
that you want to search for in the Search within comments field on the
Comments tab.
report object. If there are multiple links or interactions from a report object, then
a list appears that enables you to select a link or interaction. When you are
viewing a link, the following buttons are displayed in the top left corner: .
If a report object that you are linking to shares a data source with the current
report object, then the target report object is filtered based on the data value that
you double-clicked. If you do not want the target report object to be filtered, you
can click , and deselect Apply report link filters. If the data source is not
shared between the two report objects, then no additional filtering takes place in
the target report object.
1 Expand the right pane. Click the Alerts tab. This tab contains a list of all alert
conditions for all report objects within the report.
TIP You can specify a preference for receiving notifications via e-mail or text
message. For more information, see “Specify General Preferences for the
Designer” on page 305.
3 If the SAS High Contrast theme is selected as a global preference, then you
can select the Override report theme when High Contrast Theme is
546 Chapter 57 / Viewing Reports in Classic SAS Visual Analytics Viewer
selected check box to ensure that reports are displayed using the SAS High
Contrast theme. This overrides any theme settings that are made in the
designer.
Part 9
Appendixes
Appendix 1
Keyboard Shortcuts for SAS Visual Analytics . . . . . . . . . . . . . . . . . . . . . . . 549
Appendix 2
Gallery of Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
Appendix 3
Editing a Data Expression in Text Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
Appendix 4
Aggregations for Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
Appendix 5
Operators for Data Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
Appendix 6
Conditions for Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
Appendix 7
Data Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
Appendix 8
Troubleshooting in SAS Visual Analytics Designer . . . . . . . . . . . . . . . . . . 615
Appendix 9
Using URL Parameters to View a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
548
Appendix 10
Schema for Imported Tweets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Appendix 11
About the Classic SAS Visual Analytics Home Page . . . . . . . . . . . . . . . . . 625
549
Appendix 1
Keyboard Shortcuts for SAS Visual
Analytics
The following table contains many of the keyboard shortcuts for SAS Visual
Analytics. In SAS Visual Analytics, some shortcuts are displayed within
parentheses in tooltips and menu item labels. Some are also displayed in the
Keyboard Shortcuts window (press F9 to open that window).
Note: When you use a keyboard shortcut to activate a button, move the focus to
the field or section that the button is associated with before you use the
keyboard shortcut. For example, if a table has an associated Help button, you
must first move the focus to the table before you press Ctrl+?.
Rename the selected tab. Make sure that the focus is on the tab.
Press F2, and specify the new name. To
commit your changes, press Enter. To
cancel your changes, press Esc.
Close the selected tab. Make sure that the focus is on the tab,
and then press Delete.
Note: Some tabs cannot be closed.
Switch in and out of Edit mode for a table To enter Edit mode, select a cell, and
cell. press F2.
To exit Edit mode, press Esc.
Navigate between table headings and For a two-dimensional table, make sure
table content. that the focus is on the table and that you
are not in Edit mode. Press Ctrl+F8 to
switch the focus between column
headings and table cells. Use the arrow
keys to navigate from heading to heading.
For a multidimensional table, make sure
that the focus is on a table cell and that
you are not in Edit mode. Press Ctrl+F8 to
switch the focus between column
headings, row headings, and table cells.
Use the arrow keys to navigate from
heading to heading.
Navigate the content rows of a table. When table cells are in Edit mode:
n Press Tab and Shift+Tab to move from
cell to cell horizontally across columns.
n Press Enter and Shift+Enter to move
from cell to cell vertically across rows.
When table cells are not in Edit mode,
use the arrow keys to move from cell to
cell.
Keyboard Shortcuts for SAS Visual Analytics 551
Change the width of the current column. Navigate to the column heading (press
Ctrl+F8). Then, press Ctrl+left arrow or
Ctrl+right arrow to change the width of the
column.
Automatically re-size the current column Navigate to the column heading (press
to fit its contents. Ctrl+F8). Then, press Enter.
Open a drop-down list or drop-down Make sure that the focus is on the control,
menu. and press Ctrl+down arrow.
Exit a single application in the SAS Visual Tab to the application’s button at the top
Analytics home page. of the browser window, and press Delete.
552 Appendix 1 / Keyboard Shortcuts for SAS Visual Analytics
553
Appendix 2
Gallery of Report Objects
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
List Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
Crosstabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
Graphs, Charts, and Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Bar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Targeted Bar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Waterfall Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Line Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Pie Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
Scatter Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
Time Series Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
Comparative Time Series Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
Series Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
Numeric Series Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
Bubble Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
Bubble Change Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
Treemaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
Dual Axis Bar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
Dual Axis Line Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
Dual Axis Bar-Line Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Dual Axis Time Series Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Band Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
Needle Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
Step Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
Schedule Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Vector Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Dot Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
Butterfly Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
Stock High-Low Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
Stock Volume and Volatility Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
Other Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
Geo Bubble Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
Geo Coordinate Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
Geo Region Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
Gauges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
Word Clouds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
554 Appendix 2 / Gallery of Report Objects
Tables
List Tables
A list table is a two-dimensional representation of data in which the data values
are arranged in unlabeled rows and labeled columns. List tables can use any
data items from a data source. A list table cannot use a hierarchy or a
percentage of subtotals.
You can add sparklines to a column (if the data source contains a date data
item) when aggregated data is displayed in the list table.
Crosstabs
A crosstab (also known as a crosstabulation table) shows an aggregate metric
for the intersections of two or more categories. Crosstabs often have two or
more categories assigned to both the rows and columns, forming a matrix.
Crosstabs can be easier to read than list tables because they often use less
space, and they always collapse repeating values for outer category data items
into one unique value, which is known as grouping. A crosstab can use a
hierarchy.
Graphs, Charts, and Plots 555
Bar Charts
A bar chart consists of vertical or horizontal bars that represent quantitative data.
Use bar charts to compare data that is aggregated by the distinct values of a
category.
You can apply grouping and create data-driven lattices. You can filter or rank
your data based on a specified number of top or bottom values.
Waterfall Charts
A waterfall chart (also known as a progressive bar chart) shows how the initial
value of a measure increases or decreases during a series of operations or
transactions. The first bar begins at the initial value, and each subsequent bar
begins where the previous bar ends. The length and direction of a bar indicate
the magnitude and type (positive or negative, for example) of the operation or
transaction. The resulting chart is a stepped bar showing how incremental
changes lead to the final value of the measure.
Line Charts
A line chart shows the relationship of one or more measures over some interval,
such as time or a series of ranges. You can measure a single measure
(univariate analysis), or you can show the relationships among multiple
Graphs, Charts, and Plots 557
Pie Charts
A pie chart displays a part-to-whole relationship in a circle divided into multiple
slices for each value of a category data item based on a single measure data
item. Each slice represents the relative contribution of each part to the whole. In
a pie chart, the legend is sorted by contribution.
In SAS Visual Analytics Designer (the designer), a pie chart does not show a
slice with a missing or zero response.
Effective pie charts limit the number of slices to 5 or 6. In the designer, you can
use a rank to reduce the number of slices in a pie chart. For more information,
see “Add a New Rank” on page 459.
Note: The Other slice does not display data tip values. In addition, the Other
slice always sums the included values, regardless of the aggregation method
selected for the measure. For example, if the aggregation method selected is
Count, then the Other slice displays the sum of the individual counts.
Scatter Plots
A scatter plot is a two-dimensional plot that shows the relationship of two
measure data items. Each marker (represented by a symbol such as a dot, a
square, or a plus sign) represents an observation. The marker’s position
indicates the value for each observation. Use a scatter plot to examine the
relationship between numeric data items. You can apply grouping by assigning a
category to the Color role.
Scatter plots do not use aggregated data.
datetime, time, or hierarchy data item that is continuous on the X axis. The X
axis is shared across both plots.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Series Plots
A series plot displays a series of line segments that connect observations of
input data. A series plot can use numeric or character data on the X axis.
Note: You must create and save this custom graph object in the SAS Visual
Analytics Graph Builder (the graph builder) before the object is available for use
in reports.
The following example shows MPG averages for different types of vehicles:
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Bubble Plots
A bubble plot is a variation of a scatter plot in which the markers are replaced
with bubbles. A bubble plot displays the relationships among at least three
measures. Two measures are represented by the plot axes, and the third
measure is represented by the size of the bubbles. Each bubble represents an
observation. A bubble plot is useful for data sets with dozens to hundreds of
values. You can add categories to the Grouping and Lattice roles.
Note: A bubble’s size is scaled relative to the minimum and maximum values of
the size variable. The minimum and maximum sizes are illustrated in the plot
legend. The actual value for each bubble is displayed as a data tip. For example,
the legend that is displayed in Figure A2.13 on page 561, the minimum size is
1.3 and the maximum size is 8.3.
Graphs, Charts, and Plots 561
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Treemaps
A treemap displays your data as a set of rectangles (called tiles). Each tile
represents a category node or a hierarchy node. The color of each tile
represents the value of the first measure. The size of each tile represents the
value of the second measure. (There are two data roles for measures in a
treemap—Size and Color.) For example, a sales data treemap might have tile
sizes that represent the number of orders, and it might have tile colors that are
derived from color gradients that represent sales.
562 Appendix 2 / Gallery of Report Objects
The layout of the tiles in the treemap is dependent on the size of the display
area because it uses a space-filling algorithm to lay the tiles down. This means
that the same treemap might appear slightly different in the designer than it does
in the viewer or on a mobile device because the aspect ratio and size available
in those viewers might be different from what the original report designer sees in
the designer.
Note: Treemaps allow only one category data item or hierarchy data item.
Band Plots
A band plot draws a horizontal band with two Y values for each X value. Or, it
draws a vertical band with two X values for each Y value. A band plot is typically
used to show confidence, error, prediction, or control limits. The points on the
upper and lower band boundaries can be joined to create two outlines. The area
between the boundaries is filled.
Here are some key points about band plots:
n You must create and save this custom graph object in the graph builder
before the object is available for use in reports.
n A band plot does not support display rules in the designer.
Needle Plots
A needle plot is a plot in which data points are connected by a vertical line that
connects to a horizontal baseline. The baseline intersects the 0 value or the
minimum value on the vertical axis.
Graphs, Charts, and Plots 565
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
The following example shows profits during a particular time period. The
example specifies an optional baseline value on the Y axis.
Step Plots
A step plot consists of a series of horizontal and vertical line segments (giving
the appearance of steps) that connect observations of input data.
Note: A step plot does not support display rules in the designer.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
566 Appendix 2 / Gallery of Report Objects
The following example shows the price trend during a particular time interval:
Schedule Charts
A schedule chart makes it easy to visualize time lines by representing tasks,
start dates, durations, and end dates in cascading horizontal bar charts.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Vector Plots
A vector plot shows the change in value of a measure using directed line
segments, or vectors, to represent both direction and magnitude at each point.
Graphs, Charts, and Plots 567
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
The following example shows the changes in exam scores for different North
Carolina school systems from 2012 to 2013:
For an example that shows a vector plot enhanced with bubble plots, see
“Example: Vector Plot” on page 529.
Dot Plots
A dot plot compares data that is aggregated by the value of a category.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Butterfly Charts
A butterfly chart compares two measures for a category of values.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Graphs, Charts, and Plots 569
TIP This report object is not displayed in the designer by default. You can
select what you want to display using the designer’s Show or Hide Objects
window.
Controls
A control is a report object that filters or narrows the scope of the data that user
is viewing. A control enables a report designer to select a category that he or
she wants the report viewer to see.
The following controls are available in the designer:
n drop-down lists
n lists
n button bars
n sliders
Gauges
Bullet Gauges
A bullet gauge is a dashboard indicator that compares an actual value to a target
value and compares them in intervals. The actual value of the primary measure
is indicated by an inset horizontal bar.
Note that the scale of a bullet gauge often begins at zero, but it can contain both
positive and negative values if both types of values apply to the primary
measure, such as profit. The inset horizontal bar should always begin at zero so
that comparing multiple bullet graphs is not confusing.
The bullet gauge requires a primary measure and a range display rule, and the
target measure is optional. The default orientation is horizontal with an option to
display the gauge vertically.
Slider Gauges
A slider gauge is a dashboard indicator that compares an actual value to a target
value and compares them in intervals. The actual value of the primary measure
is indicated by a downward-facing arrow. The target value is indicated by a small
upward-facing arrow.
Like a bullet gauge, a slider gauge is oriented horizontally by default, but you
can change the gauge’s orientation to vertical. You should use a slider gauge
when the numeric scale does not start at zero.
The slider gauge supports dates (which are continuous) and numeric categories.
Thermometer Gauges
A thermometer gauge is a dashboard indicator that compares an actual value to
a target value and compares them in intervals. The actual value of the primary
measure is indicated by a vertical bar. The target value is indicated by a small
black line.
574 Appendix 2 / Gallery of Report Objects
Dial Gauges
A dial gauge is an arc-shaped dashboard indicator that compares an actual
value to a target value and compares them in intervals. The actual value of the
primary measure is indicated by an arrow that points outward from the inner
circle. The target value is indicated by an arrow that points inward from the outer
arc. The color of the center circle is the color associated with the primary
measure value’s range interval.
The dial gauge requires a primary measure value and a range-based display
rule. For more information, see “Adding Gauge-Level Display Rules” on page
415.
A target measure value is optional.
Speedometer Gauges
A speedometer gauge is a circular dashboard indicator that compares an actual
value to a target value and compares them in intervals. The actual value of the
primary measure is indicated by the larger pointer. The target value is indicated
by a small triangle along the quantitative scale, either pointing inward or
outward, depending on the KPI skin option for the gauge.
A speedometer gauge requires a primary measure value and a range-based
display rule. A target measure value is optional.
Other Report Objects 575
Word Clouds
A word cloud displays a set of category values as text, grouped in a cloud-like
shape. Depending on the word cloud data roles, the size of the text indicates the
frequency of a category value or the value of a measure that corresponds to a
category value.
Appendix 3
Editing a Data Expression in Text
Mode
Note: If a name contains quotation marks, then you must use the \ character to
escape the quotes.
Note: If a name contains spaces, then you must use the formal format.
Note: If a data item or global parameter has the same name as an operator,
then you must use the formal format. For example, if you have a category
named Year, then enter the name as 'Year'n to avoid conflict with the Year
operator.
Date '23JUN2013'd
'JUN2013'd
'2013'd
'q32013'd
Editing a Data Expression in Text Mode 579
Datetime '23JUN2013_5:23:55’dt
'23JUN2013_5:23'dt
'23JUN2013'dt
Time '_12:23:55't
'_12:23't
aggregates the sum of the measure COST for each BY-group value.
Appendix 4
Aggregations for Measures
The aggregation that is assigned to a measure determines how its values are
summarized in a visualization or report object.
For example, in a bar chart of Sales by Quarter, each bar represents the
aggregated values of the Sales measure for a specific quarter. If the aggregation
for Sales is Sum, then the bars represent the sum (total) of sales for each
quarter. If the aggregation for Sales is Average, then the bars represent the
average sales for each quarter.
Note: Some aggregation types can override the data format that is used to
display values in a visualization or report object. For example, if a measure has
the Currency format with zero decimal places of precision, and you apply the
Variance aggregation, then the values are displayed using the Comma format
with two decimal places of precision instead.
You can specify the following aggregations for your measures:
Sum
calculates the sum (total) of the values of a measure.
Average
calculates the average (mean) value of a measure.
Standard Deviation
calculates the standard deviation of a measure.
Standard Error
calculates the standard error of the mean of a measure.
Variance
calculates the variance of a measure.
Count
calculates the total number of nonmissing values of a measure.
Number Missing
calculates the number of missing values in a measure.
Minimum
calculates the smallest value of a measure.
First Quartile
calculates the first quartile of a measure.
Median
calculates the median value of a measure.
Third Quartile
calculates the third quartile of a measure.
582 Appendix 4 / Aggregations for Measures
Maximum
calculates the largest value of a measure.
Skewness
calculates the skewness of a measure. Skewness indicates the distribution of
values. A positive value indicates that the distribution is heavier for values
greater than the mean. A negative value indicates that the distribution is
heavier for values less than the mean.
Kurtosis
calculates the kurtosis of a measure. The kurtosis value indicates how
peaked the distribution is. A larger value indicates a more sharply peaked
distribution. A smaller value indicates a flatter distribution.
Coefficient of Variation
calculates the coefficient of variation of a measure. The coefficient of
variation is the ratio of the standard deviation to the mean.
Uncorrected Sum of Squares
calculates the uncorrected sum of squares of a measure. The uncorrected
sum of squares is the sum of the squared values.
Corrected Sum of Squares
calculates the corrected sum of squares of a measure. The corrected sum of
squares is the sum of the squared deviations from the mean.
T-statistic (for Average = 0)
calculates the Student’s t statistic for a measure, assuming a mean value of
zero.
P-value (for T-statistic)
calculates the probability of observing the t statistic value or a more extreme
value. A small value indicates that the mean is likely not equal to zero.
583
Appendix 5
Operators for Data Expressions
Overview of Operators for Data Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
Numeric (Simple) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
Comparison Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
Boolean Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
Numeric (Advanced) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
Date and Time Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
Aggregated (Simple) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
Aggregated (Advanced) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
Periodic Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
About Periodic Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
CumulativePeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
ParallelPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
PeriodWithDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
RelativePeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
Text (Simple) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
Text (Advanced) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
Calculating Compound Annual Growth Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
x-y
subtracts the second value from the first value.
For example, 2 – 1 returns 1.
x*y
multiplies the first and second values together.
For example, 2 * 3 returns 6.
x/y
divides the first value by the second value.
For example, 6 / 2 returns 3.
x+y
adds the first and second values together.
For example, 1 + 2 returns 3.
Comparison Operators
BetweenExclusive
returns true if the first value is within the range defined by the second and
third values (excluding the bounding values).
For example, X BetweenExclusive(50, 100) returns true if X is greater
than 50 and less than 100.
BetweenInclusive
returns true if the first value is within the range defined by the second and
third values (including the bounding values).
For example, X BetweenInclusive(50, 100) returns true if X is greater
than or equal to 50 and less than or equal to 100.
In
returns true if the first value is in the list specified by the second parameter.
Select your list by choosing the values from the drop-down list or the selector
window.
For example, X In ('A', 'B', 'C') returns true when the value of X is
either A, B, or C.
Note: This operator cannot be used to compare measures.
Missing
returns true if the value is a missing value.
For example, X Missing returns true if the value of X is missing.
NotBetweenExclusive
returns true if the first value is outside the range defined by the second and
third values (excluding the bounding values).
For example, X NotBetweenExclusive(50, 100) returns true if X is less
than 50 or greater than 100.
NotBetweenInclusive
returns true if the first value is outside the range defined by the second and
third values (including the bounding values).
Boolean Operators 585
Boolean Operators
AND
joins two conditions and returns true if both conditions are true.
For example,
(1 = 1) AND (2 = 2)
returns false.
IF... ELSE
returns different values, depending on whether the condition is true. The first
parameter specifies the condition. The second parameter specifies the value
to return if the condition is true. The third parameter specifies the value to
return if the condition is false.
For example,
if (X > Y) return X else Y
Note: Starting in the 7.1 release, the IF... ELSE operator can also be used in
report filters in the designer.
NOT
returns true if the condition is false.
For example, not (1 = 2) returns true.
OR
joins two conditions and returns true if either condition is true.
For example,
(1 = 1) OR (2 = 2)
returns true.
Root
returns the nth root of the first value, where the second value specifies n (the
base of the root).
For example, 27 Root 3 returns the 3rd (cube) root of 27 (3).
Round
rounds the first value to the number of decimal places that is specified by the
second value. Select the second value from the drop-down list.
For example, 7.354 Round 2 returns 7.35.
Note: If you select 0 decimal places, then the values are rounded to the
nearest integer.
TreatAs
allows a numeric, date, or datetime value to be used as a different data type
within other operators. Select one of the following:
_Date_
allows the value to be used as a date.
_Datetime_
allows the value to be used as a datetime value.
_Number_
allows the value to be used as a number.
_Time_
allows the value to be used as a time value.
The value is treated as a raw value instead of being converted. Date values
are the number of days since 01JAN1960. Datetime values are the number
of seconds since 01JAN1960. Time values are the number of seconds since
midnight.
For example, TreatAs(_Date_, 19600) returns 30AUG2013 as a date
value.
Note: The TreatAs operator is useful for calculating elapsed time between
two datetime values. For example, (TreatAs(_Number_, '23OCT2013'd)
— TreatAs(_Number_, '15JAN2013'd)) calculates the number of days
between 15JAN and 23OCT, which is 281.
Trunc
truncates the input value to an integer.
For example, Trunc(8.9) returns 8 and Trunc(‑8.9) returns -8.
DateFromYQ
creates a date value from separate year and quarter values. The first value
specifies the year as a four-digit number. The second value specifies the
quarter as a number from 1–4.
For example, DateFromYQ(2013, 1) returns 01JAN2013.
Note: The date is generated using the first day of each quarter.
DatePart
converts a datetime value to a date value.
For example, DatePart('15JAN2013_17:15'dt) returns 15JAN2013.
DateTimeFromDateHMS
creates a datetime value from a date value and separate hour, minute, and
second values. The first value specifies the date. The second value specifies
the hour as a number from 0–23. The third value specifies the minute as a
number from 0–59. The fourth value specifies the second as a number from
0–59.
For example, DateTimeFromDateHMS('15JAN2013'd, 17, 15, 23)
returns January 15, 2013 05:15:23 PM
DateTimeFromTimeMDY
creates a datetime value from a time value and separate month, day, and
year values. The first value specifies the time. The second value specifies
the month as a number from 1–12. The third value specifies the day as a
number from 1–31. The fourth value specifies the year as a four-digit
number.
For example, DateTimeFromTimeMDY('_17:15:23'dt, 1, 15, 2013)
returns January 15, 2013 05:15:23 PM.
DayOfMonth
returns the day of the month from a date value as a number from 1–31.
For example, DayOfMonth('15JAN2013'd) returns 15.
DayOfWeek
returns the day of the week from a date value as a number from 1–7 (1 is
Sunday).
For example, DayOfWeek('15JAN2013'd) returns 3 (Tuesday).
DayOfYear
returns the day of the year from a date value as a number from 1–366.
For example, DayOfYear('15FEB2013'd) returns 46.
Hour
returns the hour from a time or datetime value as a number from 0–23.
For example, Hour('17:15:23't) returns 17.
Minute
returns the minute from a time or datetime value as a number from 0–59.
For example, Minute('17:15:23't) returns 15.
Month
returns the month from a date value as a number from 1–12.
For example, Month('15JAN2013'd) returns 1.
Aggregated (Simple) Operators 589
Now
creates a datetime value from the current date and time.
For example, Now() returns the current date and time.
Quarter
returns the quarter from a date value as a number from 1–4.
For example, Quarter('15AUG2013'd) returns 3.
Second
returns the second from a time or datetime value as a number from 0–59.
For example, Second('17:15:23't) returns 23.
TimeFromHMS
creates a time value from separate hour, minute, and second values. The
first value specifies the hour as a number from 0–23. The second value
specifies the minute as a number from 0–59. The third value specifies the
second as a number from 0–59.
For example, TimeFromHMS(17, 15, 23) returns 05:15:23 PM.
TimePart
converts a datetime value to a time value.
For example, TimePart('15JAN2013_17:15:23'dt) returns 05:15:23
PM.
WeekNumber
returns the week of the year as a number from 0–53, where week 1 begins
on the first Sunday of the year. Dates before the first Sunday of the year
return 0.
For example, WeekNumber('04AUG2013'd) returns 31.
Year
returns the year from a date value as a four-digit number.
For example, Year('15JAN2013'd) returns 2013.
NumMiss
calculates the number of missing values in a data item.
Q1
calculates the first quartile of a measure.
Q3
calculates the third quartile of a measure.
StdDev
calculates the standard deviation of a measure.
StdErr
calculates the standard error of the mean of a measure.
Sum
calculates the sum (total) of the values of a measure.
Var
calculates the variance of a measure.
Periodic Operators
n The date data item for the period calculation does not match the date data
item in the visualization or report object. You must use the same date data
item or a duplicate data item that is based on the same data item.
n The interval for the operator is smaller than the interval of the date format in
the visualization or report object (for example, if your interval is by month, but
the date format is Year).
n For operators that use inner and outer intervals, the inner interval is larger
than the outer interval.
n The inferred interval is by week of the year or by an interval smaller than a
day.
n The inferred interval is by day for any operator that has an offset other than
0.
For the explorer, the ParallelPeriod and RelativePeriod operators always
return a missing value when the inferred interval is by day.
The following periodic operators are available:
CumulativePeriod
The CumulativePeriod operator returns aggregated values for a period of time
and all of the previous periods, within a larger period of time (for example, the
year-to-date total of monthly values).
Note: The CumulativePeriod operator resets at the beginning of each calendar
year. You cannot have a CumulativePeriod operator with a date range that
overlaps two calendar years.
Periodic Operators 593
_ByQuarter_
specifies a quarterly interval.
_ByYear_
specifies a yearly interval.
6 The outer interval (larger time period) that provides the context for the
cumulative aggregation. For example, specify _ByMonth_ as the inner
interval and _ByYear_ as the outer interval to aggregate the year-to-date
values for each month.
Select one of the following:
_Inferred_
specifies that the interval is determined automatically from the
visualization or report object that displays the aggregated item.
_ByMonth_
specifies a monthly interval.
_ByQuarter_
specifies a quarterly interval.
_ByYear_
specifies a yearly interval.
7 The number of outer intervals to offset from the current period. 0 specifies
that the period from the current outer interval is used. A negative value
indicates a previous interval.
For example, if your inner interval is by month and your outer interval is by
year, then -1 specifies the year-to-date monthly values for the previous year.
8 The starting point for each new outer period. For example, if your inner
interval is by month and your outer interval is by year, then 3 specifies that
each year begins in the third month.
Note: This parameter is not available in the explorer.
Note: If the outer interval is inferred or by year, then the value must be an
interval between 1 and 12. If the outer interval is by quarter, then the value
must be an interval between 1 and 4.
9 The scope for the period. The scope specifies how much of each period is
aggregated.
Select one of the following:
_Full_
aggregates the values for the entire period.
_ToDate_
aggregates only the values up to a specific day of the outer interval.
_ToToday_
aggregates only the values up to the equivalent of today’s position in the
current interval. For example, if today is the 40th day of the quarter, and
the outer interval is by quarter, then only the values up to the 40th day of
each quarter are used.
The value for today is evaluated dynamically whenever the aggregated
item is viewed in a visualization or report object.
10 If you select _ToDate_ as the scope, then select the date that is used to
subset each period.
Periodic Operators 595
For example, if you select 09NOV2013, and the outer interval is by year, then
only the values up to November 9 of each year are used in the aggregation.
For example,
CumulativePeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, _ByYear_, 0, 1, _Ful
aggregates the sum of year-to-date monthly values for the Expenses measure
using date values from the Date data item.
ParallelPeriod
The ParallelPeriod operator returns aggregated values for a period of time that is
parallel to the current period (for example, the value for the same month of the
previous year).
Specify the following parameters:
4 The date data item for the period calculation. Only data items whose formats
specify year are available.
5 The inner interval (smaller time period) for which the values are aggregated.
For example, specify _ByMonth_ as the inner interval to aggregate the
values for each month.
Select one of the following:
_Inferred_
specifies that the interval is determined automatically from the
visualization or report object that displays the aggregated item.
_ByMonth_
specifies a monthly interval.
_ByQuarter_
specifies a quarterly interval.
_ByYear_
specifies a yearly interval.
6 The outer interval (larger time period) that provides the context for the
parallel period aggregation. For example, specify _ByMonth_ as the inner
interval and _ByYear_ as the outer interval to aggregate the monthly values
for a different year.
Select one of the following:
_Inferred_
specifies that the interval is determined automatically from the
visualization or report object that displays the aggregated item.
_ByMonth_
specifies a monthly interval.
_ByQuarter_
specifies a quarterly interval.
_ByYear_
specifies a yearly interval.
7 The number of outer intervals to offset from the current period. 0 specifies
that the period from the current outer interval is used. A negative value
indicates a previous interval.
For example, if your inner interval is by month and your outer interval is by
year, then -1 specifies the monthly values for the previous year.
8 The scope for the period. The scope specifies how much of each period is
aggregated.
Select one of the following:
_Full_
aggregates the values for the entire period.
_ToDate_
aggregates only the values up to a specific day of the outer interval.
_ToToday_
aggregates only the values up to the equivalent of today’s position in the
current interval. For example, if today is the 40th day of the quarter, and
the outer interval is by quarter, then only the values up to the 40th day of
each quarter are used.
Periodic Operators 597
For example,
ParallelPeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, _ByYear_, -1, _Full_)
aggregates the sum of monthly values for the Expenses measure for the
previous year using date values from the Date data item.
Period
The Period operator returns aggregated values for a period of time (for example,
the value for the current month).
Specify the following parameters:
For example,
Period(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_)
aggregates the sum of monthly values for the Expenses measure using date
values from the Date data item.
PeriodWithDate
The PeriodWithDate operator returns aggregated values for a specific, constant
period of time (for example, the value for the month that includes 15OCT2013).
Specify the following parameters:
For example,
PeriodWithDate(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, '15OCT2013'd)
aggregates the sum of monthly values for the Expenses measure using date
values from the Date data item.
RelativePeriod
The RelativePeriod operator returns aggregated values for a period of time that
is relative to the current period (for example, the previous month of the same
year).
Specify the following parameters:
8 If you select _ToDate_ as the scope, then select the date that is used to
subset each period.
For example, if you select 09NOV2013 and the outer interval is by quarter,
then only the values up to the 40th day of each quarter are used in the
aggregation.
For example,
RelativePeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, -1, _Full_)
aggregates the sum of monthly values for the Expenses measure for the
previous month using date values from the Date data item.
Parse
interprets a numeric or datetime value from the input string. Click the format
field to select the format that is used to interpret the string. The output from
the Parse operator is either a number or a datetime value, depending on the
format that you select.
For example, Parse('15JAN2013', 'DATE9.') returns 15JAN2013 as a
date value.
StartsWith
specifies that a matching value must contain the specified string at the start
of the value.
For example, 'Catcher' StartsWith 'Cat' returns true.
UpCase
changes all of the characters in the text string to uppercase.
For example, UpCase('sas institute') returns SAS INSTITUTE.
_All_
removes all spaces from the string.
_Leading_
removes spaces at the beginning of the string.
_LeadingAndTrailing_
removes spaces at the beginning and end of the string.
_Trailing_
removes spaces at the end of the string.
For example, RemoveBlanks('my test string', '_ALL_') returns
myteststring.
RemoveChars
removes all instances of a set of characters from the input string. The first
parameter specifies the input string. The second parameter specifies the list
of characters to remove.
For example, RemoveChars('my_test_string', '_') returns
myteststring.
RemoveWord
removes a word from an input string where the words are separated by
spaces or special characters. The first parameter specifies the input string.
The second parameter specifies the number of the word to remove where 1
is the first word.
For example, RemoveWord('my test string', 2) returns my string.
Note: In addition to spaces, the following characters are used as delimiters
in the input string: . < ( ) + & ! $ * ; ^ - / , % | ’
Replace
replaces a substring within the input string with a replacement string. The first
parameter specifies the input string. The second parameter specifies the
substring to replace. The third parameter specifies the replacement string.
The fourth parameter specifies which instances of the substring to replace.
Select one of the following:
_ALL_
replaces every instance.
_FIRST_
replaces the first instance only.
_LAST_
replaces the last instance only.
For example, Replace('my test string test', 'test', 'new',
'_ALL_') returns my new string new.
ReplaceWord
replaces a word from an input string where the words are separated by
spaces, periods, or other special characters. The first parameter specifies the
input string. The second parameter specifies the number of the word to
replace where 1 is the first word. The third parameter specifies the
replacement string.
For example, ReplaceWord('my test string', 2, 'new') returns my
new string.
604 Appendix 5 / Operators for Data Expressions
Reverse
reverses the order of the characters in the input string.
For example, Reverse('A B C') returns C B A.
Substring
returns a substring from the input string based on the position of the
characters. The first parameter specifies the input string. The second
parameter specifies the position of the first character to return. The third
parameter specifies the number of characters to return.
For example, Substring('my test string', 4, 3) returns tes.
Update
replaces a substring from the input string based on the position of the
characters. The first parameter specifies the input string. The second
parameter specifies the position of the first character to replace. The third
parameter specifies the number of characters to replace. The fourth
parameter specifies the replacement string.
For example, Update('my test string', 4, 3, 'nex') returns my
next string.
URLDecode
removes URL encoding from the input string. URL encoding replaces some
characters with a % character followed by a two-digit hexadecimal code.
For example, URLDecode('support.sas.com%2Fmy%20string') returns
support.sas.com/my string.
URLEncode
applies URL encoding to the input string. URL encoding replaces some
characters with a % character followed by a two-digit hexadecimal code.
For example, URLEncode('support.sas.com/my string') returns
support.sas.com%2Fmy%20string.
RegionName
This is a string category data item.
TransactionDate
This is a date data item with a format of Month, Day, Year (MMDDYYYY).
The duplicate data item is:
TransactionDateYear
This data item is a duplicate of the TransactionDate data item, but with the
Year format.
The calculated data items are:
BeginningYearNum
This data item should be a numeric type with a Float4.0 format and an
aggregation of Minimum.
BeginningYearNum = Year('31DEC2010'd)
EndingYearNum
This data item should be a numeric type with a Float4.0 format and an
aggregation of Minimum.
EndingYearNum = Year(‘transactionDate’n)
The aggregated measure data items are:
NumYears
This data item has a Float4.0 format.
NumYears = Min [_ByGroup_] ('EndingYearNum'n) ‑ Min
[_ByGroup_] ('BeginningYearNum'n)
BeginningValue
This data item needs to be set to the same currency format as the sales
data item.
BeginningValue = PeriodWithDate(_Sum_, 'sales'n,
'transactionDate'n, _ByYear_, '31DEC2010'd)
EndingValue
This data item needs to be set to the same currency format as the sales
data item.
EndingValue = Period(_Sum_, 'sales'n, 'transactionDate'n,
_ByYear_)
NormalizedRatio
This data item has a Float12.2 format.
NormalizedRatio = 'EndingValue'n / 'BeginningValue'n
CAGR
This data item has a Percent format.
CAGR = ('NormalizedRatio'n Power ( 1 / 'NumYears'n ) ) – 1
To use the CAGR, you should add TransactionDateYear, CAGR, and any
other categories of interest (for example, RegionName, ProductType, and so
on) to a list table, a crosstab, or a graph.
606 Appendix 5 / Operators for Data Expressions
607
Appendix 6
Conditions for Filters
In SAS Visual Analytics, filters are based on expressions that contain operators.
Conditions enable you to easily add the most common operators to your
expression. Depending on the type of data that is used by the filter, you can
select from the following categories of filter conditions:
Contains Specifies that a matching value must contain the filter value.
EndsWith Specifies that a matching value must contain the filter value
at the end of the value.
NotContains Specifies that a matching value must not contain the filter
value.
NotIn Specifies that a matching value is not in the list that you
select. To select your list, choose the values from the drop-
down list.
StartsWith Specifies that a matching value must contain the filter value
at the start of the value.
Table A6.2 Conditions for Numeric Data and Date and Time Data
< Specifies that a matching value must be less than the filter
value.
Between [exclusive] Specifies that a matching value must be greater than the
first filter value and less than the second filter value.
NotBetween Specifies that a matching value must be less than the first
[exclusive] filter value or greater than the second filter value.
NotIn Specifies that a matching value is not in the list that you
select. To select your list, choose the values from the drop-
down list.
Note: This condition is not available for continuous numeric
data.
Appendix 7
Data Limits
Data Limits for SAS Visual Analytics Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
High-Cardinality Thresholds for Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
Behavior when
Limit Is Default Minimum Maximum
Visualization Type Variation Exceeded Threshold Threshold Threshold
Bar Chart Not grouped or The bar chart 3,000 810 3,625
latticed. shows a subset
that contains the
first or last ranked
values.
Behavior when
Limit Is Default Minimum Maximum
Visualization Type Variation Exceeded Threshold Threshold Threshold
Line Chart Single numeric or The line chart 10,000 5,630 11,250
datetime category shows a subset
in the Category that contains the
role. first or last ranked
value.
Single string 4,000 1,380 4,750
category in the
Category role.
Scatter Plot Two measures, The scatter plot is 40,000 9,375 48,750
not grouped. converted to a
heat map.
Sankey Diagram — An error message 3,000 links 500 links 3,625 links
appears.
8,020 rows 1,000 rows 10,000 rows
Data Limits for SAS Visual Analytics Explorer 611
Behavior when
Limit Is Default Minimum Maximum
Visualization Type Variation Exceeded Threshold Threshold Threshold
Box Plot — An error message 2,900 boxes 800 boxes 3,500 boxes
appears.
Behavior when
Limit Is Default Minimum Maximum
Visualization Type Variation Exceeded Threshold Threshold Threshold
In addition to the data thresholds that are set by the Preferences window, there
are server data limits that can be set by the system administrator. For
information about the server data limits, see the topic “Manage High-Cardinality
Data” in the SAS Visual Analytics: Administration Guide.
Bar charts (regular, targeted, dual axis, and dual axis bar-line) 3,000
Treemaps 25,000
High-Cardinality Thresholds for Report Objects 613
Here are some key points about high-cardinality thresholds in report objects:
n In general, requests that exceed a client-side report object threshold cause
an error message to be displayed. An exception is that for detail data, excess
rows are truncated.
n Scatter plots always show detail data. List tables show details if the user
selects the Show detail data check box. Bubble plots show details unless a
category is assigned to the Group role.
n If a data source contains more than a million records, queries are blocked for
data items whose cardinality is greater than 10,000 unique items in any
particular category.
614 Appendix 7 / Data Limits
615
Appendix 8
Troubleshooting in SAS Visual
Analytics Designer
Repairing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Displaying Alert Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Exporting Data from Report Objects to Microsoft Excel 2007 . . . . . . . . . . . . . . . 617
Specifying Colors for Data Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Repairing Reports
Issue: The Repair Report window is displayed.
Resolution:
When you open a report in the designer, you might be prompted to repair the
report. For example, this can happen when one or more columns have been
removed from the data source. You might be prompted to repair the report when
you refresh a report or change a data source. You might be prompted to repair a
report if your system administrator is still deciding which data items should be in
a table.
To repair a report:
1 Decide whether you want to fix individual data items or all of the data items in
the report.
Fixes can be made at the individual data item level. For example, if two data
items are removed from a report, then the Repair Report window displays
separate entries for each data item. The report objects that are impacted by
each data item appear below each of the data items.
616 Appendix 8 / Troubleshooting in SAS Visual Analytics Designer
2 Click Fix or Fix All. For example, if there is a column missing in the data
source and you click Fix, then the missing column is removed from the
report.
Note: If you click Open Report, then all of the data is removed from the
report objects.
A confirmation message is displayed when the report has been fixed.
Resolution:
There are many factors that can affect alert notifications. For example, system
administrators for SAS Visual Analytics can set a property for how frequently the
system checks to see whether the alert condition has been met. And, alert
notifications are not sent if a server is down.
The timing of when alert notifications are sent can vary depending on when the
alert condition is met. For example, suppose that you specify that alert
notifications are sent every five days. The alert condition is met for the first time
at 10:00am on September 2. After that, the system continues to check for the
alert condition based on the hour or minute value that you specified for the
Query the system every field. Because the frequency is set to five days, no
alert notifications will be sent between 10:01am on September 2 and 9:59am on
September 7. This is the case, no matter how many times the alert condition is
met during that timeframe. At 10:00am on September 7, if the alert condition is
met, then another alert notification is sent, and the five-day countdown starts
again. On the other hand, if the alert condition has not been met at 10:00am on
September 7, then no alert notification is sent. However, now that five days have
passed, an alert notification is sent as soon as the alert condition is met again.
Suppose that an alert notification is sent at 2:00pm on September 10. After the
alert notification is sent, the five-day countdown starts again, and the earliest the
next alert notification can be sent is 2:00pm on September 15. If you modify the
notification frequency, then the notification history is reset.
You might not receive an alert notification as soon as the alert condition is met
because of the hour or minute value that is set in the Query the system every
field in the designer. For example, suppose that you set the value in the Query
Specifying Colors for Data Labels 617
the system every field to 1 day. If the alert condition is met one hour after the
system check is done, then it will be another 23 hours before the system checks
for the alert condition again and sends an alert notification.
Contact your system administrator for additional assistance.
Resolutions:
n If an error occurs during exporting, then in the Export or Save As window,
select either the Save as: Tab-Separated Values (*.tsv) or the Save as:
Comma-Separated Values (*.csv) option to create a data file.
n If you see character codes displayed in a file that has been exported to
Excel, then re-open the exported file in Excel, and save it without any
changes. The character codes are removed from the file.
Resolution: If a graph object that you add to a report does not have the desired
attributes, try creating a custom graph object in the SAS Visual Analytics Graph
Builder (the graph builder). For example, suppose the data labels for a dual axis
bar-line graph are not the colors that you want. You can create a dual axis bar-
line graph in the graph builder and specify the font color for the data labels.
618 Appendix 8 / Troubleshooting in SAS Visual Analytics Designer
619
Appendix 9
Using URL Parameters to View a
Report
If guest access is configured for the SAS Visual Analytics Viewer, you can use
this URL: http://host/SASVisualAnalyticsViewer/VisualAnalyticsViewer/guest.jsp.
However, to log on and display a single report using guest access, you can use
a URL such as this one (which has parameters to specify the name and location
of the report): http://host/SASVisualAnalyticsViewer/
VisualAnalyticsViewer_guest.jsp?reportName=My+Report&reportPath=/Shared
+Data/VA+Reports/&appSwitcherDisabled=true. This second URL is useful for
tasks such as using an <iframe> tag to incorporate a single report within another
web application because the SAS Visual Analytics application bar, menu bar,
and toolbar are not included.
The following table lists the parameters that can be included in the second URL:
Parameter Description
reportName Specifies the name of the report that you want to view. This
parameter is required if you are accessing a specific report
through a URL.
reportPath Specifies the path to the report that you want to view. This
parameter is required if you are accessing a specific report
through a URL.
commentsEnabled Enables the Comments tab in the right pane. The default
value is true. If both propertiesEnabled and
commentsEnabled are false, then the right pane is not
added to the viewer.
propertiesEnabled Enables the Properties tab in the right pane. The default
value is true. If both propertiesEnabled and
commentsEnabled are false, then the right pane is not
added to the viewer.
reportViewOnly Hides the SAS Visual Analytics banner, including all of the
menus.
620 Appendix 9 / Using URL Parameters to View a Report
Parameter Description
reportContextBar Enables all of the menu options for the report. The default
value is true. If reportContextBar is false, then it is implied
that both propertiesEnabled and commentsEnabled are
false, and the right pane is not added to the viewer. This
parameter can be used only in the modern viewer.
Note: If reportContextBar is false, you will also hide the
back link, which does not allow section linking or report
linking to work properly.
Parameters are specified in the URL as a sequence of name and value pairs
using query string syntax. The URL specifies your server, an absolute path to
SAS Visual Analytics, and the query string (following the question mark
character). Each parameter name in the query string is separated from the next
value by an equal sign (=). Multiple name and value pairs are separated by
ampersand characters (&). In this example, reportName=My+Report is the
parameter that specifies the name of the report. The second name and value
pair (reportPath=/Shared+Data/VA+Reports/) is the parameter that
specifies the path to that report. The third name and value pair
(appSwitcherDisabled=true) disables the application bar. It must be present
if you are displaying the report in an <iframe> tag.
There are special rules for formatting name and value pairs in a URL. Special
characters (such as most punctuation characters, including spaces) in a value
must be URL-encoded. A space can be encoded as a plus sign (+) or %20.
Other characters are encoded using the %nn convention, where nn is the
hexadecimal representation of the character in the ASCII character set. In the
previous example, the value /Shared+Data/VA+Reports/ actually identifies
the report path /Shared Data/VA Reports/. The spaces in the names are
encoded as plus signs (+).
The reportName and reportPath parameters must be specified in the URL. The
reportName parameter specifies the name of the report that you want to view
(for example, My Report). The reportPath parameter specifies the path to that
report (for example, /Shared Data/VA Reports/).
Note: You can use these parameters with the standard viewer URL that
requires login credentials (http://host/SASVisualAnalyticsViewer/
VisualAnalyticsViewer.jsp). For example, you can use http://host/
SASVisualAnalyticsViewer/VisualAnalyticsViewer.jsp?reportViewOnly=true to
hide the banner.
URL parameters can be used to specify values for report parameters, such as
display rules, filters, ranks, and aggregated measures.
Note: You must know the exact name of the parameter and the valid values for
that parameter if you are going to include the parameter in your URL or change
its values.
621
Appendix 10
Schema for Imported Tweets
The schema for the imported tweets is shown in the following table:
deviceinfo Character 1024 The utility that was used to post the tweet.
It is represented as an HTML-formatted
string.
622 Appendix 10 / Schema for Imported Tweets
The schema for tweets is different from the schema that Twitter uses for tweets,
users, and entities. The following list provides URLs to the information from
Twitter for comparison purposes:
n Tweets: https://dev.twitter.com/overview/api/tweets
n Users: https://dev.twitter.com/overview/api/users
n Entities: https://dev.twitter.com/overview/api/entities
624 Appendix 10 / Schema for Imported Tweets
625
Appendix 11
About the Classic SAS Visual
Analytics Home Page
Your First Look at the Classic SAS Visual Analytics Home Page . . . . . . . . . . . 625
Manage Content on the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Overview of Classic Home Page Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Create a Collection Using the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . 630
Add a Favorites Group to a Collection or to Your Favorites List . . . . . . . . . . . . . 631
Working with the Right Pane on the Classic Home Page . . . . . . . . . . . . . . . . . . . 631
About the Right Pane of the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Hide Content in the Right Pane of the Classic Home Page . . . . . . . . . . . . . . . . . 632
Show Content in the Right Pane of the Classic Home Page . . . . . . . . . . . . . . . . 632
Manage Links in the Right Pane of the Classic Home Page . . . . . . . . . . . . . . . . 633
Discover Details Using the Object Inspector on the Classic Home Page . . . . 633
Add Comments to Objects on the Classic Home Page . . . . . . . . . . . . . . . . . . . . . 635
Specifying Your Preferences for the Classic SAS Visual
Analytics Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Specify Global Preferences Using the Classic Home Page . . . . . . . . . . . . . . . . . 637
Specify the SAS Visual Analytics General Preferences
Using the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
Specify Your Preferences for the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . 638
About Searching from the Classic Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
Refining Your Search Results for the Classic Home Page . . . . . . . . . . . . . . . . . . 641
1 The application bar enables you to return to the classic home page and to
access other parts of SAS Visual Analytics and other SAS applications that
integrate with the classic home page. You can access your recently created
or viewed reports, explorations, stored processes, stored process reports,
data queries, or other objects in your recent history. Buttons are displayed for
each open application.
2 The menu bar enables you to access task options, such as creating reports,
exploring data, managing your environment or favorites, setting your view,
and getting help on using SAS Visual Analytics. You can search all SAS
content from the menu bar, and you can sign out of SAS Visual Analytics.
3 The Create Content area provides icons to let you quickly explore data,
create a new report, or prepare data, depending on your role, the associated
capabilities, and your SAS software licenses. Other installed SAS
applications might add actions to the Create Content area.
4 The My Content area lists any metadata objects that are created by a
supported SAS application. For example, explorations, reports, queries,
tables, stored processes, or stored process reports that you have opened or
created recently are listed. It also lists any content that you have marked as a
favorite or as part of a collection. Click Browse to explore folders to find a
report, exploration, stored process, stored process report, table, or query.
Note: All tables are displayed because the classic home page does not
distinguish between LASR tables and other tables.
Your First Look at the Classic SAS Visual Analytics Home Page 627
5 The Common Actions section provides an alternate way for you to access
features and other installed SAS applications. For more information, see
“Working with the Right Pane on the Classic Home Page” on page 631.
6 The Links section provides links to pages that you have bookmarked. For
more information, see “Working with the Right Pane on the Classic Home
Page” on page 631.
7 The SAS Resources section provides links to the SAS website, the SAS
Visual Analytics User Community, and to social media. For more information,
see “Working with the Right Pane on the Classic Home Page” on page 631.
Note: Guest access does not provide individualized features on the classic
home page, such as history or alerts. By default, a user with guest access has a
Basic role and can access only the classic home page and the viewer. For more
information, see “Guest Access” on page 7.
If you have the Theme Designer for Flex: Administration role in SAS
Management Console, you can access the SAS Theme Designer for Flex from
the More Actions item on the menu bar or in the Common Actions section.
Here is an example of the menu bar with the More Actions item.
Figure A11.2 Classic Home Page Menu Bar with the More Actions Item
Once you start using the classic home page, thumbnails enable you to open
explorations, reports, stored processes, stored process reports, tables, queries,
and folders that you have created or opened. The default view is secure, generic
thumbnails that represent the content. An administrator can set a property that
specifies the use of thumbnails that are shared and unique to each object.
Shared thumbnails are unique for each individual report object, so each report
looks different from other reports, and each exploration looks different from other
explorations.
Generic thumbnails are distinguished by content type only. All reports look the
same, but they appear different from explorations. Here are examples of the
generic thumbnails that you might see on the classic home page:
Figure A11.3 Generic Thumbnails for an Exploration, a Report, and a Stored Process
You can choose to view the content on the classic home page as a list. To
change your view, click on the menu bar, and then select Thumbnail or List.
The default is Thumbnail.
628 Appendix 11 / About the Classic SAS Visual Analytics Home Page
Here is an example of the list view for the classic home page:
For more information about other parts of the SAS Visual Analytics interface,
see the following topics:
n “Your First Look at SAS Visual Data Builder” on page 38
To manage your content, click Manage to the right of the My Content heading.
The Manage My Content window is displayed.
Icon Description
Enables you to create a new favorites group for your reports, explorations,
stored processes, stored process reports, tables, and queries. Folder names
cannot be longer than 60 characters. This icon is available only when
Favorites is selected.
Options Enables you to select either Clear Recent History or Clear Favorites.
Enables you to delete favorite or recent content, one at a time. You can
delete multiple items by pressing the Ctrl key. For a collection, you have a
choice of permanently deleting the collection or simply removing it from
under the My Content heading on the classic home page.
Enables you to move favorite content down in the list to change what is
displayed under the My Content heading on the classic home page.
When you select a report, exploration, stored process, stored process report,
table, or query in the Manage My Content window, the details such as the name
and location of that item are displayed.
630 Appendix 11 / About the Classic SAS Visual Analytics Home Page
TIP Collections that you create using the home page are available in the SAS
Visual Analytics Apps (previously called SAS Mobile BI).
3 Click Browse to select a Location for the collection. The Choose a Location
window is displayed.
Select an existing folder or create a new one. Click OK to return to the
Create a Collection window.
Note: When you create a new collection, you can add items to it from within
the Manage My Content window only if the collection is a root collection in
My Collections.
Working with the Right Pane on the Classic Home Page 631
4 (Optional) If you opened the Create a Collection window from the object
inspector, then you can clear the Add the new collection to My Content
check box. This means that the new collection is not displayed on the classic
home page next to the Favorites link.
5 Click Add. If you are in the Manage My Content window, then the new
collection is displayed on the left.
1 On the classic home page, click Manage to the right of My Content. The
Manage My Content window is displayed.
TIP When you add a favorites group to a collection that is publicly shared,
any favorites groups inside that collection are also publicly shared.
In the Manage My Content window, you can rename or remove a favorites group
by right-clicking it and selecting the applicable option.
in your SAS Visual Analytics session. You can also control the order in which the
items in the sections are displayed.
The following sections can be displayed in the right pane:
Common Actions
Provides an alternate way for you to access features, such as designing
reports, exploring data, managing your environment or content. For example,
you can click Build Custom Graph to access the graph builder. If you have
a Data Building role, then a Prepare Data link is displayed. You might also
see links to other SAS products, such as SAS Theme Designer for Flex,
depending on your role and the SAS licenses that your site has.
Links
Provides links to pages that you have bookmarked. Someone with the Visual
Analytics: Administration role can also provide shared links for all users.
For information about links, see “Manage Links in the Right Pane of the
Classic Home Page” on page 633.
SAS Resources
Provides links to the SAS website, the SAS Visual Analytics User
Community, and to social media.
n Common Actions
n Links
n SAS Resources
n Links
n SAS Resources
If you have an Administration role, then you can click beside on the menu
bar, and select Manage Shared View of Right Pane. The Manage Shared View
of the Right Pane window is displayed. You can use this window to add links to
the right pane that are shared with other users.
information about roles and capabilities, see the SAS Visual Analytics:
Administration Guide.
Here is an example of what you might see in the object inspector for a report
that has been viewed:
You can use the toolbar in the object inspector to do one or more of the following
tasks (which are available depending on your role and capabilities):
n View a report, which opens the report in SAS Visual Analytics Viewer (the
viewer).
n Edit a report, which opens the report in SAS Visual Analytics Designer (the
designer) so that you can edit or change the objects in the report.
n Open an exploration, which displays SAS Visual Analytics Explorer (the
explorer). The Open link is also available for stored processes, stored
process reports, queries, and folders.
n Create Report for a table, which displays the designer.
n Click to set the object as the initial screen when you start SAS Visual
Analytics. When the icon is blue, it indicates that the object is set as your
initial screen. Click to remove this initial screen setting.
2 Click Comments in the lower right corner to expand the object inspector.
636 Appendix 11 / About the Classic SAS Visual Analytics Home Page
4 Click Post to add your comment. The Comments link in the object inspector
updates to show that there is a comment.
2 Click Comments in the lower right corner to expand the object inspector.
5 Click Post to add your comment. The Comments link in the object inspector
updates to show that there is a comment.
Note: To edit another user’s comments or to delete comments, you must belong
to the predefined role Comments:Administrator. This role includes the
capabilities of editing or deleting comments.
To search for a comment:
1 Enter the word or phrase that you want to search for in the search field.
Press Enter.
2 (Optional) To clear your search, click . Then, you can enter another word
or phrase in the search field.
Specifying Your Preferences for the Classic SAS Visual Analytics Home Page 637
Note: If you change the User locale preference, then you must sign out
and sign in to SAS Visual Analytics for the change to take effect.
n Select a Theme to change the color scheme and other visual settings for
all of your SAS web applications.
n Select Invert application colors to invert all of the colors in your SAS
web applications.
n Select Override settings for focus indicator to change the color,
thickness, and opacity of the focus in your SAS web applications.
n Click Reset to show all warning and confirmation messages.
3 Specify a value for Show this number of recent items. There is a minimum
of zero and a maximum of 25. The default setting is 10 items.
Click Clear History to reset your history.
3 Select an option from the Initial screen drop-down list. The available options
depend on your role and capabilities.
TIP If you select A specific object, then you can use the Choose an Item
window to choose one content type (for example, SAS reports (2G), visual
explorations, or a SAS Visual Statistics project) for your initial screen.
(SAS Visual Statistics is licensed separately.) If you select a report in the
Choose an Item window, then you might be able to click beside the OK
button to select either View (Visual Analytics Viewer) or Edit (Visual
Analytics Designer). The available content types and the options for
opening reports depend on the SAS products that your site has licensed
and how they are configured.
n Comment Description
n Created
n Description
n Keywords
n Last Modified
n Title
The search field on the menu bar supports the following types of searches:
n single word
n multiple word
n in-word wildcards
For example, if you specify “A AND B”, then only documents that contain
both A and B are returned.
n plus (+) and minus (-) syntax
The plus (+) sign and minus (-) sign are prefix operators. This means that the
operator precedes the search term that is required or excluded, rather than
following it. For example:
o Specifying 2012 2013 2014 matches documents that contain any of the
three terms.
640 Appendix 11 / About the Classic SAS Visual Analytics Home Page
o Specifying +2012 +2013 +2014 matches only documents that contain all
three terms.
o Specifying 2012 2013 ‑2014 matches documents that contain 2012 or
2013, but only if they do not contain 2014.
Here are some considerations for searching from the classic home page:
n Single- and multiple-word searches that are plain text have a wildcard
appended to them. For example, if you search for the word sample, then it is
converted to sample*. This means that you get different results than if you
entered “sample”, +sample, or *sample*.
n The search is not case sensitive.
Suppose that you search for the word sample. All words that contain sample at
the beginning are displayed in the workspace. (For example, a word that starts
with samples is displayed.) Here is an example of the search results:
The dates are time zone dependent. If your company has offices in multiple
time zones, then the date modified time stamp on the object reflects the time
at which it was saved using the current user’s time zone. For example, if a
report was modified by a user on January 3 at 2:00 a.m. in New York,
another user in California sees that it was modified on January 2 at 11:00
p.m.
At the top of the workspace, you can see the breadcrumbs for the selections that
you have made to refine your search. Breadcrumbs change as you modify the
selections in the Type, Created or Last Modified By, and Date Modified
panes. The breadcrumbs also show any search strings that you entered in the
Search within results field.
Suppose that you search for the word sample. Then, you refine the search
results by selecting Stored process for Type. All stored processes that contain
the word sample are displayed in the workspace. Here is an example of the
refined search results:
Recommended Reading
Here is the recommended reading list for this title:
n SAS Visual Analytics: Administration Guide
n SAS Visual Analytics: Getting Started with Data on Windows
n SAS Technical Paper: One Report, Many Languages: Using SAS Visual
Analytics to Localize Your Reports
n Help and tutorials integrated into SAS Visual Analytics Apps (previously
called SAS Mobile BI)
n An Introduction to SAS Visual Analytics: How to Explore Numbers, Design
Reports, and Gain Insight into Your Data
n Paper SAS4080-2016: Designing SAS ® Visual Analytics Reports: Write
Once, View Anywhere
n Paper SAS6321-2016: If You Build It, Will They Understand? Designing
Reports for the General Public in SAS ® Visual Analytics
n Paper SAS6361-2016: Store Processes and SAS ® Visual Analytics: Giving
Users the Power to Load
n Paper SAS3802-2016: Carry-on Suitcases and Mobile Devices: Using SAS ®
Visual Analytics Designer for Creating Optimally Designed Reports for SAS ®
Mobile BI
n SAS offers instructor-led training and self-paced e-learning courses to help
you get started with SAS Visual Analytics. For more information about the
courses available, see support.sas.com/training.
Glossary
Apache Hadoop (Hadoop)
an open-source framework that enables the distributed processing of large
data sets, across clusters of computers, using a simple programming model.
calculated column
a column that does not exist in any of the tables that are accessed, but which
is created as a result of a column expression.
capability
an application feature that is under role-based management. Typically, a
capability corresponds to a menu item or button. For example, a Report
Creation capability might correspond to a New Report menu item in a
reporting application. Capabilities are assigned to roles.
data item
an item in a data source that is either a logical view of a data field or a
calculation. The author of a report decides which data items to use in a
particular section of a report. There are three types of data items:
hierarchies, categories, and measures.
dependency
a trigger condition that must be met before a job can run in a scheduled flow.
deployed job
a job that has been saved in a deployment directory and can be scheduled.
deployment directory
the location for generated SAS DATA step programs that will be executed by
the batch server as part of a scheduled flow.
file event
a file-related occurrence that is used as a trigger in a scheduled flow. For
example, a file event occurs when a scheduling server determines that a
specified file exists.
646 Glossary
filter
a set of specified criteria that are applied to data in order to identify the
subset of data for a subsequent operation, such as continued processing.
flow
a set of jobs and associated dependencies that is scheduled in the Schedule
Manager plug-in in SAS Management Console.
Hadoop
See Apache Hadoop.
job
a collection of SAS tasks that can create output.
job event
a job-related occurrence that is used as a trigger in a scheduled flow. For
example, a job event occurs when the scheduling server issues a command
to determine whether a job ran successfully.
job flow
a group of jobs and their dependencies, including dependencies on other
jobs, on files, or on specified dates and times. See also job.
join condition
a combination of join keys and a comparison operator.
L10N
See localization.
local data
data that is accessible through the file systems on a computer. This includes
data on hard drives or available through network file systems.
locale
a setting that reflects the language, local conventions, and culture for a
geographic region. Local conventions can include specific formatting rules for
paper sizes, dates, times, and numbers, and a currency symbol for the
country or region. Some examples of locale values are French_Canada,
Portuguese_Brazil, and Chinese_Singapore.
localization (L10N)
the process of adapting software for a particular geocultural region (locale).
Translation of the user interface, system messages, and documentation is a
large part of the localization process.
query
a set of instructions that requests particular information from one or more
data sources.
remote data
data that is not accessible through the file systems available to a computer.
To use remote data, you must direct a SAS server to access the data that is
available through file systems on the remote machine.
Glossary 647
report
output that is generated by running custom SAS code against the data in
your project.
scheduling server
a server that runs deployed jobs in a scheduled flow. The scheduling server
determines whether the schedule criteria and dependencies have been met
before a job is run.
source
See data source.
stored process
See SAS Stored Process.
subquery
a query-expression that is nested as part of another query- expression.
Depending on the clause that contains it, a subquery can return a single
value or multiple values.
time series
an ordered sequence of values of a variable that are observed at equally
spaced time intervals.
Unicode
a 16-bit encoding that is the industry standard for supporting the interchange,
processing, and display of characters and symbols from most of the world's
writing systems.
user role
See role.
visual exploration
a metadata object that contains visualizations and data settings that are
saved from a session of the SAS Visual Analytics explorer.
visualization
an interactive visual representation of data. A visualization can be a table, a
chart, or a geographic map.
649
Index
building custom graphs
A
See custom graphs
bullet gauges 573
accessibility 11 butterfly charts 568
adding button bar control 570
columns in custom graphs 501
columns in the data builder 45, 55
comments in the designer 484
info windows 472 C
plots to a custom graph 500
report sections 472 calculated columns 56
adding a report job 485 calculated data items 125, 364, 380,
advanced report filters 424 583
aggregated measures 126, 363 adding 381
adding 384 compound annual growth rate
distinct count 369 (CAGR) 604
editing 385 deleting 378
percentage of total 369 duplicating 368
aggregation types 581 editing 383
aggregations 57, 117, 376, 581 canvas 303
adding to multiple columns 59 capabilities in SAS Visual Analytics 8
alerts 351, 545 category data items 364
adding 351 distinct counts 369
deleting 353 sort options 378
editing 352 changing data sources 359
preference 305 charts
subscribe 545 bar charts 555
unsubscribe 545 butterfly charts 568
alphanumeric categories 364 dual axis bar charts 562
application themes 9 dual axis bar-line charts 563
authenticated users 7 dual axis line charts 562
automatic charts 157 line charts 556
axes pie charts 557
customizing 153 schedule charts 566
locking 153 targeted bar charts 556
transferring 153 waterfall charts 556
classic home page 625
add comments 635
collections 630
B
content 628
favorites group 631
band plots 564 manage links 633
bar charts 160, 555 object inspector 633
basic report filters 420 preferences 637
binning interval 330 searching 639
box plots 182 classic viewer
brush 544 adding comments 543
bubble change plots 561 alerts 545
bubble plots 167, 560
650 Index
W
V
waterfall charts 556
vector plots 566 wide-screen tablet view 309
vertical containers 336 word clouds 196, 346
properties 337 properties 347
styles 337 styles 347
viewer
See also classic viewer
658 Index