SAS® IML Packages

Overview

A package is a collection of SAS IML function modules that share a common purpose. Programmers can store the modules and use them in their SAS IML programs.

Packages in SAS Viya® are managed by using a repository on GitHub. You can clone the repository to obtain a copy of the functions. When you execute the source files, the functions are stored in a module library. You can then load the functions and use them in your programs.

This method enables you to use libraries of function modules in the IML procedure and in the IML action. The same process also works for PROC IML in SAS® 9.4.

List of Packages

• The Metalog package supports using the metalog system of distributions.

Prerequisites

These modules have been tested on the following software:

• SAS/IML® in SAS 9.4 Maintenance version 7
• SAS IML in SAS Viya. This includes both the IML procedure and the iml action.

Getting Started

To use the packages, you must download the source code and include the source files in your SAS IML program.

Installing the Packages

When you download the repository, you get all packages. Each package is contained in its own directory. Each package contains documentation that shows how to use the package. The installation steps depend on the client: SAS, R, Python, and so forth.

On the SAS client, you can use the GITFN_CLONE function in the DATA step to clone the repository to a local directory or to a libref such as WORK. You can then use a %INCLUDE statement to run the statements that define and store the function modules. For example, in PROC IML, you can use the following statements to clone the sas-iml-packages repository to the WORK libref:

%let gitURL = https://github.com/sassoftware/sas-iml-packages/;
options dlcreatedir;
%let repoPath = %sysfunc(getoption(WORK))/sas-iml-packages/;

/* clone repository; if repository exists, skip download */
data _null_;
if fileexist("&repoPath.") then 
   put 'Repository already exists; skipping the clone operation'; 
else do;
   put 'Cloning repository sas-iml-packages';
   rc = gitfn_clone("&gitURL", "&repoPath." ); 
end;
run;

If you want the package files to remain after the SAS session ends, you can download the files to a permanent location.

Running a Package

You need to clone the repository only one time. Whenever you want to use a package, use the %INCLUDE statement on the SAS client to read and define the functions in the package. For example, if you want to use the Metalog package, use the following statements:

proc iml;
%include "&repoPath./Metalog/ML_proc.sas";
%include "&repoPath./Metalog/ML_define.sas";
/* use the functions here */
quit;

Each file ends with a STORE statement, which means that the functions are stored to the active library. Consequently, you can use the LOAD statement to read the functions into subsequent calls to PROC IML in the same SAS session:

proc iml;
LOAD MODULE= _ALL_;
/* use the functions here */
quit;

See the individual packages for details.

Contributing

We welcome your contributions. Please read CONTRIBUTING.md for details about submitting contributions to this project.

License

This project is licensed under the Apache 2.0 License.

Additional Resources

The directory for each package contains references and additional resources for the package.