webMathematica User Guide

webMathematica is a web server version of Mathematica. It allows you to build websites with interactive calculations and visualizations driven by Mathematica. It is a key way to deliver technical computing solutions in a networked environment.

New Features

webMathematica 3.5

webMathematica 3.4

webMathematica 3.3

webMathematica 3.2

webMathematica 3.1

webMathematica 3.0

webMathematica 2.3

webMathematica 2.2

webMathematica 2.1

webMathematica 2.0

Installation

Setting Up a Servlet Container

Setting Up Java

Linux

Windows

Mac OS X

Setting Up Tomcat

Linux

Windows

Mac OS X

Installing and Configuring Mathematica

Installing the webMathematica Web Application

Tomcat

Other Servlet Engines

Configuring for the X Window System (Linux only)

Configuring Xvnc and webMathematica

Install Xvnc

Launch Xvnc

Test Xvnc

Configure webMathematica

Other X Related Issues

Connecting to the X Server

Xvfb

Manual Font Installation

Upgrading from Previous Versions of webMathematica

Install Mathematica

Install the webMathematica Web Application

Configure the New Layout

web.xml

MSPConfiguration.xml

Security Configuration

Move Content to the New Layout

Finalize the Installation

Optional Further Configuring

MSP Mathematica Application

Viewing webMathematica Documentation in the Mathematica Documentation Center

Launching webMathematica Automatically

Unix

Windows

Web Server Connections

Apache and Tomcat

Microsoft Servers and Tomcat

Testing

Basic Examples

Hello.jsp

Working with Variables: Variables.jsp

MSP Functions: Expand.jsp

Graphics: Plot.jsp

Typeset Images: Integrate.jsp

Live 3D Plotting: Plot3DLive.jsp

Getting Messages: Messages.jsp

Returning General Content: Content.jsp

Interactive Web: SliderPlot.jsp

Applets: TextApplet.jsp

JavaScript: PlotScript.jsp

Setting Variables: SetBasic.jsp

Getting Variables: GetBasic.jsp

Developing Your Own Pages

Wolfram Workbench

Tips and Tricks

Variables

Coding in Pages

Templates

Browse Examples

Design Examples

Banners and Buttons

Minimal Installation

Minimal File Layout

Applications

XML

Introduction to XML

XML Compliance

Mathematica Support for XML

webMathematica XML Applications

MathML

Embedding MathML in Web Documents

XHTML

XHTML and MathML

Rendering XHTML and MathML Documents

Generating MathML from webMathematica

MathML Integrate Example

SVG

Plotting with SVG

SVG Animations

HTML Formatting

The HTML Functions

HTMLTableForm

HTMLFormat

HTMLSelect

HTMLCheckBox

webMathematica Examples

Table Formatting

Select Formatting

HTML User Interfaces

Overview of HTML Forms

Calculating the Output from Form Inputs

Initializing the Form and Validating Form Input

Getting Input from a Text Field

Getting Input from a Dropdown Menu

Getting Input from Radio Buttons

Getting Input from a Checkbox

Getting Input from a Slider

Interactive Web Tools

Example: SliderPlot.jsp

Underlying Technology and Limitations

Using Java APIs

Server APIs

Other Java APIs

Data Loading and Computation

File I/O

HTTP Upload

Database Connectivity

Web Services

Data Examples

Loading Data: Load.jsp

Uploading Data: Upload.jsp

Session Storage of Data: Session.jsp

Database Connections: Database.jsp

Mathematica Packages and Applications

Loading Packages

Writing Packages

Installing Packages

webMathematica Applications

$BaseDirectory

$UserBaseDirectory

The Script Directory

$TopDirectory

Absolute Filename

Extended Page Language

Expression Language

Standard Tags

if

set

choose/when/otherwise

Queuing of Long Calculations

Interacting with the Queue

The Job Queue

Lifetime of a Queued Request

Organizing and Configuring a Queued Pool

PDF Documents

Generating a Mathematica Notebook

Converting to PostScript

Converting PostScript to PDF

Creating PDF Example

Returning General Content

Direct Return

MSPReturn

MSPURLStore

AJAX

Time Example

HTML Example

Web Services and XML Exchange

Web Services

Informal Web Services

AJAX Example

Mathematica SOAP Client

webMathematica SOAP Services

Echo Example

Plot Example

Excel Example

Type Specification

Simple Data Types

Date and Time Data

Binary Data

SchemaExpr

SchemaMathML

Arrays

Errors and Exceptions

Security

Advanced Topics

Variables

Input Variables

Interpretation of Input Variables

Interpreted versus Noninterpreted Values

MSPBlock versus MSPToExpression

Page Variables

Session Variables

Security

Server Security

Mathematica Program Security

MSPBlock

MSPToExpression

Avoid ToExpression

Security Validation

The Validation Process

Configuring a Security Model

ToExpression Validation

Security and Kernel Pools

Access Restrictions

Evaluation Formatting

Automatic Formatting

MSPFormat

String Formatting

Graphics and Image Formatting

Suppressing Output

Multiple Calculations

Multiple Kernel Pools

Mapping JSPs to Pools

Multiple Web Applications

Mapping URLs onto JSPs

Handling Errors

Catching Mathematica Error Exceptions

Adding an HTTP Error Page

Displaying Mathematics and Graphics

MSP Functions Returning Images

LiveGraphics3D

Including Static Files

Troubleshooting

Initial Checks

Check the Server

Check the URL

Check the Initial Page

Check the Kernel Monitor

Check the Logging System

Check the Console Shell

Check Mathematica

Specific Problems

Problems Running the Kernel

Problems Running the Front End

Problems Launching the Front End (Windows only)

Problems Testing Xvnc (Unix only)

Problems Testing Xvfb (Unix only)

Images Do Not Work

Mathematica Packages and Applications

Kernel Initialization

Vertical Alignment in Formatting

Timeout Problems

UnsatisfiedLinkError

Cannot Load JLink`

NoClassDefFoundError: TryCatchFinally

NoClassDefFoundError: JLink Classes

NoSuchMethodError: KernelData

Debugging webMathematica

Not Using Wolfram Workbench

Using Wolfram Workbench

Logging

webMathematica Logging

Server Logging

The Kernel Monitor

Reporting Problems

Reference

Configuration

Functions

Guides

Configuration

Formatting

MSPTags

ProcessingInput

WebInteraction

webMathematica

Tags

evaluate

evaluateQueued

set

get

Appendix