IMSL(R) Java Numerical Library

This README file explains how to install, configure, and use the IMSL Java Numerical Library (JMSL), and it provides additional important updated product information.

Before proceeding, please read and accept the license agreement. If you do not accept the license agreement, you are not authorized to use this product.

Note: For simplicity, all example commands are specified using Linux command line syntax. Windows users will need to adjust commands and paths accordingly.

News, Notes, and Addenda

• JMSL evaluation snd subscription users will receive a license-managed product and must obtain a license key from Rogue Wave Software. If you do not already have a license key refer to https://www.imsl.com/support.
• Users who have purchased the product do not require a license key.
• Check the following files for the latest product changes, platform updates, third-party integration information, and usage notes:
  • CHANGELOG: https://help.imsl.com/java/2021.0/common/changelog.html
  • PLATFORMS: https://help.imsl.com/java/2021.0/common/platforms.html
  • NOTICES: https://help.imsl.com/java/2021.0/common/NOTICES.html
  • README: https://help.imsl.com/java/2021.0/common/README.html
• For additional help, please contact Rogue Wave Software Customer Support (https://www.imsl.com/support). The Customer Support group researches and answers your questions about all Rogue Wave Software products. To expedite the process, be prepared to provide the following information:
  • name and version of the product
  • hardware details (e.g. Intel, Sun, IBM POWER)
  • operating system details (e.g. Windows 10, RHEL 7.1, Solaris 11)
  • compiler details (e.g. Java 8, Java 9)
  • a detailed description of the problem including error messages

Installation Instructions

• Download the distribution file from the Rogue Wave Customer Support portal. Be sure to download the distribution that matches your platform. The file name will specify the product code, version number, and platform mnemonic.
  • Linux
    • jmsl-<VER>-<ENV>.run for users with a valid license key
    • jmsl-<VER>-<ENV>_eval.run for evaluation and subscription users
  • Windows
    • jmsl-<VER>-<ENV>.exe for users with a valid license key
    • jmsl-<VER>-<ENV>_eval.exe for evaluation and subscription users
• Installation Steps:
  1. Start the installation and follow the prompts to install the product files.
  2. Add the installation directory to the java classpath or navigate into the installation directory
     • Copy the jmsl-core-2021.0.0.jar (or jmsl-core-2021.0.0-eval.jar) to a location to be referenced on the java classpath for your application
  3. Evaluation and Subscription Users Only: Set up License:
     • Copy the imsl_eval.dat (obtained via email from the Rogue Wave License Administrator) to a location to be referenced by a system property for your application.
• After installation, reference additional sections of the README included below for information on configuring and using JMSL.
• Access the documentation online.

Display the Version

The version report can be invoked by executing the following command:

java -cp ./path/to/library/jmsl-core-2021.0.0.jar com.imsl.Version

For evaluation and subscription users:

java -cp ./path/to/library/jmsl-core-2021.0.0-eval.jar -Dcom.imsl.license.path=./path/to/license/imsl_eval.dat com.imsl.Version

Compiling Applications

Your application will require a licensed version of the jmsl-core JAR to compile. After obtaining it via the "Usage Instructions" above, your application can be compiled using all typical methods. By doing so, you are accepting the terms of the JMSL license agreement. An example compilation is shown below:

javac -cp ./path/to/library/jmsl-core-2021.0.0.jar <application-source>

For evaluation and subscription users:

javac -cp ./path/to/library/jmsl-core-2021.0.0-eval.jar <application-source>

Building with Maven

JMSL is not available via a public repository. In order to use the library with Maven, you will need to install the JMSL JAR into your local maven repository. By doing so, you are accepting the terms of the JMSL license agreement.

mvn install:install-file -Dfile=/path/to/library/jmsl-core-2021.0.0.jar -DgroupId=com.roguewave
-DartifactId=jmsl-core -Dversion=2021.0.0 -Dpackaging=jar

For evaluation and subscription users:

mvn install:install-file -Dfile=/path/to/library/jmsl-core-2021.0.0-eval.jar -DgroupId=com.roguewave
-DartifactId=jmsl-core -Dversion=2021.0.0 -Dpackaging=jar

Running Applications

Your application will require a licensed version of the jmsl-core JAR to run. After obtaining it via the "Usage Instructions" above, your application can be invoked using all typical methods. By doing so, you are accepting the terms of the JMSL license agreement. An example invocation is shown below:

java -cp ./path/to/library/jmsl-core-2021.0.0.jar <application-class>

For evaluation and subscription users:

java -cp ./path/to/library/jmsl-core-2021.0.0.jar -Dcom.imsl.license.path=./path/to/license/imsl_eval.dat <application-class>