Graph Guide - ComponentSource€¦ · Corda 7 Graph Guide 1-1 Innovative Data Presentation™...

. . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Graph Guide

Version 7.0

Last Updated on September 20, 2006

Corda Technologies, Inc. 350 South 400 West, Suite 100

Lindon, UT 84042

Headquarters: (801) 805-9400

Fax: (801) 805-9405

Sales: (801) 805-9500

Technical Support: (801) 805-9505

Press Contact: (801) 805-9431

Sales Email: [email protected]

Support Email: [email protected]

Corda Server and Corda Builder at run-time use FreeLib.jar. FreeLib.jar contains the run-time library, the source code, and the license information for all classes and methods it contains. Portions of FreeLib.jar contain software Copyright (C) 1998,2000 Steady State Software Ltd. All rights reserved.(http://www.steadystate.com/) Released under the GNU Lesser General Public License. Portions of FreeLib.jar contain software developed by Shazron Abdullah ([email protected]) in Java, original code Copyright (C) 2001 Opaque Industries - http://www.opaque.net/. Released under the GNU Lesser General Public License. Portions of FreeLib.jar contain software Copyright (C) 1999,2000, 2001, 2002 by Bruno Lowagie, Copyright (C) 2000, 2001, 2002 Paulo Soares, and others. All rights reserved. (http://www.lowagie.com/iText/) Released under the GNU Lesser General Public License. This product (FreeLib.jar) includes software developed by the Apache Software Foundation (http://www.apache.org/).

Microsoft, Windows, and PowerPoint are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Screen shots reprinted by permission from Microsoft Corporation. Adobe, Acrobat, Illustrator, and Acrobat Reader are registered trademarks of Adobe Systems Incorporated in the United States and/or other countries. Macromedia, ColdFusion, and Flash are trademarks or registered trademarks of Macromedia, Inc. in the United States and/or other countries. Sun, Java, and JavaScript are trademarks of Sun Microsystems, Inc. in the United States and other countries. Netscape and Netscape Navigator are registered trademark of Netscape Communications Corporation in the U.S. and other countries. SVG is a trademark of the World Wide Web Consortium. UNIX is a trademark registered in the United States and other countries, licensed exclusively through X/Open Company, Ltd. Linux is a registered trademark of Linus Torvalds. All other trademarks are the property of their respective owners.

Copyright © 1996-2006 CORDA Technologies Inc.™ - Corda™ - Corda Builder™ - PopChart™ - OptiMap™ - Highwire™ - All Rights Reserved.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

www.corda.com

. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents

CHAPTER 1 Introduction

Getting Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

CHAPTER 2 Data Organization

Terminology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Standard Data Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Plot Data Class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8Stock Data Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14Box Plot Data Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18Gauge Data Class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22

CHAPTER 3 Area Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

CHAPTER 4 Bar Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

CHAPTER 5 Stacked Bar Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

Corda 7 Graph Guide iiiInteractive Data-Driven Graphics

C O N T E N T SBubble Graphs

iv C

. . .

. .

Corda 7 Graph Guide

CHAPTER 6 Bubble Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Bubble types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

CHAPTER 7 Gauges

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2Gauge Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

CHAPTER 8 Heat Maps


CHAPTER 9 Line Graphs


CHAPTER 10 Line Bar Combo Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4

CHAPTER 11 Pareto Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4

CHAPTER 12 Pie Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3

orda 7 Graph Guidewww.corda.com

. . .

. .C O N T E N T SRadar Graphs

7.0Corda

CHAPTER 13 Radar Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2

CHAPTER 14 Stock Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4

CHAPTER 15 Box Plot Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2

CHAPTER 16 Time Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2Time Graph Subtypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-4Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-7

CHAPTER 17 X-Y Graphs

Conceptual Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2X-Y Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-4Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-7

Corda 7 Graph Guide vInteractive Data-Driven Graphics

C O N T E N T SX-Y Graphs

vi C

. . .

. .

Corda 7 Graph Guide

orda 7 Graph Guidewww.corda.com

. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .INTRODUCTION 1Welcome to the Corda 7 Graph Guide. This guide is for Corda 7 users who want to learn about a specific graph type. For general information about Corda 7, see the Corda 7 Install and Administration guide.

This guide devotes a chapter to each major graph type provided by with Corda 7. For each graph type, it provides a detailed description of the graph, and an explanation of the graph’s subtypes and variations. This information can help you decide which graph types are best suited for a particular data set. This book also contains example data sets that you can send dynamically to your graph with Corda Server.

Note: Most graph types have several subtypes. For example, the Bar graph has Vertical and Horizontal subtypes. These subtypes are discussed together with the main graph type. 3D graphs are considered variations, not subtypes.

Each graph type described in this book has one or more corresponding sample graph in Corda Builder’s Gallery. For more information, see “The Corda 7 Gallery” on page 3-8 of the Corda Builder User Guide.

This introductory chapter includes the following sections:

• Getting Help

• Documentation Conventions

Note: Chapter 2, “Data Organization,” describes how to organize data for the various graph types that Corda 7 supports.

Corda 7 Graph Guide 1-1Innovative Data Presentation™

I N T R O D U C T I O NGetting Help

1-2

1. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G E T T I N G H E L P

You can get help using Corda Builder from the following resources:

• Documentation

• On-Line Resources

• Corda Support

• Corda Support

D O C U M E N T A T I O N

Corda 7 documentation is available in both PDF (which is great for printing) and HTML (which is great for browsing and searching) formats. Access Corda 7 documentation from the Documentation shortcut or by clicking g Help > Documentation in Corda Builder. Documentation files are stored in <product_root>\Resources\docs.

This documentation is updated as performance is enhanced and new features are added. Visit the Corda Technologies Web site (http://www.corda.com) regularly for the latest documentation.

This Guide is just one of several books documenting the features and use of Corda 7. The following documentation is included with Corda 7:

C O R D A I N S T A L L A N D A D M I N I S T R A T I O NThis guide provides an overview of Corda 7, and instructions for installing and configuring Corda 7. It is intended primarily for Corda 7 administrators.

C O R D A 7 D E V E L O P E R R E F E R E N C EThis guide provides developer-level information related to PCScript, ITXML, Corda 7 server commands, and the Corda Embedder. It also provides instructions and samples related to using these programming resources dynamically with Corda Server.

C O R D A 7 H I G H W I R E G U I D EThis guide teaches you how to translate Web pages and other HTML or XHTML documents into PDF documents using Corda Server’s Highwire module.

C O R D A 7 M A P G U I D EThis guide contains a catalog of the various map types available with Corda 7, along with installation instructions and usage information.

Corda 7 Graph Guidewww.corda.com

http://www.corda.com

. . .

. .I N T R O D U C T I O NGetting Help

7.0Corda

C O R D A 7 G R A P H G U I D EThis guide contains instructions on using all of the various graph types available with Corda 7. It also contains example graphs, data, and Image Template files.

C O R D A B U I L D E R U S E R G U I D EThis guide contains detailed instructions for designing graphs or maps with Corda Builder. When you click the Help button in Corda Builder, a context-sensitive version of this guide pops up. It is intended for Corda designers.

O N - L I N E R E S O U R C E S

The Corda Technologies Web site (http://www.corda.com) has a variety of resources to help you use Corda Builder, including the following:

On-line documentation Our most current documentation can always be found on the Web at http://www.corda.com/devzone/docs.

Product Updates You can find patches and updates to Corda Technologies products at http://www.corda.com/download. Please look for updates and patches before contacting Corda technical support.

Corda Builder in Action There are a number of Corda Builder demonstrations running on the Corda Technologies Web site at http://www.corda.com/examples. These demonstrations can help give you an idea of how you can use Corda Builder within the organization.

Code Examples There are many code examples online at http://www.corda.com/devzone/code. These help you perform common tasks like connecting to a database in various Web environments.

Developer Zone The Corda developer zone is a collection of developer resources, including searchable forums, where you can discuss Corda 7 implementation with other developers, and a knowledge base. It is located at http://www.corda.com/devzone.

C O R D A S U P P O R T

If you cannot find what you’re looking for elsewhere, you can contact Corda technical support by email at [email protected] or by phone at (801) 805-9505 (Monday through Friday, 8 a.m.to 5 p.m. Mountain Standard Time). For complete support policies, see http://www.corda.com/support.

Note: Users of evaluation versions of Corda 7 are not entitled to Corda support.


http://www.corda.com/download

http://www.corda.com

http://www.corda.com/devzone/docs

http://www.corda.com/examples

http://www.corda.com/devzone/code

http://www.corda.com/devzone

mailto:[email protected]

http://www.corda.com/support

I N T R O D U C T I O NDocumentation Conventions

1-4

1. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D O C U M E N T A T I O N C O N V E N T I O N S

To improve readability, this guide uses some special conventions when referring to files, URLs, example code or text, and options or buttons in dialogs and menus. For the most part, these should be pretty intuitive, but we mention them here just in case.

D I A L O G / M E N U N A M E S A N D O P T I O N S

Names of menus, dialogs, and options are in green with a slightly larger arial font (e.g. Data Editor).

For brevity, whenever you have to go through multiple layers of menus or dialogs to arrive at the desired menu, dialog, or option, a greater than > sign is used to indicate that the next menu, dialog, or option can be found under the previous.

For example, instead of saying, “Select the Save option from the File pull-down menu,” this documentation says, “Select File > Save.” Similarly, instead of saying, “Change the value of the Port option in Address/Port screen of the Settings section in the Administration Console,” this documentation says, “Change the Settings > Address/Port > Port option in the Administration Console.”

E X A M P L E C O D E

Small segments of code (including HTML and XML) that appear in the body of a normal paragraph are shown in courier font, and are colored light green or yellow (e.g. graph.Transposed(true)).

Medium sized segments of code appear on a single indented line in a courier font, as shown below:

<img src="http://www.yourserver.com:2001/?@_LOG">

Long segments of code look similar, but are on multiple lines and are delimited with a thin horizontal line above and below the code. At the top left corner of the segment, there is an example number for reference. The code segment is also titled. Example 1.1 below demonstrates a longer segment of code.


. . .

. .I N T R O D U C T I O NDocumentation Conventions

7.0Corda

Example 1.1 Example of Long Code Segment

myImage = new CordaEmbedder();myImage.imageTemplate("examples\test.itxml");myImage.pcScript("graph.setCategories(Jan;Feb;Mar;Apr;May;Jun)grap

h.setSeries(Temperature;30;40;50;60;70;80)graph.addPopupText(1,1,Look at the pretty pictures)");

myImage.getEmbeddingHTML();

E X A M P L E T E X T

Any other example text, including text that is typed into a dialog window and values of attributes or variables, appear italicized in a slightly larger arial font (e.g. false in “The default value of graph.Transposed is false”).

F I L E N A M E S A N D T R A D E M A R K E D N A M E S

File names and trademarked names are shown in gray with a slightly larger arial font (e.g. myfile.txt.)

File names described using the <product_root> variable, which varies from system to system. It is the folder into which you installed Corda 7. The default <product_root> is C:\Corda\Tools on Microsoft Windows® systems or /usr/local/Corda/tools on Linux/UNIX® systems.

Additionally, this documentation uses the <document_root> variable to indicate the default path to which Corda 7 saves, or looks for, Corda images and Image Template file. By default, it is the only location from which Corda Server can load files. The default <document_root> is <product_root>\Resources\image_templates.

U R L S

URLs are always shown in either blue or gray with a slightly larger arial font. A blue URL indicates an active, clickable link (e.g. http://www.corda.com.) A gray URL link indicates an inactive, example link (e.g. http://www.yourserver.com.)

If the example URL is in reference to Corda Server, make it a valid URL by replacing www.yourserver.com with the address (and port) of Corda Server. Although this guide does not require any previous knowledge of Corda Server, it is useful to know a little about how graphs and maps can be embedded in Web pages with Corda Server. For more information, see “Corda Server” on page 1-5 of the Corda 7 Install and Administration guide.


I N T R O D U C T I O NDocumentation Conventions

1-6

1. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .DATA ORGANIZATION 2This chapter explains how to organize data for the various PopChart graph types. It provides examples of how to organize data in a standard spreadsheet format (used by data files and databases), as well as in ITXML and PCScript.

Note: For information on how to send data to Corda Server, see Chapter 2, “Connecting to Data Files,” and Chapter 3, “Connecting to Databases,” of the Corda 7 Developer Reference.

The graphs that Corda 7 displays can be divided into six data classes, based on how they expect data to be organized. The data classes, each of which will be discussed in this chapter, are as follows:

S T A N D A R D D A T A C L A S S Area Graphs, Bar Graphs, Line Graphs, Line Bar Combo Graphs, Pareto Graphs, Pie Graphs, Radar Graphs, Stacked Bar Graphs.

P L O T D A T A C L A S S Bubble Graphs, Time Graphs, X-Y Graphs.

S T O C K D A T A C L A S S Stock Graphs (High-Low/Open-Close, Candlestick).

B O X P L O T D A T A C L A S S Box Plot Graphs.

G A U G E D A T A C L A S S Gauges.

This chapter just discusses the data format data for these data classes. The remainder of this guide discusses each of these graph types.


D A T A O R G A N I Z A T I O NTerminology

2-2

2. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . T E R M I N O L O G Y

The building block of every graph in Corda 7 is a data item. Exactly what this data item is depends on the graph. For example, a data item in a bar graph is simply a single data value represented as a bar. A data item in an X-Y Bubble graph, however, consists of three data values—an X-value, a Y-value, and Bubble value. Grouped together, all of the data items in a graph can be referred to as a data set.

Most graphs group data items into series and categories. It is easiest to think of series and categories as corresponding to rows and columns on a spreadsheet, respectively. Most graphs use data in this manner. However, this is not always the case. For example, some graphs may transpose the rows and columns.

All data items in a specific data series are displayed in the same color. In line graphs, they are also connected by a line. Each item in a series of data belongs to a different category. All items in the same category are grouped together in the graph. Example 2.1 illustrates the roles of series and categories of data in creating a graph.

This example illustrates a graph that uses the Standard Data Class. Though different data classes organize their data differently, the concepts of data items, data sets, series, and categories remain the same.

Example 2.1 Series and Categories

9/3/01

9/4/01

9/5/01

Team A 10789 9745 13841

Team B 7861 8916 9612

Team C 11263 6047 12743

Each value on this row is a data item in the Team C series of data. The data items will appear as green bars.

Each value in this column is considered to be a data item in the 9/4/01 category. They are grouped together in the graph.


. . .

. .D A T A O R G A N I Z A T I O NStandard Data Class

7.0Corda

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S T A N D A R D D A T A C L A S S

The Standard data class is the most intuitive data class. Graphs in the Standard data class organize data by series and categories, which correspond to rows and columns, respectively (although you can switch the series and categories by transposing the graph). Each data item consists of only one data value, which indicates the size or height of the data item. Each data item belongs to exactly one category and one series.

Data items are grouped together according to their category. Unless you override a data item’s color, each data item in a series is shown in the same color and symbol. In line graphs, data items in a data series will be connected by a line. There is one legend item for each series.

The Standard data class supports the following graph types:

• Bar Graphs

• Stacked Bar Graphs

• Pie Graphs

• Line Graphs

• Line Bar Combo Graphs

• Area Graphs

• Pie Graphs

• Radar Graphs

• Pareto Graphs

Because these graphs are all in the same data class, a data set that can be used for one of these graph types can be used for any of these graph types.

Note: Pie graphs accept only one category of data, while Pareto graphs accept only one series of data.

Standard data class data can be organized in the following formats:

• Spreadsheet

• ITXML

• PCScript


D A T A O R G A N I Z A T I O NStandard Data Class

2-4

2. .

. . .

Corda 7 Graph Guide

S P R E A D S H E E T

When organizing a Standard data set in a spreadsheet format, first row data are interpreted as category names, and first column data are interpreted as series names. Leave the top left cell of the spreadsheet blank. The remaining data items are treated as individual data items, with each row corresponding to a single series and each column corresponding to a single category. This data format is used with Corda Builder’s Data Editor.

Example 2.2 displays a typical data set for a graph in the Standard data class.

A L T E R N A T I V E D A T A O R G A N I Z A T I O N F O R M A TSome databases or SQL queries may produce data files or result sets in a format somewhat different than this spreadsheet format. One common variation is to have each data item listed as a separate row on the table. In this case, each row contains a category name, series name, and value, with category and series names repeated throughout the table.

Example 2.2 Standard Data Set

Highland M

all

Lakeline Mall

Barton C

reek Square

1999 27,543,000 34,654,000 17,654,000

2000 23,987,000 37,914,000 29,372,000

2001 21,581,000 34,217,000 32,138,000

Each value on this row is a data item in the 2001 series of data. The data items will appear as green bars.

Each value in this column is considered to be a data item in the Lakeline Mall category. They are grouped together in the graph.


. . .


7.0Corda

For example, Table 2.1 organizes provides a data set in the standard spreadsheet format. This same data set can also be be organized as shown in Table 2.2.

Corda Server supports data files and SQL queries in both of these formats. During data import, it automatically detects the format and processes the data set accordingly.

Note that each row from Table 2.2 maps to a single cell in the spreadsheet of Table 2.1. The rows should be in the same order as the cells (left-to-right, top-to-bottom). Also, the first row (the one with the Rownames, Colnames, and Values labels) is optional. Corda 7 will ignore it if it is there, but won’t mind if it is absent.

Note: This format is less succinct than the standard spreadsheet format, since it lists the same category and series names multiple times. If you are concerned about performance or bandwidth, especially for large data sets, you should avoid organizing data in this format.

TABLE 2.1 Standard Spreadsheet Format

Arrivals Departures UnusedOut of

Commission

Atlanta 23 36 11 7

Boston 41 17 25 9

TABLE 2.2 Alternative Data Format

Series Categories Values

Atlanta Arrivals 23

Atlanta Departures 36

Atlanta Unused 11

Atlanta Out of Commission 7

Boston Arrivals 41

Boston Departures 17

Boston Unused 25

Boston Out of Commission 9


D A T A O R G A N I Z A T I O NStandard Data Class

2-6

2. .

. . .

Corda 7 Graph Guide

I T X M L

For the Standard data class, ITXML Data properties require the Value attribute, which specifies the value of the data item.

Example 2.3 illustrates how a data set for a graph in the Standard data class would look in ITXML. this example assumes that the graph is named graph. Note that the data set is the same one used in Example 2.2.

Example 2.3 Standard Data Set in ITXML

<GraphData Name='graph'><Categories>

<Category Name='Highland Mall'/><Category Name='Lakeline Mall'/><Category Name='Barton Creek Square'/>

</Categories><Series Name='1999'>

<Data Value='27,543,000'/><Data Value='34,654,000'/><Data Value='17,654,000'/>

</Series><Series Name='2000'>


</Series><Series Name='2001'>


</Series></GraphData>

For more information about ITXML, see Appendix C, “ITXML,” of the Corda 7 Developer Reference.


. . .


7.0Corda

P C S C R I P T

Sending a standard data set via PCScript involves the following steps:

1 Specify the category names by calling the Graph.SetCategories() method. Separate each category name by a semi-colon.

2 Specify each series to the graph via separate Graph.SetSeries() commands. The first parameter in this command should be the series name, followed by each data item in the series. Separate each series data item with a semi-colon.

Example 2.4 shows PCScript to generate the graph in Example 2.2 (assuming that the graph object is named graph.)

Example 2.4 Standard Data Set in PCScript

graph.SetCategories(Highland Mall; Lakeline Mall; Barton Creek Square)

graph.SetSeries(1999; 27543000; 34654000; 17654000)graph.SetSeries(2000; 23987000; 37914000; 29372000)graph.SetSeries(2001; 21581000; 34217000; 32138000)

Warning: Do not use commas separators in numbers with PCScript, or Corda Server interprets them as multiple data values.

For more information about PCScript, see “PCSCript Reference” on page B-7 of the Corda 7 Developer Reference.


D A T A O R G A N I Z A T I O NPlot Data Class

2-8

2. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P L O T D A T A C L A S S

The Plot data class is used by graphs whose data items are plotted along two axes, like the X-Y graph. Each data item has at least two data values—an x-value and a y-value (for time graphs, these are called the data and value attributes, respectively, but the concept remains the same). These values indicate the position of the data item along the x-axis and y-axis, respectively. Additionally, Plot data items support a bubble value, which is used to determine the radius of bubbles in bubble graphs.

Like graphs in the Standard data class, Plot graphs organize data by series. However, they do not organize data by categories. Unless you override a data item’s color or symbol, each data item in a series is shown in the same color and with the same symbol. If the series is being displayed as a line, data items in that series will be connected by a line. There will be one legend item for each series.

The Plot data class supports the following graph types:

• Bubble Graphs

• Time Graphs

• X-Y Graphs

Important: Unlike graphs in other data sets, graphs in the Plot data set are not interchangeable. In other words, a Time Plot data set cannot be used as an X-Y Plot data set.

Plot data class data can be organized in the following formats:

• Spreadsheet

• ITXML

• PCScript


When organizing a Plot data set in a spreadsheet format, a data series consists of two (three for bubble graphs) columns. For example, the first series consists of the data values in the first and second columns, the second series consists of the data in the third and fourth columns, and so on.

The first row of the spreadsheet is reserved for series names. The name for each series appears in the first column for that series. Leave the rest of the cells in the first row blank. All other rows represent individual data items using the following format:

• First column = X or Date value for the data item

• Second column = Y value for the data item

• (Optional) Third column = Bubble value for the data item


. . .

. .D A T A O R G A N I Z A T I O NPlot Data Class

7.0Corda

Any graph that uses a Plot data set can become a bubble graph by inserting values into a third column for each series (the first series consists of columns one to three, the second series consists of columns four through six, etc.)

Example 2.5 displays a typical Plot data set in a spreadsheet.

Note: For information about how to format dates in Time plot graphs, see “Date Input Format” on page 16-7.

Example 2.6 illustrates a Plot data set with bubble values.

Example 2.5 Plot Data Set (Time)

Name Recognition Considering Buying

6/21/2001 54 7/1/2001 37

8/12/2001 90 12/12/2001 23

10/16/2001 75 9/10/2001 86

The data in the second set of columns is used for the Considering Buying series.

The data in the first two columns is used to form the data points in the Name Recognition series.

The data values in these two cells form a single data item, which is plotted in a green square at 86 on the y-axis, and



2-10

2. .

. . .

Corda 7 Graph Guide

I T X M L

For the Plot data class, ITXML Data properties require either the X and Y attributes (for X-Y graphs) or the Date and Value attributes (for Time graphs).

Example 2.7 illustrates how the X-Y graph data set from Example 2.6 (less the bubble values) looks in ITXML.

Example 2.6 Plot Data Set (X-Y Bubble)

Series 1 Series 2

12 54 5 5 6 4

45 90 10 25 60 6

30 42 3 50 87 8

The data in the second set of columns is used for the Series 2 series.

The data in the first three columns is used to form the data points in the Series 1 series.

The data values in these three cells form a single data item (bubble), which is plotted at 25 on the x-axis, 60 along the y-axis, and has a 6 pixel diameter.


. . .


7.0Corda

Example 2.7 X-Y Plot Data Set in ITXML

<GraphData Name='graph'><Series Name='Series 1'>

<Data X='12' Y='54'/><Data X='45' Y='90'/><Data X='30' Y='42'/>

</Series><Series Name='Series 2'>

<Data X='5' Y='6'/><Data X='25' Y='60'/><Data X='50' Y='87'/>


Example 2.8 illustrates how the Plot data set from Example 2.5 looks in ITXML.

Example 2.8 Time Plot Data Set in ITXML

<GraphData Name='graph2' SortData='Yes'><Series Name='Name Recognition'>

<Data Date='6/21/2001' Value='54'/><Data Date='8/12/2001' Value='90'/><Data Date='10/16/2001' Value='75'/>

</Series><Series Name='Considering Buying'>

<Data Date='7/1/2001' Value='37'/><Data Date='12/12/2001' Value='23'/><Data Date='9/10/2001' Value='86'/>


Note: The SortData attribute specifies that data points are connected in date order (or x value) instead of the order in which they are listed.

Example 2.9 illustrates how the Plot data set from Example 2.6 looks in ITXML.

Note: Any graph using a Plot data set can become a bubble graph by adding the Bubble attribute.



2-12

2. .

. . .

Corda 7 Graph Guide

Example 2.9 Bubble Plot Data Set in ITXML

<GraphData Name='graph'><Series Name='Series 1'>

<Data X='12' Y='54' Bubble='5'/><Data X='45' Y='90' Bubble='10'/><Data X='30' Y='42' Bubble='3'/>

</Series><Series Name='Series 2'>

<Data X='5' Y='6' Bubble='4'/><Data X='25' Y='60' Bubble='6'/><Data X='50' Y='87' Bubble='8'/>



P C S C R I P T

To send a Plot data set via PCScript, send each series to the graph via separate Graph.SetSeries() commands. The first parameter in this command is the series name. Then list each data item in the series, separating data values with a comma and data items with a semi-colon.

Note: The Plot data class does not use the Graph.SetCategories() command.

A Plot data item will consist of two or three data values, each separated by a comma. For X-Y Plot data, these values should be listed in the following order: x-value, y-value, bubble value. For Time Plot data, the order will be: date, value, bubble value. In both cases, the bubble value is optional.

Example 2.5 shows PCScript to generate the graph in Example 2.10 (assuming that the graph object is named timegraph.)

Example 2.10 Time Plot Data Set in PCScript

timegraph.SetSeries(Name Recognition; 6/21/2001,54; 8/12/2001,90; 10/16/2001,75)

timegraph.SetSeries(Considering Buying; 7/1/2001,37; 12/12/2001,23; 9/10/2001,86)


. . .


7.0Corda

Note: PCScript does not support data sorting. You must either pre-sort data values (recommended), or enable data sorting in the Image Template file by opening it in Corda Builder and using Object Properties to enable Plot Settings > Sort.

Example 2.6 shows PCScript to generate the graph in Example 2.11 (assuming a graph object named xygraph.)

Example 2.11 X-Y Bubble Data Set in PCScript

xygraph.SetSeries(Series 1; 12,54,5; 45,90,10; 30,42,3)xygraph.SetSeries(Series 2; 5,6,4; 25,60,6; 50,87,8)



D A T A O R G A N I Z A T I O NStock Data Class

2-14

2. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S T O C K D A T A C L A S S

The Stock data class is used by graphs that analyze a stock’s performance. Stock data items consist of up to four data values. Two are required—High and Low, while Open and Close are optional.

Graphs in the Stock data class organize data items by category. There is only one series of data, and all data items are the same color.

The Stock data class supports the following graph types:

• Stock Graphs

Stock graphs include Candlestick, High-Low, High-Low / Open-Close graphs.

Stock data class data can be organized in the following formats:

• Spreadsheet

• ITXML

• PCScript


When organizing a Stock data set in a spreadsheet format, the cell in second column of the first row of the spreadsheet is the series name. Any other cells in the first row are ignored. All remaining rows are interpreted as categories (not series, as you would expect in other data classes). Since there is only one series of data, each row effectively represents an individual data item.

The columns represent data values for each Stock data item as follows:

• First column = Category name

• Second column = High value

• Third column = Low value

• (Optional) Fourth column = Open value

• (Optional) Fifth column = Close value

The optional columns are ignored for High-Low graphs.


. . .

. .D A T A O R G A N I Z A T I O NStock Data Class

7.0Corda

Example 2.12 displays a typical Stock data set in a spreadsheet.

Example 2.12 Stock Graph

Cool Company Stock

6/1 13 11 12 11.3

6/2 12 8 11.3 11

6/3 13 9 11 11.9

6/4 14 10 11.9 13.2

Stock’s High Price Stock’s

Low Price

The opening price of the stock for the day, indicated by a left tick on the stock

The closing price of the stock for the day, indicated by a right tick on the stock bar.

The name of the stock appears in legend.

The values in this row are used to create the data item in the 6/1 category. The data item translates into the stock bar for 6/1.


D A T A O R G A N I Z A T I O NStock Data Class

2-16

2. .

. . .

Corda 7 Graph Guide

I T X M L

For the Stock data class, ITXML Data properties require the High and Low attributes. They can optionally include Open and Close attributes, which are only used for Candlestick and High-Low/Open-Close graphs.

Example 2.13 illustrates how the Stock data set from Example 2.12 looks in ITXML.

Example 2.13 Stock Data Set in ITXML

<GraphData Name='graph'><Categories>

<Category Name='6/1'/><Category Name='6/2'/><Category Name='6/3'/><Category Name='6/4'/>

</Categories><Series Name='Cool Company Stock'>

<Data High='13' Low='11' Open='12' Close='11.3'/><Data High='12' Low='8' Open='11.3' Close='11'/><Data High='13' Low='9' Open='11' Close='11.9'/><Data High='14' Low='10' Open='11.9' Close='13.2'/>


Note: With stock graphs, you can also set your categories directly in the <Data> tag. To do this, simply use the Name attribute and set it to your category name. This allows you to remove everything in the Categories property.



. . .

. .D A T A O R G A N I Z A T I O NStock Data Class

7.0Corda

P C S C R I P T

Sending a Stock data set via PCScript involves the following steps:


2 Send the data series to the graph with the Graph.SetSeries() command. The first parameter in this command should be the series name, followed by each data item in the series. Separate data values with a comma, and data items with a semi-colon.


Example 2.14 Stock Data Set in PCScript

graph.SetCategories(6/1; 6/2; 6/3; 6/4)graph.SetSeries(Cool Company Stock; 13,11,12,11.3; 12,8,11.3,11;

13,9,11,11.9; 14,10,11.9,13.2)

Note: Stock graphs also support specifying category names directly in the Graph.SetSeries() method. To do this, list the category name as the first value in the data item (e.g. the first data item in Example 2.14 would be 6/1,11,12,11.3). This eliminates the need for a separate Graph.SetCategories().

To change the order of the data values (e.g. open, high, low, close instead of high, low, open, close) use Graph.SetStockHLOCOrder(). Example 2.15 sends the data from Example 2.12 using a modified data value ordering of open, high, close, low.

Example 2.15 Changing Stock Data Value Order in PCScript

graph.SetStockHLOCOrder( 4, 2, 5, 3)graph.SetCategories(6/1; 6/2; 6/3; 6/4)graph.SetSeries(Cool Company Stock; 12,13,11,11.3; 11.3,12,8,11;

11,13,9,11.9; 11.9,14,10,13.2)

Note: When importing data from a table, column 1 is assumed to be the category name.



D A T A O R G A N I Z A T I O NBox Plot Data Class

2-18

2. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B O X P L O T D A T A C L A S S

Box Plot graphs, also referred to as Box and Whisker Plot graphs, are common in statistics and quality measurements.

Graphs in the Box Plot data class organize data items by category. There is only one series of data, and all data items are the same color.

A Box Plot graph data item has five main values: Low, Q1, Median, Q3 and High. These values form a box that around the Median value. It also can have any number of Outlier data values. Outlier values are plotted with symbols that grow as they move further away from the box plot.

The Box Plot data class supports the following graph types:

• Box Plot Graphs

Box Plot data class data can be organized in the following formats:

• Spreadsheet

• ITXML

• PCScript


When organizing a Box Plot data set in spreadsheet format, use a row for each box plot data item. The columns represent data values for each Box Plot data item as follows:

• First column = Low

• Second column = Q1

• Third column = Median

• Fourth column = Q3

• Fifth column = High

This means data values in columns 1-5 are ordered from least to greatest. Any additional columns represent Outlier data values in the data set.


. . .

. .D A T A O R G A N I Z A T I O NBox Plot Data Class

7.0Corda

Example 2.16 displays a typical Box Plot data set in a spreadsheet.

I T X M L

For the Box Plot data class, ITXML Data properties require Low, Q1, Median, Q3, and High attributes. They can optionally include Outlier attributes, which lists the outlier values separated by a semi-colon.

With box plots, set categories directly in the <Data> tag. To do this, set the Name attribute to the category name. This eliminates the need for the Categories property.

Example 2.17 illustrates how the Box plot data set from Example 2.16 looks in ITXML.

Example 2.17 Box Plot Data Set in ITXML

<GraphData Name='boxplot' Method='Replace'><Series Name='BoxPlot'>

<Data Name='Sample 1' Low='42' Q1='48' Median='51' Q3='54' High='60' Outliers='35;75'/>


30

40

50

60

70

80

Sample 1

Box Plot (box whisker) Example

Example 2.16 Box Plot Graph

Low Q1 Median Q3 High Outlier Outlier

Sample1 42 48 51 54 60 35 75

The Box Plot has 5 main data values, which form the box itself. These valeus should be arranged from low to high in your spreadsheet. The box plot can also can take any number outlier data values. Each data value in a column after the fifth column will be considered to be an outlier value. Outliers will be plotted with symbols that change as the outlier moves further away from the box.


D A T A O R G A N I Z A T I O NBox Plot Data Class

2-20

2. .

. . .

Corda 7 Graph Guide

Example 2.18 shows the ITXML for a box plot with three data items:

Example 2.18 3 Box Plots in ITXML

<GraphData Name='boxplot' Method='Replace'><Series Name='BoxPlot'>






P C S C R I P T

Sending a Box Plot data set via PCScript involves the following steps:


2 Send the data series to the graph with the Graph.SetSeries() command. The first parameter in this command should be the series name, followed by each data item in the series. Separate data values with a comma, and data items with a semi-colon.

Note: One Box Plot data item consists of five or more data values, each separated by a comma. List the required values in the following order: Low, Q1, Median, Q3, and High. List any Outlier values after the five required values, separated by a comma.


Example 2.19 Box Plot Data Set in PCScript

graph.setcategories(Sample 1)graph.setseries(BoxPlot;42,48,51,54,60,35,75)

Here is some PCScript that will show three plots in the same graph:


. . .

. .D A T A O R G A N I Z A T I O NBox Plot Data Class

7.0Corda

Example 2.20 3 Box Plots Data Set in PCScript

graph.setcategories(Sample 1; Sample 2; Sample 3)graph.setseries(BoxPlot;42,48,51,54,60,35,75;20,30,40,50,60,15,76;

45,48,50,60,70,19,5)graph.SetSeries(CompanyStock; 13,11,12,11.3; 12,8,11.3,11;

13,9,11,11.9; 14,10,11.9,13.2)

Note: When importing data from a table, column 1 is assumed to be the category name.

For more information about PCScript, see Appendix B, “PCScript,” of the Corda 7 Developer Reference.


D A T A O R G A N I Z A T I O NGauge Data Class

2-22

2. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G A U G E D A T A C L A S S

Gauges bear little resemblance to other graph types. They "graph" only one data value, which determines the color of the gauge.

Besides the value of a gauge, you can also specify a label for the gauge, and color ranges. Color ranges, which consists of a range name (e.g. Critical), a color value (e.g. #FF0000), and a maximum and minimum value, are used to determine the color of the gauge. If the data value falls between the maximum and minimum value of a range, the gauge will appear in that range’s color. On some gauges you can also set a minimum and maximum value for the gauge itself.

The Gauge data class supports the following graph types:

• Gauges

Gauge data class data can be organized in the following formats:

• Spreadsheet

• ITXML

• PCScript


You cannot import data to a gauge in spreadsheet format, but you can set gauge data in Corda Builder’s Object Properties (See the gauge-scale and color-ranges property groups.)

Important: Because you cannot import data to a gauge in spreadsheet form, do not use the loadData() or setData() Corda Embedder methods or the graph.LoadFile(data/020115.csv)() PCScript method with gauges. Rather, use ITXML or the SetGaugeRange() and SetGaugeValue() PCScript methods.

For more information on Object Properties, see “Object Properties” on page 2-10 of the Corda Builder User Guide.


. . .

. .D A T A O R G A N I Z A T I O NGauge Data Class

7.0Corda

I T X M L

Example 2.21 illustrates what gauge ITXML might look like.

More information on these properties is available in the Corda 7 Object Reference.

Example 2.21 Setting Gauge Values and Ranges in ITXML

<Graph Name='graph' Type='Gauge' SubType='Filled Bar'><Values Text='Server Load' Value='79.0'/><ColorRange NoColorRanged='True' /><ColorRange Name='Normal' Color='#00b200'

Minimum='0.0' Maximum='50.0' /><ColorRange Name='Warning' Color='#b2b200'

Minimum='50.0' Maximum='75.0' /><ColorRange Name='Critical' Color='#b20000'

Minimum='75.0' Maximum='100.0' /><Scale Minimum='0' Maximum='100' /></Graph>

The yellow color range is between 50 and 75.

The green color range is between 0 and 50.

The red color range is between 75 and 100. The data value, 79, is in this range, so the range is "filled" until 79, and empty afterwords.

Sets the maximum and minimum of the scale.

This line resets the color ranges.


D A T A O R G A N I Z A T I O NGauge Data Class

2-24

2. .

. . .

Corda 7 Graph Guide

P C S C R I P T

Set a gauge’s value and ranges via the Graph.SetGaugeValue() and Graph.SetGaugeRange() PCScript methods.

The Graph.SetGaugeValue() method accepts multiple sets of one to four parameters in the following order: gauge value, gauge label, gauge minimum value, and gauge maximum value.

To set a gauge’s color ranges, use the Graph.SetGaugeRange() method, which accepts multiple sets of four parameters: range name, six-digit hexadecimal color code, minimum range value, and maximum range value. Do not precede the color code with a pound # sign, and separate each parameter with a semi-colon.

Example 2.22 shows PCScript to generate the graph in Example 2.21 (assuming that the gauge object is named gauge):

Example 2.22 Setting Gauge Values and Ranges in PCScript

Gauge.SetGaugeValue(79,Server Load,0,100)Gauge.SetGaugeRange(Normal,00b200,0,50; Warning,b2b200,50,75;

Critical,b20000,75,100)


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .AREA GRAPHS 3This chapter contains information about area graphs, and consists of the following sections:

• Conceptual Overview


A R E A G R A P H SConceptual Overview

3-2

3. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C O N C E P T U A L O V E R V I E W

Area Graphs combine the features of Line graphs (see Chapter 9, “Line Graphs.”) and Stacked Bar graphs (see Chapter 5, “Stacked Bar Graphs.”) by coloring the areas underneath each line. These area segments are stacked on top of each other, as in a Stacked Bar graph, so that the total size of the area at each category reflects the cumulative value of all data items in that category.

Each data series in the graph corresponds to a colored segment of the total area. The first series is always the top area segment.

Example 3.1 below shows how Area graphs work.

Area graphs are in the Standard Data Class (see Chapter 2 for details).

Example 3.1 Area Graph

1999

2000

2001

Brand A 10 20 40

Brand B 15 10 14

Brand C 30 17 16

Each value on this row is a data item in the Brand C series of data. The data items are represented by the blue area on the graph.

Each value in this column is considered to be a data item in the 1999 category. They are summed together to compute the size of the area at that


. . .

. .A R E A G R A P H SConceptual Overview

7.0Corda

P O S S I B L E U S E S

Area Graphs are useful for showing group trends and comparing trends between individual data series. For example, Example 3.1 shows year-by-year trends in overall market penetration for a certain product type. It also breaks down market penetration by brand, with each area segment revealing year-by-year market penetration trends for a different brand.

Area Graphs can be used to:

• Displaying changes in cumulative value or percentage over time

• Comparing groups on outcome measurements

• Display group trends

C R E A T I N G A N A R E A G R A P H

To create an Area graph with ITXML, create a Graph property and set its Type attribute to Area. For example:

<Graph Name='graph' Type='Area'>


A R E A G R A P H SConceptual Overview

3-4

3. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .BAR GRAPHS 4This chapter contains information about bar graphs.

This chapter consists of the following sections:


• Subtypes

• Formatting Options

Sample Bar graphs are available in the Corda 7 Gallery. For more information, see “The Corda 7 Gallery” on page 3-8 of the Corda Builder User Guide.


B A R G R A P H SConceptual Overview

4-2

4. .

. . .

Corda 7 Graph Guide


Bar graphs are the most common graph type, and are useful for a wide variety of data. Bar graphs group data together according to categories, displaying one bar for each data item in that category. Each bar is color-coded according to the data series that it represents. Example 4.1 shows how a Bar graph works.

Bar graphs are in the Standard Data Class (see Chapter 2 for details).


Bar graphs can be used for:

• Comparing independent data sets

• Money distribution by time

• Production against time

Example 4.1 Vertical Bar Graph

9/3/01

9/4/01

9/5/01

Team A 10789 9745 13841

Team B 7861 8916 9612

Team C 11263 6047 12743

Each value on this row is a data item in the Team C series of data. The data items will appear as green bars.

Each value in this column is considered to be a data item in the 9/4/01 category. They are grouped together in the graph.


. . .

. .B A R G R A P H SConceptual Overview

7.0Corda

C R E A T I N G A B A R G R A P H

To create a Bar graph with ITXML, create a Graph property and set its Type attribute to Bar, as shown in the example below.

<Graph Name='graph' Type='Bar'>


B A R G R A P H SSubtypes

4-4

4. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S U B T Y P E S

Listed below are the Bar graph subtypes.

V E R T I C A L B A R

This is the default Bar graph subtype. To specify the Vertical subtype explicitly in ITXML, set the SubType attribute of the Graph property to Vertical. For example:

<Graph Name='graph' Type='Bar' SubType='Vertical'>

The graph depicted in Example 4.1 is a Vertical bar graph (i.e. the bars are vertical).

H O R I Z O N T A L B A R

Horizontal Bar graphs are identical to Vertical Bar graphs, except that they are rotated 90 degrees. Horizontal bar graphs are useful if you have long category or data labels that you don’t want to rotate.

Example 4.2 gives an example of a Horizontal Bar graph.

Example 4.2 Standard Data Set

Highland M

all

Lakeline Mall

Barton C

reek Square

1999 27,543,000 34,654,000 17,654,000

2000 23,987,000 37,914,000 29,372,000

2001 21,581,000 34,217,000 32,138,000

Each value on this row is a data item in the 2001 series of data. The data items will appear as green bars.

Each value in this column is considered to be a data item in the Lakeline Mall category. They are grouped together in the graph.


. . .

. .B A R G R A P H SSubtypes

7.0Corda

To specify the Horizontal Bar graph subtype in ITXML, set the SubType attribute of the Graph property to Horizontal. For example:

<Graph Name='graph' Type='Bar' SubType='Horizontal'>

V E R T I C A L S T A C K E D B A R

The Vertical Stacked bar subtype is discussed in Chapter 5, “Stacked Bar Graphs.”

H O R I Z O N T A L S T A C K E D B A R

The Horizontal Stacked bar subtype is discussed in Chapter 5, “Stacked Bar Graphs.”


B A R G R A P H SFormatting Options

4-6

4. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F O R M A T T I N G O P T I O N S

The following are ways to customize Bar graphs:

S I N G L E S E R I E S M U L T I C O L O R M O D E

If a bar graph only has one data series, you can represent each category in that series with a different color. To do this, enable Single Series Multicolor Mode in Object Properties. For more information, see “Multicolor Mode” on page 4-15 in the Corda Builder User Guide.


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .STACKED BAR GRAPHS 5This chapter contains information about stacked bar graphs.



• Subtypes


ST A C K E D B A R G R A P H SConceptual Overview

5-2

5. .

. . .

Corda 7 Graph Guide


Technically, the Stacked Bar graph is a graph subtype, not a separate type of graph. But since it is a subtype for several types of graphs, it is more convenient to discuss the concept of a Stacked Bar graph separately.

Stacked bar graphs work well when for showing the cumulative effect of a category of data. In a Stacked Bar graph, all of the bars in a category are stacked on top of each other. The resulting stacked bar represents the sum of all of the data items in the respective category. Each data item is represented as a segment in the stacked bar.

The graph also gives you an idea of how data from a particular series contributes to the category sum. Each segment of the bar is color-coded according to the series of data that the segment represents.

Vertical Bar Graph Stacked Vertical Bar Graph


. . .

. .ST A C K E D B A R G R A P H SConceptual Overview

7.0Corda

Stacked Bar graphs use the Standard Data Class (see Chapter 2 for details). Example 5.1 shows how data forms a Stacked Bar graph.


Stacked bar graphs can be used for:

• Comparing independent data sets

• Money distribution by time

• Production against time

Example 5.1 Stacked Bar Graph

1999-2000

2000-2001

Stockton 12.1 11.5

Malone 25.5 23.2

Russell 14.1 12.0

Each value on this row is a data item in the Russell series of data. The data items will appear as purple segments.

Each value in this column is considered to be a data item in the 2000-2001 category. They are summed together to create a stacked bar for that category.


ST A C K E D B A R G R A P H SSubtypes

5-4

5. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S U B T Y P E S

Stacked Bar graph subtypes include the following:

V E R T I C A L S T A C K E D B A R

The graph depicted in Example 5.1 is a Vertical bar graph (i.e. the bars are vertical).

To create a Vertical Stacked bar graph in ITXML, set the Type attribute of Graph to Bar, and the SubType attribute to Vertical Stacked. For example:

<Graph Name='graph' Type='Bar' SubType='Vertical Stacked'>

H O R I Z O N T A L S T A C K E D B A R

Horizontal Stacked Bar graphs are identical to Vertical Stacked Bar graphs, except that they are rotated 90 degrees. Horizontal Stacked Bar graphs are useful if you have long category or data labels that you don’t want to rotate.

To create a Horizontal Stacked bar graph in ITXML, set the Type attribute of Graph to Bar, and the SubType attribute to Horizontal Stacked. For example:

<Graph Name='graph' Type='Bar' SubType='Horizontal Stacked'>


. . .

. .ST A C K E D B A R G R A P H SSubtypes

7.0Corda

F L O A T I N G S T A C K E D B A R

Both Vertical and Horizontal Stacked Bar support the Floating Stacked Bar option. In a Floating Stacked Bar graph, the bottom segment (last data item) in each stacked bar is invisible. This has the effect of making the bar seem to float above the graph baseline, as shown in Example 5.2.

To create a Floating Stacked Bar graph in ITXML, add a Properties property to the Graph property (if it does not already exist). In the Properties property, add a FloatingBars attribute and set its value to Yes. Example 5.3 shows ITXML for a Floating Horizontal Stacked Bar graph.

Example 5.3 Floating Stacked Bar in ITXML

<Graph Name='graph' Type='Bar' SubType='Horizontal Stacked'><Properties FloatingBars='Yes'/>

</Graph>

Example 5.2 Floating Stacked Bar Graph

Grade

A 11

B 20

C 14

F 45

For the most part, the FloatingStacked Bar graph works just like a Stacked Bar graph.

What makes the Floating Stacked Bar graph "float" is that the bottom data item in each category is invisible. For example, in this graph the F series does not appear as a segment in the bar, nor does it appear as a legend entry.


ST A C K E D B A R G R A P H SSubtypes

5-6

5. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .BUBBLE GRAPHS 6This chapter contains information about Bubble graphs, and consists of the following sections:


• Bubble types


B U B B L E G R A P H SConceptual Overview

6-2

6. .

. . .

Corda 7 Graph Guide


Bubble graphs are not actually a separate graph type, but a subtype of all Plot graphs. In Bubble graphs, a third data value, called the bubble data value, is added to each data item. The bubble value is used to determine the size of a bubble that appears at the data item’s plot point.

A bubble graph can be used for three-dimensional data—that is, x-y or time data items that have a quantitative property to them. Example 6.1 below shows an X-Y bubble graph.

Bubble graphs are in the Plot Data Class (see Chapter 2 for details).

Example 6.1 Plot Data Set (X-Y Bubble)

Series 1 Series 2

12 54 5 5 6 4

45 90 10 25 60 6

30 42 3 50 87 8

The data in the second set of columns is used for the Series 2 series.

The data in the first three columns is used to form the data points in the Series 1 series.

The data values in these three cells form a single data item (bubble), which is plotted at 25 on the x-axis, 60 along the y-axis, and has a 6 pixel diameter.


. . .

. .B U B B L E G R A P H SConceptual Overview

7.0Corda


Bubble graphs can be used for:

• Display data with three variables

• Display financial data


B U B B L E G R A P H SBubble types

6-4

6. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B U B B L E T Y P E S

The following graph types support a Bubble subtype:

X - Y B U B B L E

The graph in Example 6.1 is an X-Y Bubble graph. To create an X-Y Bubble graph in ITXML, set the Type attribute of Graph to X-Y, and the SubType attribute to Bubble. For example:

<Graph Name='graph' Type='XY' SubType='Bubble'>

Be sure that each data item includes a bubble value, as described in “Plot Data Class” on page 2-8.

T I M E P L O T

A Time Plot Bubble graph uses Time Plot points instead of X-Y points. To create a Time Plot Bubble graph in ITXML, set the Type attribute of Graph to Time, and the SubType attribute to Bubble. For example:

<Graph Name='graph' Type='Time' SubType='Bubble'>

Be sure that each data item includes a bubble value, as described in “Plot Data Class” on page 2-8.


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .GAUGES 7This chapter contains information about gauges, which consists of the following sections:


• Gauge Types


G A U G E SConceptual Overview

7-2

7. .

. . .

Corda 7 Graph Guide


Gauges depict a single data value. It’s purpose is to classify that value as belonging to a predetermined range.

Consider a typical grading scale. Many teachers assign grades based on numbers. However, the final grade is then classified as being A, B, C, D, or F, depending on the range into which the grade falls. For example, a grade of 85 falls into the B range, which comprises of all grades between 80 and 89, inclusive.

Gauges work in a similar fashion. First, define ranges for a gauge. Second, for each range, define a scope (the minimum and maximum value for data items in the range), a name, and a color.

Finally, assign a data value to the gauge. The gauge determines to which range the value belongs, and uses the characteristics of that range to depict the data value.

In addition to depicting the range to which a data value belongs, most gauges also offer some indication as to the scope of the other defined ranges. For example, a grading scale gauge doesn’t only show that a data value is a B, it also offers some indication as to how close the value came to being classifed as a C or an A.

Because gauges only represent a single data item, they are very different from other graphs (in fact, most people would say that they aren’t graphs). You cannot, for example, import gauge data from a spreadsheet, and the concepts of series and categories are also irrelevant.

ITXML and PCScript have special functions for setting gauge values and ranges (see “Gauge Data Class” on page 2-22). Set these values in Corda Builder’s Object Properties. Example 7.1 shows how the different gauge properties are used to form a gauge.


. . .

. .G A U G E SConceptual Overview

7.0Corda

Example 7.1 Gauge Configuration

The red color range is between 80 and 100.

.

The yellow color range is between 50 and 75.

The value of the Gauge is 70.

The green color range is0 and 50.

The gauge value is 70so the linear gauge is filled to this level.


G A U G E SConceptual Overview

7-4

7. .

. . .

Corda 7 Graph Guide

C R E A T I N G A G A U G E

Gauges are effectively one or more shape objects grouped together in such a way to create the desired gauge effect. For information about creating gauges, see “Gauges” on page 4-25 of the Corda Builder User Guide.


. . .

. .G A U G E SGauge Types

7.0Corda

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G A U G E T Y P E S

The following Gauge types are available:

B A S I C

Basic gauges let you create gauges out of groups of one or more shapes. Basic gauges can be just about anything you want. Use combinations of shapes, and apply Ranges to those shapes in any way you want to achieve the desired gauge effect.

The ITXML for creating a basic gauge looks something like the following:

<cit:gauge name="LED Basic" value="75.0" cversion="0" common="top:10;left:10;width:325;height:94;keep-proportions:false">

L I N E A R

Linear gauges are single-shape gauges that “fill up” to indicate the current gauge value. Common filled gauges include bar gauges and thermometers.


G A U G E SGauge Types

7-6

7. .

. . .

Corda 7 Graph Guide

The ITXML for creating a linear gauge looks something like the following:

<cit:linear-gauge name="gauge" label="Label " cversion="0" common="top:30;left:89;width:209;height:68;keep-proportions:false">

R E P E A T I N G

Repeating gauges are two-shape gauges. One shape is the gauge frame and the other is the repeating shape used to indicate the current gauge value. The most common repeating gauge is an LED.

The ITXML for creating a repeating gauge looks something like the following:

<cit:repeating-gauge name="Repeating Bulbs" value="90.0" cversion="0" common="top:10;left:10;width:361;height:31;keep-proportions:false">


. . .

. .G A U G E SGauge Types

7.0Corda

R A D I A L

Radial gauges let you create dial gauges with pointers that indicate the current gauge value. Common repeating gauges include dials and speedometers.

The ITXML for creating a radial gauge looks something like the following:

<cit:radial-gauge name="Basic Blackface" cversion="0" common="top:10;left:10;width:203;height:203">


G A U G E SGauge Types

7-8

7. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .HEAT MAPS 8This chapter contains information about heat maps, and consists of the following sections:



H E A T M A P SConceptual Overview

8-2

8. .

. . .

Corda 7 Graph Guide


Heat Maps are a special case of graph in which both the X and Y axes contain category data. No series data is represented. Heat Maps allow you to visualize realtionships between data categories and draw attention to “hot” spots of activity and trends.

Heat maps are in the Standard Data Class (see Chapter 2 for details).


Heat maps can be applied to most any type of categorical data. For example:

• Stock price changes by business sector

• Business risk by sector and country

• Genetic marker distribution by race

C R E A T I N G A H E A T M A P

To create a Heat map with ITXML, create a Graph property and set its Type attribute to Heat. For example:

<Graph Name='graph' Type='Heat'>


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .LINE GRAPHS 9This chapter contains information about line graphs, and consists of the following sections:



L I N E G R A P H SConceptual Overview

9-2

9. .

. . .

Corda 7 Graph Guide


Line graphs are useful when you want to show data trends. In a Line graph, data items are represented by points or symbols. Data items in the same series are connected to each other by a line to better display the trend in data over a number of data categories. Data categories become the scale indexes along the x-axis, and each line represents a data series.

Note: The X-Y Line subtype of the X-Y Plot graph type looks very similar to a Line graph. However, it uses data differently. If your data is in X-Y pair data points you will want to use X-Y Line subtype of the X-Y Plot graph. Otherwise, you will probably want to use the standard Line graph described here.

Example 9.1 illustrates the use a Line graph.

Line graphs are in the Standard Data Class (see Chapter 2 for details).

Example 9.1 Line Graph

Sept 2000

Oct 2000

Nov 2000

Gold 466.47 470.92 463.12

Platinum 455.00 430.23 411.12

Palladium 440.19 445.00 450.68

The values on this row are data items in the Palladium series of data. Each value represents the value of the Palladium (green) line for the category named at the bottom of its column.

The values in this column are data items in the Nov 2000 category of data. They will be plotted along the same vertical gridline in the graph.


. . .

. .L I N E G R A P H SConceptual Overview

7.0Corda


Line graphs can be used for:

• Determining trends or cyclical variations

• Money distribution over time

• Production over time

• Price variation over time

• Environmental changes over time

• Material characteristics by temperature

• Clinical response by concentration

C R E A T I N G A L I N E G R A P H

To create a Line graph with ITXML, create a Graph property and set its Type attribute to Line. For example:

<Graph Name='graph' Type='Line'>


L I N E G R A P H SConceptual Overview

9-4

9. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .LINE BAR COMBO GRAPHS 10This chapter contains information about line bar combo graphs, and consists of the following sections:


• Subtypes



L I N E B A R C O M B O G R A P H SConceptual Overview

10-2

1 0. .

. . .

Corda 7 Graph Guide


Line Bar Combo graphs provide both bars and lines in the same graph, similar to a combination of Bar Graphs and Line Graphs.

A Line Bar Combo graph represents data according to the number of data series in it. By default, those data series that constitute the first half of the total number of series are represented as lines. The remaining data series are represented as bars. An odd number of data series results in one more bar data series than line data series.

Example 10.1 shows how Line Bar Combo graphs work.

Line Bar Combo graphs are in the Standard Data Class (see Chapter 2 for details).

C R E A T I N G A L I N E B A R C O M B O G R A P H

To create a Line Bar Combo graph with ITXML, create a Graph property and set its Type attribute to Line Bar. For example:

<Graph Name='graph' Type='Line Bar'>

Example 10.1 Line Bar Combo Graph

June

July

August

Batting Average .285 .290 .273

Home Runs 35 40 28

The value scale on the left of the graph is for all the data series in the graph that are displayed as line. In this case, that means just the Batting Average series.

Because the Batting Average series is in the first half of all the series (rows) of data in the graph, it is represented as a line.

Because the Home Run series is in the last half of all the series (rows) of data in the graph, it is represented with bars.

All data values in this column are placed/plotted in the June category.


. . .

. .L I N E B A R C O M B O G R A P H SSubtypes

7.0Corda

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S U B T Y P E S

Listed below are the Line Bar Combo graph subtypes.

Note: Line Bar Combo graphs only support Vertical Bars.

B A S I C

This is the default Line Bar Combo graph type (as shown in Example 10.1.) To specify the Basic subtype explicitly, set the SubType attribute of your Graph property to Basic. For example:

<Graph Name='graph' Type='Line Bar' SubType='Basic'>

L I N E - S T A C K E D B A R C O M B O

The Line-Stacked Bar Combo subtype for Line Bar Combo graphs is similar to a standard Line Bar Combo graph, except it uses stacked bars instead of regular bars.

By default, a Line-Stacked Bar Combo displays only the first data series as a line. It displays any other data series as segments in the stacked bars. To create a Line-Stacked Bar Combo graph in ITXML, set the SubType attribute of the Graph property to Stacked. For example:

<Graph Name='graph' Type='Line Bar' SubType='Stacked'>

For more information about stacked bars, see Chapter 5, “Stacked Bar Graphs.”

Line Bar Combo Line-Stacked Bar Combo


L I N E B A R C O M B O G R A P H SFormatting Options

10-4

1 0. .

. . .

Corda 7 Graph Guide


Line Bar Combo graphs support the following formatting options:

D U A L Y S C A L E S

One benefit of Line Bar Combo graphs is that bars and lines can have different value scales—one on the right side of the graph and one on the left. This is especially useful when you want to compare two data sets with different ranges. The category labels along the bottom of the graph are the same for both the lines and the bars.

N U M B E R O F L I N E S / B A R S

You can manually set the number of series used for lines or bars by specifying the number of data series to display as lines. The rest are automatically displayed as bars.


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .PARETO GRAPHS 11This chapter contains information about Pareto graphs.





P A R E T O G R A P H SConceptual Overview

11-2

11. .

. . .

Corda 7 Graph Guide


Pareto graphs (pronounced pa-ray-toe) are single-series bar graphs, with categories ordered according to the size of their data item (largest to smallest). A line above the bars shows the cumulative value of all of the data items to that point. A pareto graphs has two scales—one on the left that shows the actual data values, and one on the right that measures percentages of the total value of the data series.

Pareto graphs are useful for discerning the impact of certain categories of data on a data series, and allow you to see those categories that most (or least) contributed to the entire series.

Example 11.1 below shows how a Pareto graph works.

Pareto graphs are in the Standard Data Class (see Chapter 2 for details), but they only graph one data series.

Example 11.1 Pareto Graph

Electronics Clothing Commodities Services Political

Ad Revenue 34,000 30,000 43,000 10,976 5,923

This line graphs the cumulative value of all the data items so far.

The value in this column is a data item in the Commodities

The bars are sorted according to the largest data value.


. . .

. .P A R E T O G R A P H SConceptual Overview

7.0Corda


Pareto graphs can be used for:

• Prioritizing significant items among a large amount of data

• Determine production failure causes

• Determine best or worst performance

• Identify most of least important cost properties

C R E A T I N G A P A R E T O G R A P H

To create a Pareto graph with ITXML, create a Graph property and set its Type attribute to Pareto. For example:

<Graph Name='graph' Type='Pareto'>


P A R E T O G R A P H SFormatting Options

11-4

11. .

. . .

Corda 7 Graph Guide


Pareto graphs support the following formatting options:

D A T A L A B E L S

Pareto graph data labels are similar to data labels for other graphs. However, since the bars typically indicate a different type of value (e.g. dollars) than the line (percentage), you need to “trick” the Image Template file into displaying a different symbol for the data labels along the line.

For example, with a data label format of $%_VALUE, a data label along the bar displays properly (e.g. $43,000). However, a data label along the line also include the dollar sign, when it should be displayed as a percentage (e.g. 43%).

To solve this discrepancy, set the global data label string to the desired format for the line data labels (e.g. %_VALUE%). Then use the series data label override to change the data label format of the bars (e.g. $%_VALUE). This provides the correct data label formatting for the Pareto graph line and bars.


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .PIE GRAPHS 12This chapter contains information about Pie graphs.

This chapter contains the following sections:




P I E G R A P H SConceptual Overview

12-2

1 2. .

. . .

Corda 7 Graph Guide


The Pie graph is a commonly used graph type. Pie graphs are most often used to show data as a percentage of the whole. Pie graphs represent an entire data category as a pie (all other data is thrown out.) Each data item in that category is shown as a pie wedge. The wedge size is proportional to that data item’s percentage of the sum of all data items in the category. Example 12.1 shows exactly how they work.

Pie graphs are in the Standard Data Class (see Chapter 2 for details).


Pie graphs can be used for:

• Comparing data properties against the sum of the properties

• Budgets

• Money distribution

C R E A T I N G A P I E G R A P H

To create a Pie graph with ITXML, create a Graph property and set its Type attribute to Pie. For example:

<Graph Name='graph' Type='Pie'>

Example 12.1 Pie Graph

Prop. 22

For 4,158,823

Against 2,617,004The most obvious way of looking at this graph is that the number of For votes was 61% of the total votes, so its wedge is 61% of the pie.

In technical terms, the Against data item was 39% of the sum of all data items in the category, so its wedge is 39% of the graph.

The category label becomes the graph label.

Each pie graph has exactly one category.


. . .

. .P I E G R A P H SFormatting Options

7.0Corda


The following formatting options are available for Pie graphs:

D A T A L A B E L S

Pie graphs do not have scales, ticks, or gridlines, but Pie graphs have several options for displaying data labels that are not available for other graph types. For example, in addition to displaying data label as either the actual value or as a percentage of the pie, Pie graphs can display a data label that consists of both the series label (For or Against in Example 12.1) and the regular data label. Pie graphs also support data label callouts outside of the pie using a Leader.

More information on data label properties is available in the Corda 7 Object Reference.

G A P S

Pie graphs support wedge gaps that put space between each wedge.

Show Series Text as "Name and Value" Position as "Out W/ Leader"

Pie With GapsRegular Pie


P I E G R A P H SFormatting Options

12-4

1 2. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .RADAR GRAPHS 13This chapter contains information about radar graphs, and consists of the following sections:



R A D A R G R A P H SConceptual Overview

13-2

1 3. .

. . .

Corda 7 Graph Guide


Radar graphs are similar to line graphs, except that they use a radial grid to display data items. A radial grid displays scale value grid lines circling around a central point, which represents zero. Higher data values are farther from the center point. The Radar graph type gets its name because it resembles a radar screen.

The radial grid is not circular, but an equilateral polygon, with each category plotted at a vertex of the polygon. Thus, three categories create a triangular grid; eight categories create an octagonal grid. There must be at least three categories to populate a Radar graph.

The area inside of the polygon for each series is colored translucently. This makes it easier to see the total "size" of a data series, while still being able to see the other data series in the graph.

Example 13.1 below shows a Radar graph works.

Radar graphs are in the Standard Data Class (see Chapter 2 for details).

Example 13.1 Radar Graph

Math

Science

English

Reading

Student A 30 29 23 20

Student B 25 23 32 34

The values on this row are data items in the Student B series of data. Each value represents the radius of the Student B (red) area for its particular category.

The values in this column are data items in the Science category of data. They will be plotted along the same compass point in the radar graph.


. . .

. .R A D A R G R A P H SConceptual Overview

7.0Corda


Radar graphs can be used for mathematical and statistical applications.

C R E A T I N G A R A D A R G R A P H

To create a Radar graph with ITXML, create a Graph property and set its Type attribute to Radar. For example:

<Graph Name='graph' Type='Radar'>


R A D A R G R A P H SConceptual Overview

13-4

1 3. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .STOCK GRAPHS 14This chapter contains information about stock graphs, and consists of the following sections:


• Subtypes


ST O C K G R A P H SConceptual Overview

14-2

1 4. .

. . .

Corda 7 Graph Guide


Stock graphs are useful for displaying information about stocks. Each data item is displayed as a stock bar, which can represent the following information: daily high price, daily low price, opening price, and closing price. The specific look of the stock bar depends on which Stock graph subtype you are using.

While there can be an infinite number of categories (usually dates) in a Stock graph, there is only one data series (usually representing a single stock), meaning that there is only one data item (stock bar) per category. However, a Stock graph could different categories to represent the prices for a separate stock, allowing you to compare prices for separate stocks on a single day.

Data items in stock bars must have at least two values: a high value and a low value. Opening and Closing values might be optional, depending on the specific subtype.

Example 14.1 below shows how a typical Stock graph works.

Stock graphs are in the Stock Data Class (see Chapter 2 for details).

Example 14.1 Stock Graph

Cool Company Stock

6/1 13 11 12 11.3

6/2 12 8 11.3 11

6/3 13 9 11 11.9

6/4 14 10 11.9 13.2

Stock’s High Price Stock’s

Low Price

The opening price of the stock for the day, indicated by a left tick on the stock

The closing price of the stock for the day, indicated by a right tick on the stock bar.

The name of the stock appears in legend.

The values in this row are used to create the data item in the 6/1 category. The data item translates into the stock bar for 6/1.


. . .

. .ST O C K G R A P H SConceptual Overview

7.0Corda


Stock graphs can be used for:

• Show daily stock prices over time

• Show statistical data with a confidence range over time

C R E A T I N G A S T O C K G R A P H

To create a Stock graph with ITXML, create a Graph property and set its Type attribute to Stock. For example:

<Graph Name='graph' Type='Stock'>


ST O C K G R A P H SSubtypes

14-4

1 4. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . S U B T Y P E S

Stock graphs support the following formatting options:

H I G H - L O W / O P E N - C L O S E

The graph depicted in Example 14.1 is a High-Low/Open-Close graph. The bottom of the stock bars in a High-Low/Open-Close graph indicates the stock’s low value. The top of the stock bar indicates the stock’s high value. The tick on the left side of the bar indicates the stock’s open value, and the tick on the right side of the bar indicates the stock’s close value.

To create a High-Low/Open-Close graph in ITXML, set the SubType attribute of Graph to HighLowOpenClose. For example:

<Graph Name='graph' Type='Stock' SubType='HighLowOpenClose'>

H I G H - L O W

The High-Low Stock graph is essentially a High-Low/Open-Close graph that ignores open and close values. The stock bar does not have any ticks for open and close values.

To create a High-Low/Open-Close graph in ITXML, set the SubType attribute of Graph to HighLow. For example:

<Graph Name='graph' Type='Stock' SubType='HighLow'>

H I G H - L O W / C L O S E

The High-Low/Close graph is essentially a High-Low/Open-Close graph that ignores the open value. The stock bar only shows a close tick on the right.

To create a High-Low/Open-Close graph in ITXML, set the SubType attribute of Graph to HighLowClose. For example:

<Graph Name='graph' Type='Stock' SubType='HighLowOpenClose'>

Then, only send three data values for each data item. The third data value is considered the close value (instead of the open value, as it would normally be). For example, in the following PCScript, all of the third data values are close data values.

graph.SetSeries(My Stock; 12,23,17; 20,25,21)


. . .

. .ST O C K G R A P H SSubtypes

7.0Corda

C A N D L E S T I C K

The Candle Stick subtype of the Stock graph works like a regular Stock graph, but the data is displayed differently. Candlesticks use a wide bar, instead of tick marks, to show the difference between the opening and closing price. If the closing price is higher than the opening price (meaning the stock gained for the day), the bar is not filled. If the closing price is lower than the opening price (meaning the stock lost for the day), the bar is filled.

The image below illustrates how a Candle Stick graph works.

To create a Candle Stick graph in ITXML, set the SubType attribute of Graph to CandleStick. For example:

<Graph Name='graph' Type='Stock' SubType='CandleStick'>

Opening Price

Closing Price

Low Price

High Price

Closing Price

Opening Price

Low Price

High Price

This stock’s price closed lower than it opened. You can tell because it’s candlestick is colored.

This stock’s price closed higher than it opened. You can tell because it’s candlestick is transparent.


ST O C K G R A P H SSubtypes

14-6

1 4. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .BOX PLOT GRAPHS 15This chapter contains an overview of the Box Plot graph type. It includes the following sections:



B O X P L O T G R A P H SConceptual Overview

15-2

1 5. .

. . .

Corda 7 Graph Guide


Box Plot graphs, also referred to as Box and Whisker Plot graphs, are quite common in statistics and quality measurements. Graphs in the Box Plot data class organize data items by category. There is only one series of data, and all data items are the same color.

A Box Plot graph data item has five main values: Low, Q1, Median, Q3 and High. These numbers are determined from the data set you are trying to create the Box Plot to represent. It also can have any number of Outlier data values.

Let's look at an example with a small set of data (we will use this sample data set to compute the values that we need to assign to our box plot):

35, 42, 48, 50, 51, 53, 54, 60, 75

Important: These are not the numbers we would send to the graph. These are the number we would use to compute values we should send to the graph. The graph itself will not compute these figures for us.

In this case the Median is 51. If we divide the data into two halves (including the median in both because there is an odd number) we have 35, 42, 48, 50, 51 and 51, 53, 54, 60, 75. Now we find the median of each of these two halves to find the first quartile, Q1, and the third quartile, Q3. These numbers are 48 and 54 respectively.

The difference between Q3 and Q1, 54-48, is 6. This is called the inter quartile range or IQR. The Low and High values are based on the IQR. The Low value, or lower whisker, is a maximum of 1.5 times the IQR below Q1. The IQR in this case is 6 and 1.5 times the IQR would be 9. So the minimum the Low value for our example could be is 39. However the Low value is the smallest value that is equal to or greater than the minimum low value. In this case that is 42.

The High value, or upper whisker, is determined similarly by finding the max High, 54 + 9 = 63, and then finding the value which is the same or just less than that value. In our sample that is 60.

So for this example the Low=42, Q1=48, Median=51, Q3=54, and High=60.

So what do we do with the 35 and 75? These are called outliers, because they are more than 1.5 * IQR away from Q1 and Q3. They can be represented in the Box Plot also. If the outliers are more than 3 * IQR then they are classified as extreme outliers and are indicated differently in the graph. We indicate normal outliers using a small circle and extreme outliers as a plus sign. In our example the threshold for the lower extreme outliers is Q1(48) - (3 * 6) = 30. Since 35 is larger than this threshold it is a normal outlier. The upper threshold for extreme outliers is Q3(54) + (3 * 6) = 72. Since 75 is larger than this value it is an extreme outlier.


. . .

. .B O X P L O T G R A P H SConceptual Overview

7.0Corda

The spreadsheet in Example 15.1 displays a typical data set for a graph that uses the Box plot data class.

Box Plot graphs are in the Box Plot Data Class (see Chapter 2 for details).


Box Plot graphs can be used for:

• Statistical analysis

• Emphasize outlying data

C R E A T I N G A B O X P L O T G R A P H

To create a Box Plot graph with PCXML, create a Graph element and set its Type attribute to BoxPlot, as shown in the example below.

<Graph Name='graph' Type='BoxPlot'>

30

40

50

60

70

80

Sample 1

Box Plot (box whisker) Example

Example 15.1 Box Plot Graph

Low Q1 Median Q3 High Outlier Outlier

Sample1 42 48 51 54 60 35 75

The Box Plot has 5 main data values, which form the box itself. These values should be arranged from low to high in your spreadsheet. The box plot can also can take any number outlier data values. Each data value in a column after the fifth column will be considered to be an outlier value. Outliers will be plotted with symbols that change as the outlier moves further away from the box.


B O X P L O T G R A P H SConceptual Overview

15-4

1 5. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .TIME GRAPHS 16This chapter contains information about time graphs, and consists of the following sections:


• Time Graph Subtypes



T I M E G R A P H SConceptual Overview

16-2

1 6. .

. . .

Corda 7 Graph Guide

www.corda.com


Time Plot graphs are similar to X-Y graphs, and are used to display Time-value data pairs. Time Plot data items consist of two data values: the time and the value, which translate into x and y coordinate, respectively. The data item is displayed as a symbol, but you can add a lines, bubbles, or fill areas to better delineate the data. Because of the nature of the coordinate system, Time Plot graphs do not have categories.

Time graphs are good for graphing the value of something at indiscrete intervals, such as sampling data at random times.

Example 16.1 below shows how a Time Plot graph works.

Time Plot graphs are in the Plot Data Class (see Chapter 2 for details). By default, the time data value should be provided in the following format: %m/%d/%Y, where %m represents the month number, %d represents the day number, and %Y represents the four-digit year. However, you can change the date input format as needed. For instance, Example 16.1 uses a %H:%M format (meaning hour:minute, with all times occuring on the same day). See “Date Input Format” on page 16-7 for information about changing this format.

Example 16.1 Time Plot Graph

Main St.

Center St.

9:00 54 8:25 73

11:05 34 10:15 48

12:30 55 12:00 51

The data items in these columns are considered to be in the Center St. series. They will appear as purple triangles and will be connected by a purple line.

Two data values are used for each data item: time (plotted along the x-axis) and value (plotted along the y-axis).

The data item indicated by the green dot that this bottom line points to was resolved similarly. The data point plotted was (10:15, 48).

This top line shows how the data item indicated by the upper left purple triangle was resolved. The first value was used as the time coordinate. The second was used as the value coordinate.

*The date input format for this graph was %H:%M (e.g. 8:00).

Corda 7 Graph Guide

. . .

. .T I M E G R A P H SConceptual Overview

7.0Corda


Time Plot graphs can be used for:

• Determining trends or cyclical variations

• Money distribution over time

• Production over time

• Price variation over time

• Environmental changes over time

C R E A T I N G A T I M E G R A P H

To create a Time Plot graph with ITXML, create a Graph property and set its Type attribute to Time. For example:

<Graph Name='graph' Type='Time'>


T I M E G R A P H STime Graph Subtypes

16-4

1 6. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . T I M E G R A P H S U B T Y P E S

The following Time graph subtypes are available:

T I M E L I N E

The graph in Example 16.1 is a Time Line graph. In a Time Line graph, all data items in a series are connected by the same line.

To create a Time Line graph in ITXML, set the SubType attribute of Graph to Line. For example:

<Graph Name='graph' Type='Time' SubType='Line'>

Sorting the data items in a Time Line graph prevents the line from weaving back and forth between data items. For more information on sorting data items, see “Sorted Data” on page 16-7.

T I M E S C A T T E R

Time Scatter graphs are like Time Line graphs without any lines. Only symbols are plotted for each data item.

To create a Time Scatter graph in ITXML, set the SubType attribute of Graph to Scatter. For example:

<Graph Name='graph' Type='Time' SubType='Scatter'>


. . .

. .T I M E G R A P H STime Graph Subtypes

7.0Corda

T I M E C O M B O

Time Combo graphs display data series’ using one or more of the following effects: symbols, lines, and fill area. The image below gives an example of an X-Y Combo graph, which works almost exactly like the Time Combo graph.

While you can create a Time Combo graph after the fact by adding area fills, lines, or symbols to any Time graph. However, to be technically correct, designate a Time graph as a Time Combo by setting the SubType attribute of Graph to Combo. For example:

<Graph Name='graph' Type='Time' SubType='Combo'>

For information on adding or changing the effects for a data series, see “Formatting Options” on page 16-7.

Symbols

Line

Area


T I M E G R A P H STime Graph Subtypes

16-6

1 6. .

. . .

Corda 7 Graph Guide

T I M E C O M B O ( D U A L Y S C A L E S )

Time Combo graphs can take advantage of dual y-scales, or independent vertical scales on each side of the graph. Each data series is associated with one of the two y-scales. The two y-scales operate independently of each other.

For example, if all y-values in the data series’ associated with the left scale are less than 60, and all y-values in data the series’ associated with the right scale are in the hundreds, the left scale range is 0 to 60, while the right scale range is be much larger.

To create a Dual Y Scale graph in ITXML, set the SubType attribute of Graph to Dual Y. For example:

<Graph Name='graph' Type='Time' SubType='Dual Y'>

To associate a series with the left or right y-scale, override its SeriesDefinition property by setting the Scale attribute in SeriesDefinition to either Left or Right.

For example, to associate the third data series in a graph with the right scale, use the following SeriesDefinition property within graph.

<SeriesDefinition Number='3' Scale='Right' />

T I M E B U B B L E

The Time Bubble subtype is discussed in the Chapter 6, “Bubble Graphs.”

The yellow bubbles are associated with the right scale, which ranges from 0 to 60.

The red line is associated with the left scale, which is logarithmic and ranges from 500 to 900.


. . .

. .T I M E G R A P H SFormatting Options

7.0Corda


Time graphs support the following formatting options:

D A T E I N P U T F O R M A T

If the times and dates at the bottom of a Time graph aren’t displaying correctly, the format of the time and date data might be incorrect. To resolve this, modify the graph’s date input format string to correctly interpret date and time input.

For example, the default date input format string is %m/%d/%Y. This means that data sent to the graph, either from the Data Editor, or sent dynamically by Corda Server, must be in a format of “month/day/four-digit year” (e.g. 11/30/2005).

The date input format string uses macros to indicate where the graph should expect to find different units of time (such as month, day, or minute) in time data values. Changing the macro definition changes how the graph looks for time and date values.

For example, if all time values for the graph occur on the same day, enter the time data in hours and minutes only by defining the date input format string as %H:%M.

A complete list of supported date and time macros is available in “Date Format” on page 5-13 of the Corda Builder User Guide.

S O R T E D D A T A

Data points are usually connected in the order that they are provided. This means that if data items are provided in non-sequential order, the a line that connects the data series might cross over itself. To avoid this, connect the data items in order of their x-coordinates. To do this, enable Plot Settings > Sort in Object Properties.

Warning: Do not use static PopUp text, drilldown effects, or notes when sorting data items. Dynamic features of this type work, but be aware that the target data points are enumerated by sort order as opposed to list order.

Unsorted Data Sorted Data


T I M E G R A P H SFormatting Options

16-8

1 6. .

. . .

Corda 7 Graph Guide


. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .X-Y GRAPHS 17This chapter contains information about XY graphs, and consists of the following sections:


• X-Y Subtypes



X - Y G R A P H SConceptual Overview

17-2

1 7. .

. . .

Corda 7 Graph Guide


Use X-Y graphs to plot data pairs. X-Y graph data items consist of two values: the x-value and the y-value, which represent the coordinates of that data item. The data item is displayed as a symbol, but you can add a lines, bubbles, or fill areas to better delineate the data. Because of the nature of the data, XY Plot graphs do not have categories.

Example 17.1 below shows how an X-Y graph works.

X-Y graphs are in the Plot Data Class (see Chapter 2 for details).

Example 17.1 X-Y Plot Graph

Series 1

Series 2

17 54 7 75

34 22 29 15

47 18 41 4

50 2

The data items in these columns are considered to be in the Series 2 series. They will appear as teal dots and will be connected by a teal line.

Two data values are used for each data item: x (plotted along the x-axis) and y (plotted along the y-axis).

The data item indicated by the teal dot that this bottom line points to was resolved similarly. The data point plotted was (41, 4).

This top line shows how the data item indicated by the upper left purple dot was resolved. The first value was used as the x coordinate. The second was used as the y coordinate.


. . .

. .X - Y G R A P H SConceptual Overview

7.0Corda


X-Y Plot graphs can be used for:

• Identifying relationships between large data sets

• Identifying trends in large data sets

C R E A T I N G A N X - Y G R A P H

To create an X-Y graph with ITXML, create a Graph property and set its Type attribute to XY. For example:

<Graph Name='graph' Type='XY'>


X - Y G R A P H SX-Y Subtypes

17-4

1 7. .

. . .

Corda 7 Graph Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X - Y S U B T Y P E S

X-Y graph subtypes include the following:

X - Y L I N E

The graph depicted in Example 17.1 is an X-Y Line graph. In an X-Y Line graph, all data items in a series are connected by the same line.

To create an X-Y Line graph in ITXML, set the SubType attribute of Graph to Line. For example:

<Graph Name='graph' Type='XY' SubType='Line'>

Sorting the data items in an XY Line graph prevents the line from weaving back and forth between data items. For more information on sorting data items, see “Sorted Data” on page 17-7.

X - Y S C A T T E R

X-Y Scatter graphs are like X_Y Line graphs without any lines. Only symbols are plotted for each data item.

To create n X-Y Scatter graph in ITXML, set the SubType attribute of Graph to Scatter. For example:

<Graph Name='graph' Type='XY' SubType='Scatter'>


. . .

. .X - Y G R A P H SX-Y Subtypes

7.0Corda

X - Y C O M B O

X-Y Combo graphs display data series’ using one or more of the following effects: symbols, lines, and fill area.

You can create an X-Y Combo graph after the fact by adding adding area fills, lines, or symbols to any X-Y graph. However, to be technically correct, designate a Time graph as a Time Combo by setting the SubType attribute of Graph to Combo. For example:

<Graph Name='graph' Type='XY' SubType='Combo'>

For information on adding or changing the effects for a data series, see “Formatting Options” on page 17-7.

X - Y C O M B O ( D U A L Y S C A L E S )

X-Y Combo graphs can take advantage of dual y-scales, or independent vertical scales on each side of the graph. Each data series is associated with one of the two y-scales. The two y-scales operate independently of each other.

For example, if all y-values in the data series’ associated with the left scale are less than 60, and all y-values in data the series’ associated with the right scale are in the hundreds, the left scale range is 0 to 60, while the right scale range is be much larger.

Symbols

Line

Area


X - Y G R A P H SX-Y Subtypes

17-6

1 7. .

. . .

Corda 7 Graph Guide

To create a Dual Y Scale graph in ITXML, set the SubType attribute of Graph to Dual Y. For example:

<Graph Name='graph' Type='XY' SubType='Dual Y'>

To associate a series with the left or right y-scale, override its SeriesDefinition property by setting the Scale attribute in SeriesDefinition to either Left or Right.

For example, to associate the third data series in a graph with the right scale, use the following SeriesDefinition property within graph.

<SeriesDefinition Number='3' Scale='Right' />

For more information about overriding the ITXML properties, see “ITXML Transformations” on page 4-2 of the Corda 7 Developer Reference.

.

X - Y B U B B L E

The X-Y Bubble subtype is discussed in the Chapter 6, “Bubble Graphs.”

The yellow bubbles are associated with the right scale, which ranges from 0 to 60.

The red line is associated with the left scale, which is logarithmic and ranges from 500 to 900.


. . .

. .X - Y G R A P H SFormatting Options

7.0Corda


X-Y graphs support the following formatting options:

S O R T E D D A T A

Data points are usually connected in the order that they are provided. This means that if data items are provided in non-sequential order, the a line that connects the data series might cross over itself. To avoid this, connect the data items in order of their x-coordinates. To do this, enable Plot Settings > Sort in Object Properties.

Warning: Do not use static PopUp text, drilldown effects, or notes when sorting data items. Dynamic features of this type work, but be aware that the target data points are enumerated by sort order as opposed to list order.

Unsorted Data Sorted Data


X - Y G R A P H SFormatting Options

17-8

1 7. .

. . .

Corda 7 Graph Guide


Date post:	16-Jul-2020
Category:	Documents
Upload:	others
View:	3 times
Download:	0 times

Graph Guide - ComponentSource€¦ · Corda 7 Graph Guide 1-1 Innovative Data Presentation™...

Documents