ReWiA 2.0 html manual


TLOAD          załadowanie widma z pliku tekstowego

Zapis   TLOAD sht filename format

Parametry

   sht
      typu Sheet,  określa numer  widma do  którego zostaną  wczytane  dane  z
      dysku.

   filename
      typu String,  określa nazwę  pliku tekstowego  z którego  należy wczytać
      widmo.

   format
      typu String,  określa ilość i rodzaj pól tworzonego w pamięci widma oraz
      sposób wczytywania danych z pliku tekstowego (a więc jego format)

   Komenda TLOAD  traktuje plik  tekstowy jako ciąg linii zakończonych znakiem
końca linii.  Analizowanych jest  tylko pierwszych  256 znaków w każdej linii.
Parametr format  składa się  z szeregu opcji oznaczonych literami (duże i małe
litery  są   rozróżniane)  i  przedzielanych  średnikami.  Format  opcji  jest
następujący :  litera oznaczająca  typ opcji,  ewentualne parametry numeryczne
opcji przedzielane  dwukropkami, na  końcu średnik.  Listę akceptowanych opcji
podano poniżej  (spacje wstawiono  dla przejrzystości,  przy podawaniu formatu
należy je pominąć) :

S line ;       pominięcie początkowych line linii w pliku tekstowym. Domyślnie
               (gdy nie ma tej opcji w parametrze format) line=0.

M line ;       maksymalna ilość wczytanych punktów. Domyślnie 9999999.

T size ;       rozmiar tabulatora  w znakach.  Gdy size=0  tabulatory  nie  są
               przeliczane na spacje. Domyślnie size=8.

A type ;       rodzaj kodowania. Domyślnie 0 - ASCII. Wartość 1 oznacza EBCDIC

I mode ;       sposób reakcji  na błędy  formatu w linii. 0 - gdy błąd formatu
               podstaw wartość  0 lub  pusty tekst,  1 - pomiń całą linię, 2 -
               zgłoś błąd.

R recsize ;    określa ile  bajtów ma 1 rekord danych (linia). W przypadku gdy
               recsize różne  jest  od  zera  nie  trzeba  w  pliku  źrodłowym
               umieszczac  znaków   nowej  linii   (CR  +  LF).  Przydatne  do
               wczytywania nagłówków  widm IUE  (recsize=72, EBCDIC) oraz FITS
               (recsize=80, ASCII)

X fdtype pos   pole współrzędnych  X, będzie miało typ fdtype, a jako wartości
               będą podstawiane  n-te wyrażenia  w liniach  (n=pos).  Wskaźnik
               XPTR będzie ustawiony na to pole.
Y fdtype pos   pole współrzędnych  Y, będzie miało typ fdtype, a jako wartości
               będą podstawiane  n-te wyrażenia  w liniach  (n=pos).  Wskaźnik
               YPTR będzie ustawiony na to pole.

Z fdtype pos   pole współrzędnych  Z, będzie miało typ fdtype, a jako wartości
               będą podstawiane  n-te wyrażenia  w liniach  (n=pos).  Wskaźnik
               ZPTR będzie ustawiony na to pole.

E fdtype pos   pole współrzędnych  E, będzie miało typ fdtype, a jako wartości
               będą podstawiane  n-te wyrażenia  w liniach  (n=pos).  Wskaźnik
               EPTR będzie ustawiony na to pole.

F fdtype pos   dowolne pole,  będzie miało  typ fdtype,  a jako  wartości będą
               podstawiane n-te wyrażenia w liniach (n=pos).

x fdtype col1 col2      pole współrzędnych  X, będzie miało typ fdtype, a jako
               wartości będą  podstawiane wyrażenia  zawarte pomiędzy  col1  i
               col2 znakiem w linii (po ewentualnym przeliczeniu tabulatorów).
               Wskaźnik XPTR będzie ustawiony na to pole.

y fdtype col1 col2      pole współrzędnych  Y, będzie miało typ fdtype, a jako
               wartości będą  podstawiane wyrażenia  zawarte pomiędzy  col1  i
               col2 znakiem w linii (po ewentualnym przeliczeniu tabulatorów).
               Wskaźnik YPTR będzie ustawiony na to pole.

z fdtype col1 col2      pole współrzędnych  Z, będzie miało typ fdtype, a jako
               wartości będą  podstawiane wyrażenia  zawarte pomiędzy  col1  i
               col2 znakiem w linii (po ewentualnym przeliczeniu tabulatorów).
               Wskaźnik ZPTR będzie ustawiony na to pole.

e fdtype col1 col2      pole współrzędnych  E, będzie miało typ fdtype, a jako
               wartości będą  podstawiane wyrażenia  zawarte pomiędzy  col1  i
               col2 znakiem w linii (po ewentualnym przeliczeniu tabulatorów).
               Wskaźnik EPTR będzie ustawiony na to pole.

f fdtype col1 col2      dowolne pole, będzie miało typ fdtype, a jako wartości
               będą podstawiane wyrażenia zawarte pomiędzy col1 i col2 znakiem
               w linii (po ewentualnym przeliczeniu tabulatorów).

Przykłady

   - wczytanie pliku  tekstowego zawierającego  same igreki  (utworzone będzie
     widmo o  1 polu  typu 6,  wskaźnik YPTR będzie ustawiony na to pole, dane
     będą wczytywane z pierwszego wyrazu w każdej linii w pliku źródłowym) :

        TLOAD 0 "DATA.TXT" "Y6:0;"      

   - wczytanie danych  z pliku  tekstowego z danymi numerycznymi w 2 kolumnach
     (po wczytaniu  komendą należy  komendą PTRS  ustawić prawidłowe  wartości
     wskaźników XPTR i YPTR) :

        TLOAD * "DATAFILE.TXT" "F7:0;F7:1;"

   - wczytanie danych  z pliku  tekstowego z danymi numerycznymi w 3 kolumnach
     (po wczytaniu  komendą należy  komendą PTRS  ustawić prawidłowe  wartości
     wskaźników XPTR i YPTR) :

        TLOAD * "DATAFILE.TXT" "F7:0;F7:1;F7:2;"

   - wczytanie co najwyżej 100 punktów z pliku tekstowego zawierającego iksy i
     igreki (utworzone  będzie widmo  o 2  polach typu 6, wskaźnik XPTR będzie
     ustawiony na  pole 0,  wskaźnik YPTR  będzie ustawiony  na pole 1, X będą
     wczytywane z  pierwszego a  Y z  drugiego wyrazu  w każdej  linii w pliku
     źródłowym)

        TLOAD 0 "DATA.TXT" "M100;X6:0;Y6:1;"    

   - wczytanie  danych  z  pliku  tekstowego  z  danymi  w  3  kolumnach,  ale
     wczytujemy tylko kolumnę 1 i 3 :

        TLOAD * "DATAFILE.TXT" "F7:0;F7:2;"

   - wczytanie pliku tekstowego o pięciu polach. Pierwsze (typu INT*2) od 3 do
     5 znaku,  drugie (STRING*1)  tylko 6  znak, trzecie (typu STRING*8) 10 do
     16, czwarte  (typ REAL*8)  20 do 30 znak i piąte (typ STRING*16) 40 do 45
     znak w  linii. Wskaźniki  będą ustawione  następująco :  XPTR=-1, YPTR=3,
     ZPTR=-1, EPTR=-1

        TLOAD 0 "F.TXT" "f3:3:5;f8:6:6;f11:10:16;y7:20:30;f12:40:45;"