====================================================================================

Important Announcement

Users upgrading to or installing Spotfire 7.12 or later will need to download and install the latest version of JSViz.  See the "Known Issues" section for more details.

====================================================================================

Introduction

Within the TIBCO Spotfire^® community, one area of discussion that crops up continually is that of new visualization types.  Customers often ask for a visualization type during a POC that Spotfire does not currently support.  Others ask for simple customizations of existing visualizations, such as moving labels around, that sound straightforward but are almost impossible to implement without extensive coding.

There are now a number of JavaScript libraries available for creating rich interactive graphics within a standard web browser.  One such is D3 which has a large library of example visualizations available on the D3 Website.  There are many others, including Highcharts, ZoomCharts and Google Charts.

The JavaScript Visualization Framework, or JSViz, is a Custom Extension for TIBCO Spotfire that allows users to create their own visualizations using JavaScript libraries such as d3 but still allow them to seamlessly integrate with the Spotfire platform.  Note that although d3 was an initial driver for implementing the custom extension, it can actually work with any JavaScript based code.

Samples

Included with the framework are a number of sample charts including:

• Doughnut Chart
• Circle Packing
• Chord Diagram
• Gauges
• Area Chart
• Horizon Chart
• Polar Chart
• Ternary Chart
• Tree Control
• Venn Diagram
• Word Cloud
• other examples:  
  • https://community.tibco.com/wiki/spotfire-sankey-diagram-using-jsviz
  • https://community.tibco.com/wiki/spotfire-funnel-chart-using-jsviz
  • https://community.tibco.com/wiki/tibco-spotfire-survey-data-chart-using-jsviz 
     
  • see how to reuse these examples
    •  https://community.tibco.com/wiki/how-reuse-spotfire-jsviz-example-and-apply-it-your-data

Download JSViz - Versions

JSViz can be downloaded from the TIBCO Exchange.  There are two packages to choose from depending on which version of Spotfire you are using:

• For Spotfire 6.5 and 7.0 use V2.4
   
• For Spotfire 7.5 or higher use V3.4

Both versions have the same capabilities.

For an overview of the different extension and customization options that the Spotfire platform provides, see Extending TIBCO Spotfire.

API

The documentation for the .NET API is now available online here.  This API can be used within Spotfire via IronPython or within a .NET Spotfire Custom Extension to configure JSViz visualizations.

The examples provided with JSViz also include a comprehensive scripting example showing how to use IronPython to create and configure JSViz charts.

Automating Plot Setup

It is possible to automate the creation of JSViz instances from the tool bar or the tools menu, by creating a custom extension that leverages the JSViz API:

• One-click JSViz Visualizations - Extending JSViz for TIBCO Spotfire®
• Automating Plot Setup for JSViz Using a Custom Tool in TIBCO Spotfire®

Articles on TIBCO Community

There are a number of articles on TIBCO Community that describe using JSViz to create different types of custom visualizations and other solutions:

https://community.tibco.com/wiki/displaying-terr-graphics-tibco-spotfire-using-jsviz

https://community.tibco.com/wiki/tibco-spotfire-funnel-chart-using-jsviz

https://community.tibco.com/wiki/how-create-network-chart-visualization-tibco-spotfire-using-jsviz-and-zoomcharts

Help and Support

Please note that JSViz is not supported through support.tibco.com.  In the event of issues or to get help, please post questions in the TIBCO Community Forum here:

https://community.tibco.com/answers

Make sure that you add the tag "JSViz" so that it will be visible.
 

Licensing

JSViz is shared with the TIBCO Community for free use by customers and partners under the  TIBCO Component Exchange License.
 

Known Issues

• JSViz 3.4.0.12 will cause Spotfire to crash if an invalid data configuration is created.  Examples of invalid configurations include:

  -  Removing all Column Expressions in a group-by configuration

  -  Adding a non-aggregated Column Expression in a group-by configuration

  These issues are fixed in JSViz 3.4.0.13.

• JSViz 3.4.0.13 or above is required when upgrading to or installing Spotfire 7.12 or later.  This is due to a clash in versions of log4net.dll between JSViz and Spotfire.  Versions of JSViz above 3.4.0.12 remove any dependancy on log4net.dll.  

• Some users may encounter a problem when using JSViz with Spotfire 7.6.  This is only an issue with older releases of JSViz, 3.4.0.2 and older.  For detailed instructions see the following page: https://community.tibco.com/wiki/jsviz-problems-spotfire-76.  Spotfire 7.6 Hotfix 3 is also required.

• JSViz visuals will work in Web Player and Automation Services as well as Spotfire Analyst (Professional).  Make sure to follow the installation instructions in the documentation.  Many people forget to update the Web Player after installing the plugin files.

• There is an issue with the 3.4.0.8 build recently posted.  Please download and use a later version.

• There is an issue with the resize logic in the doughnutchart.dxp sample which may cause the chart to occasionally appear empty when first opening the dxp file.  An updated version of the JSViz.js javascript file that resolves this issue can be downloaded from here.

• JSViz is not supported on Spotfire Desktop (not to be confused with Spotfire Analyst).

Simpler JS, Brunel

Brunel is an open source Domain Specific Language designed specifically for interactive data visualisation. It allows coding complex Javascript D3 visualisations with as little as one line of code. Brunel can be integrated into Spotfire Javascript visualisations.

• Online try-before-you-download
• Examples and Language Tutorial
• Github
• Blog
• Language Tutorial 
• YouTube