mirror of
https://github.com/yabwon/SAS_PACKAGES.git
synced 2026-01-03 13:20:05 +00:00
Compare commits
4 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
742e4ac3d3 | ||
|
|
74360b4cca | ||
|
|
aba2ee4f44 | ||
|
|
55f4e35e0e |
25
README.md
25
README.md
@@ -8,7 +8,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
|
||||
|
||||
The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
|
||||
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20201209`**.
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20210109`**.
|
||||
|
||||
To get started with SAS Packages try this [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
|
||||
|
||||
@@ -32,7 +32,8 @@ and then either:
|
||||
- Download the `SPFinit.sas` file (the SAS Packages Framework) into the local packages folder.
|
||||
- \[Optional\] Manually download the `<packageName>.zip` file into the local packages folder.
|
||||
- and Execute:
|
||||
```
|
||||
|
||||
```sas
|
||||
filename packages "<directory/containing/packages/>"; /* setup directory for packages */
|
||||
%include packages(SPFinit.sas); /* enable the framework */
|
||||
|
||||
@@ -44,7 +45,7 @@ filename packages "<directory/containing/packages/>"; /* setup directory for pac
|
||||
|
||||
or if you need it just for "one time" only Execute:
|
||||
|
||||
```
|
||||
```sas
|
||||
filename packages "%sysfunc(pathname(work))"; /* setup temporary directory for packages in the WORK */
|
||||
filename SPFinit url "https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.sas";
|
||||
%include SPFinit; /* enable the framework */
|
||||
@@ -95,12 +96,12 @@ The List:
|
||||
Currently the following packages are available (see the `./packages` directory):
|
||||
|
||||
- **SQLinDS**\[2.2\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
|
||||
```
|
||||
```sas
|
||||
data class;
|
||||
set %SQL(select * from sashelp.class order by age);
|
||||
run;
|
||||
```
|
||||
SHA256 digest for SQLinDS: CE1A266B9030E5E336B45F53DF483F6913FD8AE88A2884CEE88BEEF621FDBD78
|
||||
SHA256 digest for SQLinDS: 3034A0C8AC43683AD55698861DBBDEBDE6FC8567D59ECF2BB5F3389FE6BC8062
|
||||
|
||||
[Documentation for SQLinDS](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/sqlinds.md "Documentation for SQLinDS")
|
||||
|
||||
@@ -110,14 +111,14 @@ SHA256 digest for MacroCore: A23C29529F3CE7D0C8BEE9545C5D22D5B5594907547374A5135
|
||||
|
||||
[Documentation for MacroCore](https://core.sasjs.io "Documentation for MacroCore")
|
||||
|
||||
- **DFA** (Dynamic Function Arrays)\[0.3\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
- **DFA** (Dynamic Function Arrays)\[0.4\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
|
||||
SHA256 digest for DFA: 1FC8D030D576C33F1B5DEB27E17534946209BC148D57A1357CA025ED1E69AEB8
|
||||
SHA256 digest for DFA: E777D4578DFDEB2277D58264BAB5BFDBEAFD4E538D4831CDCBFFB4216D2441C2
|
||||
|
||||
[Documentation for DFA](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/dfa.md "Documentation for DFA")
|
||||
|
||||
- **macroArray**\[0.8\], implementation of an array concept in a macrolanguage, e.g.
|
||||
```
|
||||
```sas
|
||||
%array(ABC[17] (111:127), macarray=Y);
|
||||
|
||||
%macro test();
|
||||
@@ -135,13 +136,13 @@ SHA256 digest for DFA: 1FC8D030D576C33F1B5DEB27E17534946209BC148D57A1357CA025ED1
|
||||
which = 1:H:2
|
||||
);
|
||||
```
|
||||
SHA256 digest for macroArray: AC3AD58AFBBE459616743DC6346330BD8DD33FBA8CDD595423F181B67D0475BC
|
||||
SHA256 digest for macroArray: 42E87B80450B3E1AD462B9B63B41F34C83B7745AA0F98C3CA72AA19F3B1FF10E
|
||||
|
||||
[Documentation for macroArray](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/macroarray.md "Documentation for macroArray")
|
||||
|
||||
|
||||
- **BasePlus**\[0.991\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
```
|
||||
```sas
|
||||
call arrMissToRight(myArray);
|
||||
call arrFillMiss(17, myArray);
|
||||
call arrFill(42, myArray);
|
||||
@@ -154,12 +155,12 @@ format x bool.;
|
||||
|
||||
%put %getVars(sashelp.class, pattern = ght$, sep = +, varRange = _numeric_);
|
||||
```
|
||||
SHA256 digest for BasePlus: 9EA40F72191D1916189F043315CA519F6E42CEB05C186F7653AE464D21D21CFB
|
||||
SHA256 digest for BasePlus: 28F3DE865C5E3B914FFB7CC2627D8B0975527EEECEE7AFEAD7B335C3FDC1BFD3
|
||||
|
||||
[Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
|
||||
|
||||
- **dynMacroArray**\[0.2\], set of macros (wrappers for a hash table) emulating dynamic array in the data step (macro predecessor of DFA)
|
||||
|
||||
SHA256 digest for dynMacroArray: 5E8CCC88CC048A0B564CEE37C6CF4013857D9CFF3FA1B6B9AD6F719D08B30005
|
||||
SHA256 digest for dynMacroArray: 8B0777EA3CF41968C0B029AA57B1F809D21D1BAB1B88A35B0EA5DB3C6DD9E748
|
||||
|
||||
### ======
|
||||
|
||||
Binary file not shown.
@@ -20,7 +20,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
|
||||
|
||||
The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
|
||||
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20201209`**.
|
||||
In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20210109`**.
|
||||
|
||||
**To get started with SAS Packages** try this [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
|
||||
|
||||
@@ -38,7 +38,7 @@ After assigning the directory do not change them when using the SPF since it may
|
||||
## This is short help information for the `installPackage` macro <a name="installpackage"></a>
|
||||
--------------------------------------------------------------------------------------------
|
||||
|
||||
Macro to install SAS packages, version `20201209`
|
||||
Macro to install SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -95,7 +95,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `helpPackage` macro <a name="helppackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to get help about SAS packages, version `20201209`
|
||||
Macro to get help about SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -165,7 +165,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `loadPackage` macro <a name="loadpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to *load* SAS packages, version `20201209`
|
||||
Macro to *load* SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -238,7 +238,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `loadPackageS` macro <a name="loadpackages"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro wrapper for the loadPackage macro, version `20201209`
|
||||
Macro wrapper for the loadPackage macro, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -287,7 +287,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `unloadPackage` macro <a name="unloadpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to unload SAS packages, version `20201209`
|
||||
Macro to unload SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -352,7 +352,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `listPackages` macro <a name="listpackages"></a>
|
||||
-----------------------------------------------------------------------------------------
|
||||
|
||||
Macro to list available SAS packages, version `20201209`
|
||||
Macro to list available SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -393,7 +393,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `verifyPackage` macro <a name="verifypackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to verify SAS package with it hash digest, version `20201209`
|
||||
Macro to verify SAS package with it hash digest, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -446,7 +446,7 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
|
||||
## This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to get previwe of a SAS packages, version `20201209`
|
||||
Macro to get previwe of a SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -513,7 +513,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
|
||||
## This is short help information for the `generatePackage` macro <a name="generatepackage"></a>
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Macro to generate SAS packages, version `20201209`
|
||||
Macro to generate SAS packages, version `20210109`
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
|
||||
162
SPF/SPFinit.sas
162
SPF/SPFinit.sas
@@ -42,7 +42,7 @@
|
||||
- to unload, or
|
||||
- to generate SAS packages.
|
||||
|
||||
Version 20201209.
|
||||
Version 20210109.
|
||||
See examples below.
|
||||
|
||||
A SAS package is a zip file containing a group of files
|
||||
@@ -81,7 +81,7 @@
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load SAS package, version 20201209. Run %loadPackage() for help info.'
|
||||
des = 'Macro to load SAS package, version 20210109. Run %loadPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -96,7 +96,7 @@ des = 'Macro to load SAS package, version 20201209. Run %loadPackage() for help
|
||||
%put ### This is short help information for the `loadPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to *load* SAS packages, version `20201209` #;
|
||||
%put # Macro to *load* SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -251,7 +251,7 @@ des = 'Macro to load SAS package, version 20201209. Run %loadPackage() for help
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to unload SAS package, version 20201209. Run %unloadPackage() for help info.'
|
||||
des = 'Macro to unload SAS package, version 20210109. Run %unloadPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -266,7 +266,7 @@ des = 'Macro to unload SAS package, version 20201209. Run %unloadPackage() for h
|
||||
%put ### This is short help information for the `unloadPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to unload SAS packages, version `20201209` #;
|
||||
%put # Macro to unload SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -390,7 +390,7 @@ des = 'Macro to unload SAS package, version 20201209. Run %unloadPackage() for h
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to get help about SAS package, version 20201209. Run %helpPackage() for help info.'
|
||||
des = 'Macro to get help about SAS package, version 20210109. Run %helpPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -405,7 +405,7 @@ des = 'Macro to get help about SAS package, version 20201209. Run %helpPackage()
|
||||
%put ### This is short help information for the `helpPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get help about SAS packages, version `20201209` #;
|
||||
%put # Macro to get help about SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -515,7 +515,7 @@ TODO:
|
||||
- add MD5(&packageName.) value hash instead "package" word in filenames [DONE]
|
||||
*/
|
||||
|
||||
/* Macros to install SAS packages, version 20201209 */
|
||||
/* Macros to install SAS packages, version 20210109 */
|
||||
/* A SAS package is a zip file containing a group of files
|
||||
with SAS code (macros, functions, data steps generating
|
||||
data, etc.) wrapped up together and %INCLUDEed by
|
||||
@@ -531,7 +531,7 @@ TODO:
|
||||
/secure
|
||||
minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to install SAS package, version 20201209. Run %%installPackage() for help info.'
|
||||
des = 'Macro to install SAS package, version 20210109. Run %%installPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
%do;
|
||||
@@ -546,7 +546,7 @@ des = 'Macro to install SAS package, version 20201209. Run %%installPackage() fo
|
||||
%put ### This is short help information for the `installPackage` macro #;
|
||||
%put #--------------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to install SAS packages, version `20201209` #;
|
||||
%put # Macro to install SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -842,7 +842,7 @@ des = 'Macro to install SAS package, version 20201209. Run %%installPackage() fo
|
||||
|
||||
/* Macro to list SAS packages in packages folder.
|
||||
|
||||
Version 20201209
|
||||
Version 20210109
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -862,7 +862,7 @@ des = 'Macro to install SAS package, version 20201209. Run %%installPackage() fo
|
||||
|
||||
|
||||
%macro listPackages()/PARMBUFF
|
||||
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20201209.'
|
||||
des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20210109.'
|
||||
;
|
||||
%if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
|
||||
%do;
|
||||
@@ -877,7 +877,7 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
|
||||
%put ### This is short help information for the `listPackages` macro #;
|
||||
%put #-----------------------------------------------------------------------------------------#;;
|
||||
%put # #;
|
||||
%put # Macro to list available SAS packages, version `20201209` #;
|
||||
%put # Macro to list available SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -1008,7 +1008,7 @@ options ls = &ls_tmp. ps = &ps_tmp. ¬es_tmp. &source_tmp.;
|
||||
|
||||
/* Macro to generate SAS packages.
|
||||
|
||||
Version 20201209
|
||||
Version 20210109
|
||||
|
||||
A SAS package is a zip file containing a group
|
||||
of SAS codes (macros, functions, data steps generating
|
||||
@@ -1040,7 +1040,7 @@ options ls = &ls_tmp. ps = &ps_tmp. ¬es_tmp. &source_tmp.;
|
||||
if set to DEF then the !SASROOT/sasv9.cfg is used */
|
||||
)/secure minoperator
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to generate SAS packages, version 20201209. Run %generatePackage() for help info.'
|
||||
des = 'Macro to generate SAS packages, version 20210109. Run %generatePackage() for help info.'
|
||||
;
|
||||
%if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
|
||||
%do;
|
||||
@@ -1055,7 +1055,7 @@ des = 'Macro to generate SAS packages, version 20201209. Run %generatePackage()
|
||||
%put ### This is short help information for the `generatePackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to generate SAS packages, version `20201209` #;
|
||||
%put # Macro to generate SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -1832,7 +1832,7 @@ data _null_;
|
||||
*/
|
||||
/* test for supported types */
|
||||
if not (upcase(type) in:
|
||||
('LIBNAME' 'MACRO' 'DATA' 'FUNCTION' /*'FUNCTIONS'*/ 'FORMAT' 'IMLMODULE' 'PROTO' 'EXEC' 'CLEAN' 'LAZYDATA' 'TEST'))
|
||||
('LIBNAME' 'MACRO' /*'MACROS'*/ 'DATA' 'FUNCTION' /*'FUNCTIONS'*/ 'FORMAT' /*'FORMATS'*/ 'IMLMODULE' 'PROTO' 'EXEC' 'CLEAN' 'LAZYDATA' 'TEST'))
|
||||
then
|
||||
do;
|
||||
putlog 'WARNING: Type ' type 'is not yet supported.';
|
||||
@@ -1858,23 +1858,27 @@ data _null_;
|
||||
/* HEADERS for IML, FCMP, and PROTO */
|
||||
if 1 = FIRST.type and upcase(type)='FUNCTIONS' then /* header, for multiple functions in one FCMP run */
|
||||
do;
|
||||
put "proc fcmp outlib = work.%lowcase(&packageName.fcmp).package; ";
|
||||
put "proc fcmp outlib = work.%lowcase(&packageName.fcmp).package ; ";
|
||||
end;
|
||||
if 1 = FIRST.type and upcase(type)='PROTO' then /* header, for multiple functions in one FCMP run */
|
||||
do;
|
||||
put "proc proto package = work.%lowcase(&packageName.proto).package; ";
|
||||
put "proc proto package = work.%lowcase(&packageName.proto).package ; ";
|
||||
end;
|
||||
if 1 = FIRST.type and upcase(type)='IMLMODULE' then /* header, for IML modules */
|
||||
do;
|
||||
put "proc iml; ";
|
||||
put "proc iml ; ";
|
||||
end;
|
||||
if 1 = FIRST.type and upcase(type)='FORMATS' then /* header, for FORMATS */
|
||||
do;
|
||||
put "proc format lib = work.%lowcase(&packageName.format) ; ";
|
||||
end;
|
||||
|
||||
/* include the file with the code of the element */
|
||||
put '%include' " &_PackageFileref_.(_" folder +(-1) "." file +(-1) ') / nosource2;' /;
|
||||
|
||||
/* FOOTERS for IML, FCMP, and PROTO */
|
||||
if 1 = LAST.type and upcase(type)='FUNCTIONS' then /* footer, for multiple functions in one FCMP run */
|
||||
do;
|
||||
if 1 = LAST.type and upcase(type) in ('FUNCTIONS' 'PROTO' 'FORMATS') then
|
||||
do; /* footer, for multiple functions in one FCMP run, one PROTO run, or one FORMAT run */
|
||||
put "run; ";
|
||||
end;
|
||||
if 1 = LAST.type and upcase(type)='IMLMODULE' then /* footer, for IML modules */
|
||||
@@ -1883,11 +1887,6 @@ data _null_;
|
||||
put "store module = _ALL_; "; /* and store all created modules */
|
||||
put "quit; ";
|
||||
end;
|
||||
if 1 = LAST.type and upcase(type)='PROTO' then /* footer, for multiple functions in one PROTO run */
|
||||
do;
|
||||
put "run; ";
|
||||
end;
|
||||
|
||||
|
||||
isFunction + (upcase(type)=:'FUNCTION');
|
||||
isFormat + (upcase(type)=:'FORMAT');
|
||||
@@ -2321,7 +2320,7 @@ data _null_;
|
||||
when (upcase(type) =: "FUNCTION" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) =: "IMLMODULE" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) =: "PROTO" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) = "FORMAT" ) fileshort2 = cats("'$", fileshort, ".'" );
|
||||
when (upcase(type) =: "FORMAT" ) fileshort2 = cats("'$", fileshort, ".'" );
|
||||
otherwise fileshort2 = fileshort;
|
||||
end;
|
||||
strX = catx('/', folder, order, type, file, fileshort, fileshort2);
|
||||
@@ -2439,7 +2438,7 @@ data _null_;
|
||||
put ' end ; ';
|
||||
%end;
|
||||
|
||||
put 'put "***"; put "* SAS package generated by generatePackage, version 20201209 *"; put "***";';
|
||||
put 'put "***"; put "* SAS package generated by generatePackage, version 20210109 *"; put "***";';
|
||||
|
||||
put 'run; ' /;
|
||||
|
||||
@@ -2481,7 +2480,7 @@ data _null_;
|
||||
when (upcase(type) =: "FUNCTION" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) =: "IMLMODULE" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) =: "PROTO" ) fileshort2 = cats("'", fileshort, "()'" );
|
||||
when (upcase(type) = "FORMAT" ) fileshort2 = cats("'$", fileshort, ".'" );
|
||||
when (upcase(type) =: "FORMAT" ) fileshort2 = cats("'$", fileshort, ".'" );
|
||||
otherwise fileshort2 = fileshort;
|
||||
end;
|
||||
strX = catx('/', folder, order, type, file, fileshort, fileshort2);
|
||||
@@ -2640,7 +2639,51 @@ filename &zipReferrence. clear;
|
||||
/* check if systask is available */
|
||||
%if %sysfunc(GETOPTION(XCMD)) = NOXCMD %then
|
||||
%do;
|
||||
%put WARNING: ** NO TESTING WILL BE EXECUTED DUE TO NOXCMD. **;
|
||||
data _null_;
|
||||
put 'WARNING: NO TESTING WILL BE EXECUTED DUE TO NOXCMD.';
|
||||
put '***************************************************';
|
||||
put ;
|
||||
|
||||
put 'NOTE-To execute the loading test manualy';
|
||||
put 'NOTE-run the following code:';
|
||||
put 'NOTE-';
|
||||
|
||||
n=6;
|
||||
put @n "filename packages '&packages.';" /;
|
||||
|
||||
if fileexist("&packages./SPFinit.sas") then
|
||||
put @n '%include packages(SPFinit.sas);' /;
|
||||
else if fileexist("&packages./loadpackage.sas") then
|
||||
put @n '%include packages(loadpackage.sas);' / ; /* for older versions when the SPFinit.sas did not exist */
|
||||
|
||||
/* load */
|
||||
put @n '%loadpackage'"(&packageName.,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
put @n '%loadpackage'"(&packageName.,";
|
||||
put @n " path=&filesLocation., lazyData=*)" /;
|
||||
|
||||
/* help */
|
||||
put @n '%helpPackage'"(&packageName.,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
put @n '%helpPackage'"(&packageName.,*,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
put @n '%helpPackage'"(&packageName.,License,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
|
||||
/* preview */
|
||||
put @n '%previewPackage'"(&packageName.,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
put @n '%previewPackage'"(&packageName.,*,";
|
||||
put @n " path=&filesLocation.)" /;
|
||||
|
||||
/* unload */
|
||||
put @n '%unloadPackage'"(&packageName.,";
|
||||
put @n " path=&filesLocation.) " /;
|
||||
|
||||
put ;
|
||||
put '***************************************************';
|
||||
run;
|
||||
|
||||
%GOTO NOTESTING;
|
||||
%end;
|
||||
|
||||
@@ -2799,9 +2842,54 @@ data _null_;
|
||||
put '%previewPackage'"(&packageName.,*,";
|
||||
put " path=&filesLocation.)" /;
|
||||
|
||||
/*check if package elements realy exists*/
|
||||
EOF = 0;
|
||||
do until(EOF);
|
||||
set &filesWithCodes. end = EOF;
|
||||
by type notsorted;
|
||||
|
||||
fileshortUP = UPCASE(fileshort); drop fileshortUP;
|
||||
|
||||
select;
|
||||
when (upcase(type) in ("LAZYDATA")) /* the "DATA" type will pop-up during deletion */
|
||||
do;
|
||||
if 1 = FIRST.type then
|
||||
put "data _null_; " ;
|
||||
put " if not exist('" fileshortUP "') then " /
|
||||
" put 'WARNING: Dataset " fileshortUP "does not exist!'; "
|
||||
;
|
||||
if 1 = LAST.type then
|
||||
put "run; ";
|
||||
end;
|
||||
|
||||
when (upcase(type) = "MACRO")
|
||||
do;
|
||||
if 1 = FIRST.type then
|
||||
put "data _null_; " ;
|
||||
put ' if not input(resolve(''%SYSMACEXIST(' fileshortUP ')''), best.) then ' /
|
||||
" put 'WARNING: Macro " fileshortUP "does not exist!'; "
|
||||
;
|
||||
if 1 = LAST.type then
|
||||
put "run; ";
|
||||
|
||||
end;
|
||||
/* the "FUNCTION" type will pop-up during deletion */
|
||||
|
||||
/* figure out checks for remaining list: */
|
||||
/*
|
||||
"IMLMODULE"
|
||||
"PROTO"
|
||||
"FORMAT"
|
||||
*/
|
||||
otherwise;
|
||||
end;
|
||||
end;
|
||||
|
||||
/* unload */
|
||||
put '%unloadPackage'"(&packageName.,";
|
||||
put " path=&filesLocation.) " /;
|
||||
|
||||
stop;
|
||||
run;
|
||||
|
||||
/*
|
||||
@@ -3082,7 +3170,7 @@ TODO: (in Polish)
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20201209. Run %loadPackages() for help info.'
|
||||
des = 'Macro to load multiple SAS packages at one run, version 20210109. Run %loadPackages() for help info.'
|
||||
parmbuff
|
||||
;
|
||||
%if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
|
||||
@@ -3098,7 +3186,7 @@ parmbuff
|
||||
%put ### This is short help information for the `loadPackageS` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20201209` #;
|
||||
%put # Macro wrapper for the loadPackage macro, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -3182,7 +3270,7 @@ parmbuff
|
||||
hashing_file() function, SAS 9.4M6 */
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20201209. Run %verifyPackage() for help info.'
|
||||
des = 'Macro to verify SAS package with the hash digest, version 20210109. Run %verifyPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -3197,7 +3285,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20201209. Run %
|
||||
%put ### This is short help information for the `verifyPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20201209` #;
|
||||
%put # Macro to verify SAS package with it hash digest, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
@@ -3350,7 +3438,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20201209. Run %
|
||||
*/
|
||||
)/secure
|
||||
/*** HELP END ***/
|
||||
des = 'Macro to preview content of a SAS package, version 20201209. Run %previewPackage() for help info.'
|
||||
des = 'Macro to preview content of a SAS package, version 20210109. Run %previewPackage() for help info.'
|
||||
;
|
||||
%if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
|
||||
%do;
|
||||
@@ -3365,7 +3453,7 @@ des = 'Macro to preview content of a SAS package, version 20201209. Run %preview
|
||||
%put ### This is short help information for the `previewPackage` macro #;
|
||||
%put #-------------------------------------------------------------------------------#;
|
||||
%put # #;
|
||||
%put # Macro to get previwe of a SAS packages, version `20201209` #;
|
||||
%put # Macro to get previwe of a SAS packages, version `20210109` #;
|
||||
%put # #;
|
||||
%put # A SAS package is a zip file containing a group #;
|
||||
%put # of SAS codes (macros, functions, data steps generating #;
|
||||
|
||||
@@ -7,7 +7,7 @@ Currently the following packages are available:
|
||||
---
|
||||
|
||||
- **SQLinDS**\[2.2\], based on Mike Rhoads' article *Use the Full Power of SAS in Your Function-Style Macros*. The package allows to write SQL queries in the data step, e.g.
|
||||
```
|
||||
```sas
|
||||
data class;
|
||||
set %SQL(
|
||||
select age, name, weight, height
|
||||
@@ -18,7 +18,7 @@ data class;
|
||||
WH = weight + height;
|
||||
run;
|
||||
```
|
||||
SHA256 digest for SQLinDS: CE1A266B9030E5E336B45F53DF483F6913FD8AE88A2884CEE88BEEF621FDBD78
|
||||
SHA256 digest for SQLinDS: 3034A0C8AC43683AD55698861DBBDEBDE6FC8567D59ECF2BB5F3389FE6BC8062
|
||||
|
||||
[Documentation for SQLinDS](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/sqlinds.md "Documentation for SQLinDS")
|
||||
|
||||
@@ -32,8 +32,8 @@ SHA256 digest for MacroCore: A23C29529F3CE7D0C8BEE9545C5D22D5B5594907547374A5135
|
||||
|
||||
---
|
||||
|
||||
- **DFA** (Dynamic Function Arrays)\[0.3\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
```
|
||||
- **DFA** (Dynamic Function Arrays)\[0.4\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
|
||||
```sas
|
||||
%createDFArray(ArrDynamic, resizefactor=17);
|
||||
|
||||
data _null_;
|
||||
@@ -59,14 +59,14 @@ data _null_;
|
||||
end;
|
||||
run;
|
||||
```
|
||||
SHA256 digest for DFA: 1FC8D030D576C33F1B5DEB27E17534946209BC148D57A1357CA025ED1E69AEB8
|
||||
SHA256 digest for DFA: E777D4578DFDEB2277D58264BAB5BFDBEAFD4E538D4831CDCBFFB4216D2441C2
|
||||
|
||||
[Documentation for DFA](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/dfa.md "Documentation for DFA")
|
||||
|
||||
---
|
||||
|
||||
- **macroArray**\[0.8\], implementation of an array concept in a macro language, e.g.
|
||||
```
|
||||
```sas
|
||||
%array(ABC[17] (111:127), macarray=Y);
|
||||
|
||||
%macro test();
|
||||
@@ -84,14 +84,14 @@ SHA256 digest for DFA: 1FC8D030D576C33F1B5DEB27E17534946209BC148D57A1357CA025ED1
|
||||
which = 1:H:2
|
||||
);
|
||||
```
|
||||
SHA256 digest for macroArray: AC3AD58AFBBE459616743DC6346330BD8DD33FBA8CDD595423F181B67D0475BC
|
||||
SHA256 digest for macroArray: 42E87B80450B3E1AD462B9B63B41F34C83B7745AA0F98C3CA72AA19F3B1FF10E
|
||||
|
||||
[Documentation for macroArray](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/macroarray.md "Documentation for macroArray")
|
||||
|
||||
---
|
||||
|
||||
- **BasePlus**\[0.991\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
```
|
||||
```sas
|
||||
call arrMissToRight(myArray);
|
||||
call arrFillMiss(17, myArray);
|
||||
call arrFill(42, myArray);
|
||||
@@ -104,7 +104,7 @@ format x bool.;
|
||||
|
||||
%put %getVars(sashelp.class, pattern = ght$, sep = +, varRange = _numeric_);
|
||||
```
|
||||
SHA256 digest for BasePlus: 9EA40F72191D1916189F043315CA519F6E42CEB05C186F7653AE464D21D21CFB
|
||||
SHA256 digest for BasePlus: 28F3DE865C5E3B914FFB7CC2627D8B0975527EEECEE7AFEAD7B335C3FDC1BFD3
|
||||
|
||||
[Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
|
||||
|
||||
@@ -112,6 +112,6 @@ SHA256 digest for BasePlus: 9EA40F72191D1916189F043315CA519F6E42CEB05C186F7653AE
|
||||
|
||||
- **dynMacroArray**\[0.2\], set of macros (wrappers for a hash table) emulating dynamic array in the data step (macro predecessor of DFA)
|
||||
|
||||
SHA256 digest for dynMacroArray: 5E8CCC88CC048A0B564CEE37C6CF4013857D9CFF3FA1B6B9AD6F719D08B30005
|
||||
SHA256 digest for dynMacroArray: 8B0777EA3CF41968C0B029AA57B1F809D21D1BAB1B88A35B0EA5DB3C6DD9E748
|
||||
|
||||
---
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
/* 20210109 */
|
||||
BasePlus: 28F3DE865C5E3B914FFB7CC2627D8B0975527EEECEE7AFEAD7B335C3FDC1BFD3
|
||||
DFA: E777D4578DFDEB2277D58264BAB5BFDBEAFD4E538D4831CDCBFFB4216D2441C2
|
||||
dynMacroArray: 8B0777EA3CF41968C0B029AA57B1F809D21D1BAB1B88A35B0EA5DB3C6DD9E748
|
||||
macroArray: 42E87B80450B3E1AD462B9B63B41F34C83B7745AA0F98C3CA72AA19F3B1FF10E
|
||||
SQLinDS: 3034A0C8AC43683AD55698861DBBDEBDE6FC8567D59ECF2BB5F3389FE6BC8062
|
||||
|
||||
/* 20201229 */
|
||||
DFA: 5B41657A8A3BEAD185B13D072BC54902AB81FEAD32330DA8ABA90CF777D4D76E
|
||||
|
||||
/* 20201207 */
|
||||
macroArray: AC3AD58AFBBE459616743DC6346330BD8DD33FBA8CDD595423F181B67D0475BC
|
||||
BasePlus: 9EA40F72191D1916189F043315CA519F6E42CEB05C186F7653AE464D21D21CFB
|
||||
|
||||
@@ -221,10 +221,10 @@ Package contains:
|
||||
40. functions quicksorthashsddv
|
||||
41. functions quicksortlight
|
||||
|
||||
*SAS package generated by generatePackage, version 20201115*
|
||||
*SAS package generated by generatePackage, version 20210109*
|
||||
|
||||
The SHA256 hash digest for package BasePlus:
|
||||
`9EA40F72191D1916189F043315CA519F6E42CEB05C186F7653AE464D21D21CFB`
|
||||
`28F3DE865C5E3B914FFB7CC2627D8B0975527EEECEE7AFEAD7B335C3FDC1BFD3`
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
|
||||
Binary file not shown.
439
packages/dfa.md
439
packages/dfa.md
@@ -6,6 +6,11 @@
|
||||
* [`%createDHOrdStack()` macro](#createdhordstack-macro)
|
||||
* [`%createDHPrtQueue()` macro](#createdhprtqueue-macro)
|
||||
* [`%createDHStack()` macro](#createdhstack-macro)
|
||||
* [`bit64orPROTOdfa()` proto function](#bit64orprotodfa-proto-function)
|
||||
* [`bit64andPROTOdfa()` proto function](#bit64andprotodfa-proto-function)
|
||||
* [`bit64orDFA()` subroutine](#bit64ordfa-function)
|
||||
* [`bit64andDFA()` subroutine](#bit64anddfa-function)
|
||||
* [`%createDFBitmap()` macro](#createdfbitmap-macro)
|
||||
* [`generateArrays` exec](#createdhprtqueue-exec)
|
||||
* [`generateArrays` clean](#createdhprtqueue-clean)
|
||||
|
||||
@@ -13,14 +18,15 @@
|
||||
|
||||
---
|
||||
|
||||
# The DFA package [ver. 0.3] <a name="dfa-package"></a> ###############################################
|
||||
# The DFA package [ver. 0.4] <a name="dfa-package"></a> ###############################################
|
||||
|
||||
The **DFA** (a.k.a. *Dynamic Function Array*) package implements:
|
||||
- dynamic numeric and character arrays,
|
||||
- dynamic stacks (filo),
|
||||
- dynamic queues (fifo),
|
||||
- dynamic ordered stacks,
|
||||
- priority queues.
|
||||
- priority queues,
|
||||
- bitmap.
|
||||
|
||||
The package provides a set of *macros*,
|
||||
which allows to *generate* `call routines`
|
||||
@@ -32,19 +38,24 @@ See particular macro help for further details.
|
||||
---
|
||||
|
||||
Package contains:
|
||||
1. macro createdfarray
|
||||
2. macro createdharray
|
||||
3. macro createdhfifo
|
||||
4. macro createdhordstack
|
||||
5. macro createdhprtqueue
|
||||
6. macro createdhstack
|
||||
7. exec generatearrays
|
||||
8. clean generatearrays
|
||||
1. macro createdfarray
|
||||
2. macro createdharray
|
||||
3. macro createdhfifo
|
||||
4. macro createdhordstack
|
||||
5. macro createdhprtqueue
|
||||
6. macro createdhstack
|
||||
7. proto bit64andprotodfa
|
||||
8. proto bit64orprotodfa
|
||||
9. functions bit64anddfa
|
||||
10. functions bit64ordfa
|
||||
11. macro createdfbitmap
|
||||
12. exec generatearrays
|
||||
13. clean generatearrays
|
||||
|
||||
*SAS package generated by generatePackage, version 20201115*
|
||||
*SAS package generated by generatePackage, version 20210109*
|
||||
|
||||
The SHA256 hash digest for package BasePlus:
|
||||
`1FC8D030D576C33F1B5DEB27E17534946209BC148D57A1357CA025ED1E69AEB8`
|
||||
`E777D4578DFDEB2277D58264BAB5BFDBEAFD4E538D4831CDCBFFB4216D2441C2`
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
@@ -1089,6 +1100,408 @@ The `value` argument is **outarg**, i.e. can be changed by the function.
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64orPROTOdfa()` proto function: <<< <a name="bit64orprotodfa-proto-function"></a> #######################
|
||||
|
||||
The **bit64orPROTOdfa()** is external *C* function,
|
||||
this is the implementation of the *bitwise OR* operation
|
||||
on doubles. A double is returned.
|
||||
|
||||
**Caution!** For SAS numeric values *only* operations on first 53 bits are valid!
|
||||
|
||||
The function is used **internally** by functions in the *DFA* package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orPROTOdfa(i, j)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `i` - A double numeric argument.
|
||||
|
||||
2. `j` - A double numeric argument.
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64andPROTOdfa()` proto function: <<< <a name="bit64andprotodfa-proto-function"></a> #######################
|
||||
|
||||
The **bit64andPROTOdfa()** is external *C* function,
|
||||
this is the implementation of the *bitwise AND* operation
|
||||
on doubles. A double is returned.
|
||||
|
||||
**Caution!** For SAS numeric values *only* operations on first 53 bits are valid!
|
||||
|
||||
The function is used **internally** by functions in the *DFA* package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64andPROTOdfa(i, j)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `i` - A double numeric argument.
|
||||
|
||||
2. `j` - A double numeric argument.
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64orDFA()` subroutine: <<< <a name="bit64ordfa-function"></a> #######################
|
||||
|
||||
The **bit64orDFA()** function is an alternative to
|
||||
the 32 bit bitwise `BOR()` function working on SAS numerics.
|
||||
Allows to work on *up to* 53 bits of SAS numeric value.
|
||||
|
||||
The `bit64orDFA()` is an *internal* function of the `DFA` package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64orDFA(a, b)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `a` - Argument is a SAS numeric values.
|
||||
|
||||
2. `B` - Argument is a SAS numeric values.
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
options ls = max ps = max;
|
||||
%let M = 53 ; %* 53 is maximum valid value;
|
||||
data _null_;
|
||||
array bitmask [ 0: &M] _temporary_ ;
|
||||
do P = 1 to &M ;
|
||||
bitmask[P] = 2**(P-1) ;
|
||||
put bitmask[P] = binary54. @;
|
||||
put bitmask[P] = best32.;
|
||||
end ;
|
||||
bitmask[0] = bitmask[&M.] ;
|
||||
put bitmask[0] = best32. /;
|
||||
|
||||
a=0;
|
||||
put a = binary54.;
|
||||
do P = 1 to &M ;
|
||||
a = BIT64ORDFA (a, bitmask[P]) ;
|
||||
put a = binary54.;
|
||||
end;
|
||||
put;
|
||||
|
||||
b = 0;
|
||||
put b = binary54./;
|
||||
do P = 1 to &M ;
|
||||
b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
|
||||
put b = best32.;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
## >>> `bit64andDFA()` subroutine: <<< <a name="bit64anddfa-function"></a> #######################
|
||||
|
||||
The **bit64andDFA()** function is an alternative to
|
||||
the 32 bit bitwise `BAND()` function working on SAS numerics.
|
||||
Allows to work on *up to* 53 bits of SAS numeric value.
|
||||
|
||||
The `bit64andDFA()` is an *internal* function of the `DFA` package.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
bit64andDFA(a, b)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `a` - Argument is a SAS numeric values.
|
||||
|
||||
2. `B` - Argument is a SAS numeric values.
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Basic test of `bit64orDFA()` and `bit64andDFA()`
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
options ls = max ps = max;
|
||||
%let M = 53 ; %* 53 is maximum valid value;
|
||||
data _null_;
|
||||
array bitmask [ 0: &M] _temporary_ ;
|
||||
do P = 1 to &M ;
|
||||
bitmask[P] = 2**(P-1) ;
|
||||
put bitmask[P] = binary54. @;
|
||||
put bitmask[P] = best32.;
|
||||
end ;
|
||||
bitmask[0] = bitmask[&M.] ;
|
||||
put bitmask[0] = best32. /;
|
||||
|
||||
a=0;
|
||||
put a = binary54.;
|
||||
do P = 1 to &M ;
|
||||
a = BIT64ORDFA (a, bitmask[P]) ;
|
||||
put a = binary54.;
|
||||
end;
|
||||
put;
|
||||
|
||||
b = 0;
|
||||
put b = binary54./;
|
||||
do P = 1 to &M ;
|
||||
b + (BIT64ANDDFA (a, bitmask[P]) ne .) ;
|
||||
put b = best32.;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
## >>> `%createDFBitmap()` macro: <<< <a name="createdfbitmap-macro"></a> #######################
|
||||
|
||||
The `%createDFBitmap()` macro allows to generate
|
||||
a `dynamic function bitmap` which is a FCMP based
|
||||
approach to create *dynamically* allocated **numeric**
|
||||
bitmnap.
|
||||
|
||||
*Note:* Arrays provided by the macro are *one dimensional* arrays.
|
||||
|
||||
The idea of a SAS bitmap is based on:
|
||||
1. SGF Paper 3101-2019
|
||||
titeled **Re-Mapping A Bitmap** by *Paul M. Dorfman* and *Lessia S. Shajenko*
|
||||
[https://www.sas.com/content/dam/SAS/support/en/sas-global-forum-proceedings/2019/3101-2019.pdf](https://www.sas.com/content/dam/SAS/support/en/sas-global-forum-proceedings/2019/3101-2019.pdf)
|
||||
2. SUGI Paper 8-26
|
||||
titeled **Table Look-Up by Direct Addressing: Key-Indexing -- Bitmapping -- Hashing** by *Paul M. Dorfman*
|
||||
[https://support.sas.com/resources/papers/proceedings/proceedings/sugi26/p008-26.pdf](https://support.sas.com/resources/papers/proceedings/proceedings/sugi26/p008-26.pdf)
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%createDFBitmap(
|
||||
bitmapName
|
||||
<,debug=0>
|
||||
<,outlib=work.DFAfcmp.package>
|
||||
<,type=32>
|
||||
)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `bitmapName` - *Required*, creates a FCMP call subroutine which is also
|
||||
a bitmap name. In the data step it is used in form of
|
||||
a call subroutine, e.g. `call bitmapName("Allocate", 3000)`.
|
||||
Has to satisfy FCMP function naming requirements, but with
|
||||
maximum of 24 characters.
|
||||
|
||||
* `debug=` - *Optional*, the default value is `0`.
|
||||
If set to `1` then it turns on a debugging mode.
|
||||
|
||||
* `outlib=` - *Optional*, the default value is `work.DFAfcmp.package`.
|
||||
It points the default location for new generated dynamic
|
||||
function arrays compiled by FCMP.
|
||||
*Hint!* Keep it as it is.
|
||||
|
||||
* `type=` - *Optional*, the default value is `32`. Sets the type of
|
||||
bitwise operations executed internaly on the bitmap.
|
||||
The only valid values are `32` or `52`,
|
||||
With 32 the `BOR()` and `BAND()` SAS functions are used
|
||||
and with 52 the `bit64orDFA()` and `bit64and DFA()` FCMP
|
||||
functions are used.
|
||||
|
||||
**Created function arguments description**:
|
||||
|
||||
A function generated by the macro is:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
call &bitmapName.(IO, position, value)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
and accepts the following list of arguments and values:
|
||||
|
||||
1. `IO` - is a *character* steering argument, possible
|
||||
values and behaviour they call are the following:
|
||||
- `Check`, `Test`, `T` - to get information if a bit is set to 1 (on) or not,
|
||||
- `On`, `1` - to set a selected bit to 1,
|
||||
- `Off`, `0` - to set a selected bit to 0,
|
||||
- `C`, `Clear` - to reduce a bitmat to a single empty cell,
|
||||
- `A`, `Allocate` - to reserve space for a bitmap and set all bits to 0,
|
||||
- `A0`, `Allocate0` - to reserve space for a bitmap and set all bits to 0,
|
||||
- `A1`, `Allocate1` - to reserve space for a bitmap and set all bits to 1,
|
||||
- `D`, `Dim`, `Dimension` - to returns minimal and maximal index of the bitmap.
|
||||
|
||||
2. `position` - is a *numeric* argument and depends on the `IO` value.
|
||||
Behaves in the following way:
|
||||
- for `On`, `Off`, `1`, `0`/ `Check`, `Test`, `T` it is a bitmap index,
|
||||
- for `C`, `Clear` is ignored,
|
||||
- for `A`, `Allocate` sets the value of the minposition, i.e. the minimal position of the bitmap index,
|
||||
- for `D`, `Dimension` it returns value of the minposition,
|
||||
|
||||
.3 `value` - is a *numeric* argument and depends on the `IO` value.
|
||||
Behaves in the following way:
|
||||
- for `Check`, `Test`, `T` it holds value retrieved from a bitmap on a given position,
|
||||
- for `On`, `Off`, `1`, `0`, `C`, `Clear` is ignored,
|
||||
- for `A`, `Allocate` it sets the value of the maxposition, i.e. maximal position of the array index,
|
||||
- for `D`, `Dimension` it returns value of the maxposition
|
||||
|
||||
The `position` and the `value` arguments are **outargs**, i.e. can be changed by the function.
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Bitmap of type 32:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%createDFBitmap(MyBitmap32,type=32,debug=1);
|
||||
options APPEND=(cmplib = WORK.DFAfcmp) ;
|
||||
|
||||
data Example1;
|
||||
call MyBitmap32("Allocate", -10, 100);
|
||||
L = 0; H = 0;
|
||||
call MyBitmap32("Dim", L, H);
|
||||
put L= H=;
|
||||
|
||||
* populate array with data ;
|
||||
do i = L to H by 2;
|
||||
put i @;
|
||||
call MyBitmap32("1", i, .);
|
||||
end;
|
||||
put;
|
||||
|
||||
* get values from the array ;
|
||||
Value = .;
|
||||
do i = L to H;
|
||||
call MyBitmap32("T", i, Value);
|
||||
put i= Value=;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**EXAMPLE 2.** Bitmap of type 52:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%createDFBitmap(MyBitmap52,type=52,debug=1);
|
||||
options APPEND=(cmplib = WORK.DFAfcmp) ;
|
||||
|
||||
data Example2;
|
||||
call MyBitmap52("Allocate", -10, 100);
|
||||
L = 0; H = 0;
|
||||
call MyBitmap52("Dim", L, H);
|
||||
put L= H=;
|
||||
|
||||
* populate array with data ;
|
||||
do i = L to H by 2;
|
||||
put i @;
|
||||
call MyBitmap52("1", i, .);
|
||||
end;
|
||||
put;
|
||||
|
||||
* get values from the array ;
|
||||
Value = .;
|
||||
do i = L to H;
|
||||
call MyBitmap52("T", i, Value);
|
||||
put i= Value=;
|
||||
end;
|
||||
run;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**EXAMPLE 3.** Execution time test for type 52:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%createDFBitmap(MyBigBitmap52,type=52,debug=0);
|
||||
options FULLSTIMER APPEND=(cmplib = WORK.DFAfcmp) ;
|
||||
|
||||
data Example3;
|
||||
call MyBigBitmap52("Allocate", -10, 2000000001);
|
||||
L = 0; H = 0;
|
||||
call MyBigBitmap52("Dim", L, H);
|
||||
put L= H=;
|
||||
|
||||
* populate bitmap with data ;
|
||||
t = time();
|
||||
do i = L to H by 17;
|
||||
call MyBigBitmap52("1", i, .);
|
||||
x + 1;
|
||||
end;
|
||||
t = time() - t;
|
||||
put "populate:" t= x=;
|
||||
|
||||
* get values from the bitmap ;
|
||||
t = time();
|
||||
Value = .;
|
||||
do i = L to H;
|
||||
call MyBigBitmap52("T", i, Value);
|
||||
x + (-Value);
|
||||
end;
|
||||
t = time() - t;
|
||||
put "search:" t= x=;
|
||||
run;
|
||||
|
||||
%*
|
||||
L=-10 H=2000000001
|
||||
populate:t=55.902999878 x=117647060
|
||||
search:t=654.12900019 x=0
|
||||
NOTE: The data set WORK.EXAMPLE3 has 1 observations and 6 variables.
|
||||
NOTE: DATA statement used (Total process time):
|
||||
real time 11:50.42
|
||||
user cpu time 11:46.40
|
||||
system cpu time 0.45 seconds
|
||||
memory 301791.12k
|
||||
OS Memory 326332.00k
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**EXAMPLE 4.** Execution time test for type 32:
|
||||
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%createDFBitmap(MyBigBitmap32,type=32,debug=0);
|
||||
options FULLSTIMER APPEND=(cmplib = WORK.DFAfcmp) ;
|
||||
|
||||
data Example4;
|
||||
call MyBigBitmap32("Allocate", -10, 2000000001);
|
||||
L = 0; H = 0;
|
||||
call MyBigBitmap32("Dim", L, H);
|
||||
put L= H=;
|
||||
|
||||
* populate bitmap with data ;
|
||||
t = time();
|
||||
do i = L to H by 17;
|
||||
call MyBigBitmap32("1", i, .);
|
||||
x + 1;
|
||||
end;
|
||||
t = time() - t;
|
||||
put "populate:" t= x=;
|
||||
|
||||
* get values from the bitmap ;
|
||||
t = time();
|
||||
Value = .;
|
||||
do i = L to H;
|
||||
call MyBigBitmap32("T", i, Value);
|
||||
x + (-Value);
|
||||
end;
|
||||
t = time() - t;
|
||||
put "populate:" t= x=;
|
||||
run;
|
||||
|
||||
%*
|
||||
L=-10 H=2000000001
|
||||
populate:t=50.417999983 x=117647060
|
||||
populate:t=611.13600016 x=0
|
||||
NOTE: The data set WORK.EXAMPLE4 has 1 observations and 6 variables.
|
||||
NOTE: DATA statement used (Total process time):
|
||||
real time 11:02.07
|
||||
user cpu time 10:59.07
|
||||
system cpu time 1.46 seconds
|
||||
memory 489583.90k
|
||||
OS Memory 513876.00k
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
## >>> `generateArrays` exec: <<< <a name="createdhprtqueue-exec"></a> #######################
|
||||
|
||||
The generateArrays exec file provides a **list of automatically generated examples** of functions
|
||||
@@ -1112,6 +1525,8 @@ The list of provided examples is the following:
|
||||
- `PrtQueueNBC` - Dynamic Hash-based Character Priority Queue with *New on Bottom* (length 256 bytes)
|
||||
- `PrtQueueNTN` - Dynamic Hash-based Numeric Priority Queue with *New on Top*
|
||||
- `PrtQueueNBN` - Dynamic Hash-based Numeric Priority Queue with *New on Bottom*
|
||||
- `Bitmap32` - Dynamic Function Bitmap on 32 bit
|
||||
- `Bitmap52` - Dynamic Function Bitmap on 52 bit
|
||||
|
||||
The `outlib=` option is set to `work.DFAfcmp.package`. The `cmplib=` option is updated automatically.
|
||||
|
||||
|
||||
BIN
packages/dfa.zip
BIN
packages/dfa.zip
Binary file not shown.
Binary file not shown.
@@ -66,10 +66,10 @@ Package contains:
|
||||
Required SAS Components:
|
||||
*Base SAS Software*
|
||||
|
||||
*SAS package generated by generatePackage, version 20201115.*
|
||||
*SAS package generated by generatePackage, version 20210109.*
|
||||
|
||||
The SHA256 hash digest for package macroArray:
|
||||
`AC3AD58AFBBE459616743DC6346330BD8DD33FBA8CDD595423F181B67D0475BC`
|
||||
`42E87B80450B3E1AD462B9B63B41F34C83B7745AA0F98C3CA72AA19F3B1FF10E`
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
|
||||
Binary file not shown.
@@ -46,10 +46,10 @@ Package contains:
|
||||
Required SAS Components:
|
||||
*Base SAS Software*
|
||||
|
||||
*SAS package generated by generatePackage, version 20201115*
|
||||
*SAS package generated by generatePackage, version 20210109*
|
||||
|
||||
The SHA256 hash digest for package SQLinDS:
|
||||
`CE1A266B9030E5E336B45F53DF483F6913FD8AE88A2884CEE88BEEF621FDBD78`
|
||||
`3034A0C8AC43683AD55698861DBBDEBDE6FC8567D59ECF2BB5F3389FE6BC8062`
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
|
||||
Binary file not shown.
Reference in New Issue
Block a user