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

• Throughout this README file, we use the following conventions where certain details differ by platform:
  • <ROGUEWAVE_DIR> the base product installation directory
  • <VER> the version number of the product
• Starting with JMSL 2025.1.0, the installer will install the product and documentation in <ROGUEWAVE_DIR>/imsl/jmsl-<VER>
• JMSL evaluation and subscription users will receive a license-managed product and must obtain a license key from Perforce 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/2025.1/common/changelog.html
  • PLATFORMS: https://help.imsl.com/java/2025.1/common/platforms.html
  • NOTICES: https://help.imsl.com/java/2025.1/common/NOTICES.html
  • README: https://help.imsl.com/java/2025.1/common/README.html
• For additional help, please contact Perforce Customer Support (https://portal.perforce.com/s/ ). The Customer Support group researches and answers your questions about all Perforce 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)
  • compiler details (e.g. Java 8, Java 11)
  • a detailed description of the problem including error messages

Installation Instructions

• Download the distribution file from the IMSL website. 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. There is an option to install the JMSL Documentation locally.
  2. Add the installation directory to the java classpath or navigate into the installation directory
     • Copy the jmsl-core-<VER>.jar (or jmsl-core-<VER>-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 Perforce 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 or in <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/index.html if JMSL Documentation was installed.

Display the Version

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

java -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar com.imsl.Version

For evaluation and subscription users:

java -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-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 <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar <application-source>

For evaluation and subscription users:

javac -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-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. For installing with JMSL javadocs in Maven, see the next section.

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Dpackaging=jar

For evaluation and subscription users:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-eval.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Dpackaging=jar

Installing with JMSL javadocs in Maven

If the installation includes JMSL Documentation (select this option if desired), the library can be installed along with associated javadocs into your local Maven repository.

Navigate to <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/. Run the command

jar cvf jmsl-core-<VER>-javadoc.jar *

or

jar cvf jmsl-core-<VER>-eval-javadoc.jar *

This will package all the html documentation into the JAR file, jmsl-core-<VER>-javadoc.jar ( or jmsl-core-<VER>-eval-javadoc.jar) Then the Maven install command can be adapted to include the javadocs:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER>  -Djavadoc=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/jmsl-core-<VER>-javadoc.jar
-Dpackaging=jar

Or, for evaluation and subscription users:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-eval.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Djavadoc=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/jmsl-core-<VER>-eval-javadoc.jar
-Dpackaging=jar

Running Applications

Your application will require a licensed version of the jmsl-core JAR to run. After obtaining it via the "Installation 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 <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar <application-class>

For evaluation and subscription users:

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

Alternatively, license file location may be specified in project code:

import java.util.Properties;

...
 
// Query appropriate environment variable to get location of IMSL license file

Properties props = System.getProperties();
props.setProperty("com.imsl.license.path", "./path/to/license/imsl_eval.dat");

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

• Throughout this README file, we use the following conventions where certain details differ by platform:
  • <ROGUEWAVE_DIR> the base product installation directory
  • <VER> the version number of the product
• Starting with JMSL 2025.1.0, the installer will install the product and documentation in <ROGUEWAVE_DIR>/imsl/jmsl-<VER>
• JMSL evaluation and subscription users will receive a license-managed product and must obtain a license key from Perforce 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/2025.1/common/changelog.html
  • PLATFORMS: https://help.imsl.com/java/2025.1/common/platforms.html
  • NOTICES: https://help.imsl.com/java/2025.1/common/NOTICES.html
  • README: https://help.imsl.com/java/2025.1/common/README.html
• For additional help, please contact Perforce Customer Support (https://portal.perforce.com/s/ ). The Customer Support group researches and answers your questions about all Perforce 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)
  • compiler details (e.g. Java 8, Java 11)
  • a detailed description of the problem including error messages

Installation Instructions

• Download the distribution file from the IMSL website. 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. There is an option to install the JMSL Documentation locally.
  2. Add the installation directory to the java classpath or navigate into the installation directory
     • Copy the jmsl-core-<VER>.jar (or jmsl-core-<VER>-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 Perforce 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 or in <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/index.html if JMSL Documentation was installed.

Display the Version

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

java -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar com.imsl.Version

For evaluation and subscription users:

java -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-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 <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar <application-source>

For evaluation and subscription users:

javac -cp <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-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. For installing with JMSL javadocs in Maven, see the next section.

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Dpackaging=jar

For evaluation and subscription users:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-eval.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Dpackaging=jar

Installing with JMSL javadocs in Maven

If the installation includes JMSL Documentation (select this option if desired), the library can be installed along with associated javadocs into your local Maven repository.

Navigate to <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/. Run the command

jar cvf jmsl-core-<VER>-javadoc.jar *

or

jar cvf jmsl-core-<VER>-eval-javadoc.jar *

This will package all the html documentation into the JAR file, jmsl-core-<VER>-javadoc.jar ( or jmsl-core-<VER>-eval-javadoc.jar) Then the Maven install command can be adapted to include the javadocs:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER>  -Djavadoc=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/jmsl-core-<VER>-javadoc.jar
-Dpackaging=jar

Or, for evaluation and subscription users:

mvn install:install-file -Dfile=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>-eval.jar -DgroupId=com.perforce
-DartifactId=jmsl-core -Dversion=<VER> -Djavadoc=<ROGUEWAVE_DIR>/imsl/jmsl-<VER>/apidocs/jmsl-core-<VER>-eval-javadoc.jar
-Dpackaging=jar

Running Applications

Your application will require a licensed version of the jmsl-core JAR to run. After obtaining it via the "Installation 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 <ROGUEWAVE_DIR>/imsl/jmsl-<VER>/jmsl-core-<VER>.jar <application-class>

For evaluation and subscription users:

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

Alternatively, license file location may be specified in project code:

import java.util.Properties;

...
 
// Query appropriate environment variable to get location of IMSL license file

Properties props = System.getProperties();
props.setProperty("com.imsl.license.path", "./path/to/license/imsl_eval.dat");