Tipps & Tricks. Carina Ortseifen Ruprecht-Karls-Universität Heidelberg. Andreas Krebs icasus. Grischa Pfister icasus. Makrosprache

Transkript

1 Tipps & Tricks Carina Ortseifen Ruprecht-Karls-Universität Heidelberg Andreas Krebs icasus Grischa Pfister icasus Makrosprache Eigene Makrofunktionen 1

2 Tipps & Tricks Eigene Makrofunktionen Warum? Erweitern der SAS Makrosprache um Aufrufe anderer BASE-Funktionen Kapselung häufig verwendeter Routinen Makro mit Rückgabewert %Let wert = %Funktion() %If ( %Funktion() ) %Then SASAUTOS (!sasroot/core/sasmacro ) Teile der SAS Makro-Funktionen sind so implementiert %Lowcase %Trim Tipps & Tricks Eigene Makrofunktionen Regeln Makro darf keinen BASE-Code erzeugen nur Rückgabewert Keine Verwendung von Data Step oder Prozeduren Alle BASE-Funktionen stehen zur Verfügung 2

3 Tipps & Tricks Eigene Makrofunktionen Wie funktioniert es? Prinzip der Textersetzung Ergebnis des Makro ist String Makro-Parser setzt String entsprechend ein Syntax: %Macro Name(parameter);... &Rueckgabewert %Mend; Makro_001.sas Tipps & Tricks Eigene Makrofunktionen Beispiele Kapseln von BASE-Funktionen Makro_002.sas Erzeugen eines Timestamp für die Benennung von Files Makro_003.sas Abfragen der Anzahl Observations in einer Tabelle Makro_004.sas Beachten Quoting der Parameter bei Sonderzeichen 3

4 Interaktion mit dem Betriebssytem Systemkommandos aufrufen Systemkommandos aufrufen X '...' Kommando X '...'; Globale Anweisung %SYSEXEC() Open Code CALL SYSTEM(); Routine rc = SYSTEM(); Funktion SYSTASK COMMAND ''; Globale Anweisung FILENAME fileref PIPE '...'; unnamed pipes 4

5 Systemkommandos aufrufen Worauf ist zu achten? synchron / asynchron? Soll aufgerufenes Programm (un)abhängig von SAS laufen? Evtl. Optionen XSYNC und XWAIT beachten! Returncode? Hat z.b. das Anlegen eines Verzeichnisses geklappt? Ausgabe verarbeiten? Z.B. die Ausgabe des DIR Kommandos einlesen Systemkommandos aufrufen X X %SYSEXEC Kommando Globale Anweisung Open Code Optionen XSYNC und XWAIT sind relevant lassen die DOS-Box aufflackern setzten die Macrovariable SYSRC (0: kein Fehler, >0: Fehler) Os_cmds.Source umständliche Verarbeitung des Returncodes brauchen am wenigsten Ressourcen 5

6 Systemkommandos aufrufen CALL SYSTEM() rc = SYSTEM() Routine Funktion Optionen XSYNC und XWAIT sind relevant lassen die DOS-Box aufflackern setzten die Macrovariable SYSRC (0: kein Fehler, >0: Fehler) wirken erst zur Ausführungszeit Os_cmds.Source des Data Steps einfache bedingungsabhängige Ausführung möglich Funktion SYSTEM ermöglicht einfache Verarbeitung des Returncodes Systemkommandos aufrufen SYSTASK COMMAND ''; Globale Anweisung WAITFOR taskname TIMEOUT=seconds; per default asynchron nachträgliche Synchronisierung mit WAITFOR Shell frei wählbar (flackert evtl.) frei wählbarer eindeutiger Taskname Os_cmds.Source frei wählbare Macrovariable für Status 6

7 Systemkommandos aufrufen SYSTASK COMMAND ''; Globale Anweisung WAITFOR taskname TIMEOUT=seconds; Returncode für SYSTASK bzw. WAITFOR: &SYSRC Returncode des aufgerufenen Programms: SYSTASK COMMAND <STATUS=stat-var> ; &stat-var hat erst nach Ablauf/Abbruch des Programms einen Wert Status des Verlaufs des aufgerufenen Programms: SYSTASK LIST taskname; SASLOG: Start Failed, Running, Complete Systemkommandos aufrufen SYSTASK COMMAND ''; Globale Anweisung WAITFOR taskname TIMEOUT=seconds; Funktionsprinzip ähnlich wie MP-CONNECT bei SAS-Prozessen mehr Kontrolle mit MP-CONNECT 7

8 Systemkommandos aufrufen FILENAME fileref PIPE unnamed pipes immer synchron lässt die DOS-Box nicht aufflackern setzt nicht &SYSRC kann STDOUT und STDERR einlesen Os_cmds.Source Systemkommandos aufrufen 8

9 Die Funktion DCREATE() Tipps & Tricks Interaktion mit dem Betriebssystem Die Funktion DCREATE() neu seit Version 9 legt einen neuen Ordner an gibt einen Rückgabewert aus, der anzeigt, ob der Ordner angelegt werden konnte ist eine gute Alternative zum X-Kommando 9

10 Tipps & Tricks Interaktion mit dem Betriebssystem Syntax rc = DCREATE (dirname, path); dirname Name des neuen Ordners (ohne Pfad) path rc Überordner, unter dem der neue Ordner angelegt wird Returncode/Rückgabewert Konnte der Ordner angelegt werden: Name des Ordners Ansonsten: leerer Textstring Tipps & Tricks Interaktion mit dem Betriebssystem Beispiel 1 Anlegen eines Ordners test im Hauptordner von C: Data _null_; rc=dcreate("test","c:\"); Put rc=; Run; Im Log-Fenster erscheint dann: rc=c:\test Wenn der Ordner angelegt wurde. oder (da test schon existiert oder c:\ nicht): rc= 10

11 Tipps & Tricks Interaktion mit dem Betriebssystem Beispiel 2 Anlegen eines Ordners test im Work-Ordner: Data _null_; rc=dcreate("test",pathname("work")); Put rc=; Run; Meldung im Log-Fenster: rc=c:\dokume~1\x16.ad\lokale~1\temp\sas Temporary Files\_TD3356\test Formate Formate automatisieren 11

12 Tipps & Tricks Formate automatisieren Aufgaben von Formaten Anzeige von Texten statt kodierter Werte Klassifizierung von Gruppierungsvariablen Validierung von Daten Umschlüsselung von Variablen Wie werden Formate permanent gespeichert? Wie werden Formate aus Tabellen erzeugt? Tipps & Tricks Formate automatisieren Formate permanent speichern Prozedur Format Proc Format lib=library<.catalog >... Keine Angabe Katalog FORMATS Standard-Suchpfade für Formate Work.Formats Library.Formats SAS Formate Formate_001.sas 12

13 Tipps & Tricks Formate automatisieren Formate in Tabelle schreiben Output Control Data Set Option CNTLOUT SELECT Statement Proc Format cntlout=libref.table; Select <$>Format; Run; Formate_002.sas Tipps & Tricks Formate automatisieren Formate aus Tabelle lesen Input Control Data Set Option CNTLIN Proc Format cntlin=libref.table; Run; i.d.r. mindestens benötigte Variablen FMTNAME Name des Formates LABEL Anzeigetext für Bereich START Anfang des Wertebereiches END Ende des Wertebereiches Formate_003.sas 13

14 Einheiten mit Picture- Formaten Einheiten mit Picture Formaten Beispiele Inch in Zentimeter umwandeln (1 inch = 2,54 cm) Währungsumrechnung (Fremdwährungen in Euro, Tageskurse, historische Kurse) 14

15 Einheiten mit Picture Formaten Was ist ein Picture-Format? spezielles numerisches Format (Type = FORMAT) anwendbar auf numerische Variablen Zeichengerüst, dessen Ziffern mit den Ziffern einer Zahl ersetzt werden Einheiten mit Picture Formaten Was ist ein Picture-Format? digit selectors (zero vs. non zero, max. 16) directives (%a, %H,, hier irrelevant) message characters , 99 cm maximal 40 Zeichen 15

16 Einheiten mit Picture Formaten Beispiel Inch in Zentimeter umwandeln (1 inch = 2,54 cm) picture in2cm (round) low-<0 = ' ,99 cm' (mult=254 prefix='-') 0-high = ' ,99 cm' (mult=254) ; Einheiten mit Picture Formaten Beispiel Inch in Zentimeter umwandeln (1 inch = 2,54 cm) picture in2cm (round) low-<0 = ' ,99 cm' (mult=254 prefix='-') 0-high = ' ,99 cm' (mult=254) ; 16

17 Einheiten mit Picture Formaten Wert Absolutwert MULT=254 ROUND Dezimalen entfernen evtl. führende Nullen PREFIX='-' ,4 9, 995 cm Einheiten mit Picture Formaten Wert Absolutwert MULT=254 ROUND Dezimalen entfernen evtl. führende Nullen PREFIX='-' ,4 9, 995 cm 17

18 Einheiten mit Picture Formaten Wert Absolutwert MULT=254 ROUND Dezimalen entfernen String '12345' PREFIX='-' ,4 9, 995 cm Einheiten mit Picture Formaten Wert Absolutwert MULT=254 ROUND Dezimalen entfernen String '12345' PREFIX='-' ,4 9, 995 cm 18

19 Einheiten mit Picture Formaten Inch2cm.Source Einheiten mit Picture Formaten Beispiel Währungsumrechnung (Fremdwährungen in Euro, aktuelle Kurse, historische Kurse) Data Set Sasuser.Kurs Waehrung Kursdatum Kurs USD , USD , GBP , JPY , SEK , Je Währung und Kursdatum ein Picture Format! 19

20 Einheiten mit Picture Formaten Mit SAS 9 sind Formatnamen bis zu 32 Bytes möglich sprechende Formatnamen für Währungsumrechnung sind möglich Beispiel: währung2eur_yyyymmddp USD2EUR_ P GBP2EUR_ P Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; length fmtname $32 start end $16 label $40 prefix type sexcl eexcl $1 hlo $2; set Exchange.Kurs; 20

21 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; length fmtname $32 start end $16 label $40 prefix type sexcl eexcl $1 hlo $2; set Exchange.Kurs; retain type 'P'; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; length fmtname $32 start end $16 label $40 prefix type sexcl eexcl $1 hlo $2; set Exchange.Kurs; fmtname = trim(waehrung)!! = '2EUR_'!! put(kursdatum,yymmddn8.)!! 'P';... 21

22 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; length fmtname $32 start end $16 label $40 prefix type sexcl eexcl $1 hlo $2; set Exchange.Kurs; mult = 100 / Kurs; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; 22

23 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; 23

24 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; 24

25 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für negative Werte; start = 'LOW'; end = '0'; prefix = '-'; eexcl = 'Y'; hlo = 'RL'; output; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für positive Werte; start = '0'; end = 'HIGH'; prefix = ' '; eexcl = 'N'; hlo = 'RH'; output; 25

26 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für positive Werte; start = '0'; end = 'HIGH'; prefix = ' '; eexcl = 'N'; hlo = 'RH'; output; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für positive Werte; start = '0'; end = 'HIGH'; prefix = ' '; eexcl = 'N'; hlo = 'RH'; output; 26

27 Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für positive Werte; start = '0'; end = 'HIGH'; prefix = ' '; eexcl = 'N'; hlo = 'RH'; output; Einheiten mit Picture Formaten picture USD2EUR_ P (round) LOW - <0 = ' ,99' (mult=72.59 prefix='-') 0 - HIGH = ' ,99' (mult=72.59); data CNTLIN; * Range für positive Werte; start = '0'; end = 'HIGH'; prefix = ' '; eexcl = 'N'; hlo = 'RH'; output; 27

28 Einheiten mit Picture Formaten Fremd2euro.Source Einheiten mit Picture Formaten 28

29 National Language Support (NLS) Tipps & Tricks National Language Support (NLS) Option LOCALE Steuert bestimmte sprachabhängige Grundeinstellungen Papiergröße, Ränder, bestimmte Formate LAND_Sprachversion z.b. DE_DE, EN_US, Formate zur Unterstützung des NLS NLDATE NLDATEMN NLDATE* Locale_Format_001.sas 29

30 Tipps & Tricks National Language Support (NLS) Option DATESTYLE Steuert Reihenfolge bei speziellen Informaten Datum = 01/02/03 DATESTYLE= MDY MYD YMD YDM DMY DYM LOCALE Informate ANYDTDTM Datum & Zeit ANYDTDTE Datum ANYDTTME Zeit Locale_Informat_001.sas Tipps & Tricks National Language Support (NLS) Funktionen NLDATE() und NLDATM() String mit benutzerdefiniertem Datum / Zeitstempel Direktiven / Platzhalter %a, %A Tag kurz, lang %b, %B Monat kurz, lang Locale_Nldate_001.sas 30