\documentstyle{article}
\setlength{\topmargin}{-45pt}
\setlength{\oddsidemargin}{0cm}
\setlength{\evensidemargin}{-0cm}
\setlength{\textheight}{24cm}
\setlength{\textwidth}{16cm}

\newcommand{\ind}{\par\hangindent=0.5cm\hangafter=1\noindent}
\newcommand{\indd}{\par\hangindent=1.0cm\hangafter=1\hspace*{0.5cm}}
\newcommand{\idl}{\hspace*{5mm}{\tt IDL>\ }}
\newcommand{\unix}{\hspace*{5mm}{\tt unix\%\ }}
\newcommand{\crmk}{{\bf $<$CR$>$}}
\newcommand{\ssw}{{\tt \$\{SSW\}}}
\newcommand{\norp}{{\tt \$\{NORP\}}}



\begin{document}
\title{Nobeyama Radio Polarimeter (NoRP) \\
Analysis Manual
\\
ver. 0.3
}
\author{T. Yokoyama}
\date{2000-4-11}
\maketitle

%\clearpage
\section{Introduction}

This is a manual for analysis of the data
obtained by Nobeyama Radio Polarimeter (NoRP; Nakajima et al. 1985) 
and Toyokawa Radio Polarimeter (TYKW; Torii et al. 1979; Shibasaki et al. 1979).

For any questions and requests, please send an e-mail to \\
\bigskip
\hspace*{1cm}{\tt nsro-service@solar.nro.nao.ac.jp}

The latest information on NoRP is updated on NSRO Web site.
The URL is \\
\bigskip
\hspace*{1cm} {\tt http://solar.nro.nao.ac.jp/norp/}\\

\bigskip
\noindent
History

\noindent
\hspace*{5mm}
version 0.0 1999.1.12
\hspace*{5mm}
version 0.1 1999.1.13
\hspace*{5mm}
version 0.2 1999.2.19

\section{How to setup}

\medskip
\noindent
(1) Installation of the {\it SolarSoftware}.

Install the SolarSoftware (SSW) with the subpackage 'Radio/NoRH'.
We strongly recommend to install
the SolarSoftware with the sub-package for Yohkoh/SXT and HXT.
If these softwares were not installed, please contact your
system manager.
The primary distribution site for SolarSoftware is:
{\tt http://www.lmsal.com/solarsoft/}
We define the top directory of SSW as \ssw\ and that of NoRP subpackage
as \norp\ (usually {\ssw}{\tt /radio/norh}) in this manual.
The original version of the NoRH software is included
in the distribution CD-ROM.

\medskip
\noindent
(2) Setup of your personal environment

Include the followings in your environment setup file ({\tt \char126/.cshrc}). \
\
{\tt
\hspace*{10mm} setenv SSW {\it SSW-directory} \\
\hspace*{10mm} setenv SSW\_INSTR ``norp'' \\
\hspace*{10mm} source \$\{SSW\}/gen/setup/setup.ssw \\
}
Note that the enviroment variable {\ssw} can be different
(Ask your system manager)\footnote{In NSRO, it is {\tt /sgi1/ssw}}.
In case you analyze many kinds of
data at the same time, define SSW\_INSTR as follows, e.g. \\
{\tt
\hspace*{10mm} setenv SSW\_INSTR ``sxt hxt norp'' \\
}


\section{Where is the Data ?}

\subsection{Calibrated Data in XDR (IDL save) format}

Some already-calibrated NoRP data are put in the NSRO archive.
You can obtain them by anonymous FTP. Before synthesizing
by yourself, try them first.
They are loaded into the IDL session by using the IDL command
{\tt restore}.

\subsection{Raw Data}

Some raw NoRP data 
are put in the NSRO archive.
You can obtain them by anonymous FTP.

\section{Analysis}

\subsection{Start Analysis}

The NoRP IDL procedures described in this section all depend on the
SolarSoftware (SSW). When you start the analysis, start up
the SSW/IDL as follows:

\unix {\bf sswidl \crmk}

\section{Read the Data --- Nobeyama Radio Polarimeter}

There are two kinds of formats for Nobeyama Radio Polarimeter (NoRP).
One is before unifing with Toyokawa Radio Polarimeter and the other
is after that. For older format, the files include only 1,2,4 9 GHz
data.

In order to read the data into IDL session, give the date (JST) as follows: \\
\idl {\bf day='2000-4-8'} \\
\idl {\bf norp\_rd\_dat,day,mvalid,time,fi,fv,freq \crmk} \\
or give the file name as follows: \\
\idl {\bf file='pl921102'} \\
\idl {\bf norp\_rd\_dat,file,mvalid,time,fi,fv,freq \crmk} \\
The frequencies of the loaded data are in the array {\tt freq} \\
\idl {\bf print,freq \crmk} \\
%
In order to read the data in specified duration: \\
\idl {\bf timerange=['1992-11-2 2:00','1992-11-2 4:00'] \crmk} \\
\idl {\bf norp\_rd\_dat,file,mvalid,time,fi,fv,freq,timerange=timerange \crmk} \\
%
In order to read the data of specified frequency, e.g. for 17 GHz, \\
\idl {\bf rdfreq=[0,0,0,0,1,0,0] \crmk} \\
\idl {\bf norp\_rd\_dat,file,mvalid,time,fi,fv,rdfreq=rdfreq \crmk} \\
For 1GHz and 9GHz, \\
\idl {\bf rdfreq=[1,0,0,1,0,0,0] \crmk} \\
\idl {\bf norp\_rd\_dat,file,mvalid,time,fi,fv,rdfreq=rdfreq \crmk} \\
Each element in the array {\tt rdfreq} corresponds to the data of
one frequency  among 1, 2, 3.75, 9.4, 17, and 35 GHz.


\section{Read the Data --- Toyokawa Radio Polarimeter}

The Toyokawa Radio Polarimeter was observing in 4 frequencies,
namely , 2, 4, and 9 GHz.

In order to read the data into IDL session, give the date (JST) as follows: \\
\idl {\bf day='2000-4-8'} \\ 
\idl {\bf tykw\_rd\_dat,day,mvalid,time,fi,fv,freq \crmk} \\
or give the file name as follows: \\
\idl {\bf file='ty921102.01i' \crmk} ; 1GHz I-component \\
\idl {\bf file0pa='ty921102.0pa' \crmk} ; 0PA calibration data\\
\idl {\bf filestt='ty921102.stt' \crmk} ; status data\\
\idl {\bf tykw\_rd\_dat,file,file0pa,filestt,mvalid,time,data \crmk} \\
In order to read the data in specified duration: \\
\idl {\bf timerange='1992-11-2 '+['2:00','4:00'] \crmk} \\
\idl {\bf tykw\_rd\_dat,day,mvalid,time,fi,fv,freq,timerange=timerange \crmk} \\
In order to read the data of specified frequency, e.g. for 9 GHz, \\
\idl {\bf rdfreq=[0,0,0,1] \crmk} \\
\idl {\bf ytkw\_rd\_dat,file,mvalid,time,fi,fv,rdfreq=rdfreq \crmk} \\
For 1GHz and 9GHz, \\
\idl {\bf rdfreq=[1,0,0,1] \crmk} \\
\idl {\bf tykw\_rd\_dat,file,mvalid,time,fi,fv,rdfreq=rdfreq \crmk} \\
Each element in the array {\tt rdfreq} corresponds to the data of
one frequency  among 1, 2, 3.75, and 9.4 GHz. 

\section{Plot}

For plotting, \\
\idl {\bf mfreq=0 \crmk} \\
\idl {\bf norp\_plot,mfreq,file,mvalid,time,fi \crmk} \\
where {\tt mfreq} is the index number of the plotting frequency
in the array {\tt freq}. \\
To overlay another plot \\
\idl {\bf mfreq1=0 \crmk} \\
\idl {\bf norp\_plot,mfreq1,file,mvalid,time,fi,/over \crmk} \\
Or by directly;
\idl {\bf utplot,time(where(mvalid(mfreq,*))),fi(mfreq,where(mvalid(mfreq,*))) \crmk} \\
%

\appendix

\section{NoRP data archive: anonymous FTP}
\label{archive}

The Nobeyama Solar Radio Observatory (NSRO/NAOJ) has prepared
the anonymous FTP server for the NoRP data archive. 
The URL is 

\bigskip
{\tt ftp://nsro-archive.nro.nao.ac.jp/pub/norp}
\bigskip

If you need to transfer a large amount of data ,
please contact

\bigskip
{\tt nsro-service@solar.nro.nao.ac.jp}

We will make and mail a CD-ROM for you.
The network capability in Nobeyama is limited.


\section{Acknowledgement}

We thank the following people.
SolarSoftware is a software package for analysis of Solar
Data on IDL. That is supported under various
NASA contracts (SXT/EIT/MDI/TRACE/YPOP etc.) and is all in
the public domain.
IDL is a product by Research System Inc.
We also thank

\section*{References}

\noindent
Nakajima et al. "The Radiometer and Polarimeters at 80, 35, and 17 GHz
for Solar Observations at Nobeyama", PASJ, 37, 163 (1985) \\
Torii et al. "Full-Automatic Radiopolarimeters for Solar Patrol at
Microwave Frequencies", Proc. of the Res. Inst. of Atmospherics,
Nagoya Univ., 26, 129 (1979) \\
Shibasaki et al. "Solar Radio Data Acquisition and Communication System
(SORDACS) of Toyokawa Observatory",
Proc. of the Res. Inst. of Atmospherics,
Nagoya Univ., 26, 117 (1979) \\


\end{document}
