This page was created by the IDL library routine
mk_html_help. For more information on
this routine, refer to the IDL Online Help Navigator
or type:
? mk_html_help
at the IDL command line prompt.
Last modified: Thu Jan 15 15:43:46 1998.
NAME:
ANIM_NRH
PURPOSE:
Cette procedure visualise les images suceesives contenues dans un
fichier NRH 2D
CATEGORY:
WIDGET
CALLING SEQUENCE:
ANIM_NRH, GROUP= group
INPUTS:
KEYWORD PARAMETERS:
GROUP Identification du widget appelant
OUTPUTS:
COMMON BLOCKS:
FICRH, str_fic structure definissant le fichier traite 9voit RH_2D)
DATA_NRH2, Donnee, header
VISU_2D, str_visu structure definissant les conditions de
visualisation (voir RH_2D)
REGION str_reg structure definissant la region (voir RH_2D)
PROCEDURE:
Cette procedure recherche dans un fichier FITS NRH-2D l'image
correspondant a l'heure de debut et affiche les images successives
en tenant compte de l'increment.
Le retour en arriere s'effectue par le WIDGET: '-'
Le WIDGET: '+' redonne la marche avant
'POSE' arrete le defilement. 'CONTINUE' contnue la ou on etait
'START' recommence au debut
EXAMPLE:
MODIFICATION HISTORY:
Ecrit par:J Bonmartin le 08/12/97
(See visu_im/anim_nrh.pro)
NAME:
CW_HEADER
PURPOSE:
Cette procedure visualise le contenu du HEADER d'un fichier FITS
du NRH
CATEGORY:
COMPOUND_WIDGET
CALLING SEQUENCE:
CW_HEADER, GROUP=group
COMMON BLOCKS:
COMMON FICRH, str_fic structure definissant le fichier voir RH_2D
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 19/12/97
(See util/cw_header.pro)
NAME:
CW_INFONRH
PURPOSE:
Cette procedure affiche les caracteristiques principales du
fichier lu
CATEGORY:
COMPOUND WIDGET
CALLING SEQUENCE:
ID = CW_INFONRH, parent, header
INPUTS:
PARENT Identifieur du widget appelant
HEADER header FITS du fichier lu
OPTIONAL INPUTS:
Parm2: Describe optional inputs here. If you don't have any, just
delete this section.
KEYWORD PARAMETERS:
XSIZE dimension du widget (voir WIDGET_TEXT)
YSIZE dimension du widget (voir WIDGET_TEXT)
INFO remise a jour de l'affichage
EXAMPLE:
Im = mrdfits('file', 1, Header)
ID = CW_INFONRH(parent, Header)
Lecture d'un fichier au format NRH et affichage des caracteristiques
ID = CW_INFONRH( ID, Header, /INFO)
Remet a jour l'affichage apres lecture d'un autre fichier
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 03/11/97
(See util/cw_infonrh.pro)
NAME: CW_NRHFILE PURPOSE: Ce compound widget selectionne les fichiers FITS du NRH CATEGORY: COMPOUND WIDGET CALLING SEQUENCE: File = CW_NRHFILE() INPUTS: KEYWORD PARAMETERS: GROUP ID du widget appelant OUTPUTS: FILE chemin et nom du fichier selectionne OPTIONAL OUTPUTS: La structure contient au retour les parametres definis pour le filtrage des fichiers et le nom du fichier selectionne (avec le chemin) COMMON BLOCKS: FICRH structure contenant les parametres de filtre des fichiers et le nom du fichier selectionne (str.file) Description de la structure dans RH_2D.PRO INFO2D structure contenant les parametres de temps(str_inf2d), voir RH_2d DATA structure contenant les donnees et le Header PROCEDURE: Les noms des fichiers traites correspondent a la definition suivante nrhR_ffff_cpi_yyyymmjj_hhmnss:ms_cepgi.fts nrh nancay Radioheliographe R reseau:e: Est-ouest, n: Nord_sud, 2: 2 dimensions ffff frequence en 0.1Mhz c coordonnees: i instrumentales, h heliographiques pi laisse libre a l'utilisateur, proposition: p interpolation (0 a 9)ou autre information i indice libre (0 a 9) 2**i points yyyymmjj date hhmmss heure ms millisecondes e etat: c comprime, f decomprime (full) cette procedure utilise PICKFILE EXAMPLE: FILE = CW_NRHFILE(GROUP= id) MODIFICATION HISTORY: Ecrit par: J Bonmartin le 21/10/97
(See util/cw_nrhfile.pro)
NAME:
CW_RDNRH2
PURPOSE:
Cette procedure lit les donnees d'un fichier NRH 2D FITS dont le
nom est donnee dans STR_FIC.FILE
CATEGORY:
COMPOUND WIDGET
CALLING SEQUENCE:
PRO CW_RDNRH2,GROUP=group
INPUTS:
Parm1: Describe the positional input parameters here. Note again
that positional parameters are shown with Initial Caps.
KEYWORD PARAMETERS:
GROUP Identification du widget appelant
OUTPUTS:
Les DONNEES et le HEADER correspondant sont disponibles dans
DONNEE et HEADER definis dans le COMMON DATA
COMMON BLOCKS:
FICRH, str_fic defini le fichier a lire
DATA_NRH2, Donnee, Header; contient les DONNEES et le HEADER
PROCEDURE:
Les WIDGETS:
BEGIN TIME et IMAGE NUMBER permettent de definir l'heure
de debut et le nombre d'images a lire
EXAMPLE:
CW_RDNRH2, GROUP= event.top
MODIFICATION HISTORY:
Ecrit par:J Bonmartin le 08/12/97
(See util/cw_rdnrh2.pro)
NAME:
CW_REGION
PURPOSE:
Compound WIDGET pour la selection d'une region d'une image
visualisee
La commande 'SELECT' selectionne une region
La commande 'RESET' redonne les dimensions de l'image
Les limites de la region sont affichees
CATEGORY:
COMPOUN WIDGET
CALLING SEQUENCE:
Result = CW_REGION(parent, Image, Dim, Str_lim)
INPUTS:
Parent identification du widget parent
Image image visualisee
Dim nombre de pixels de l'image visualisee
Str_lim structure contenant les limites actuelles , voir RH.2D
KEYWORD PARAMETERS:
OUTPUTS:
Result: identification du widget
Apres un appel a 'SELECT' ou 'RESET', on a:
Uvalue = 'REGION'
les coordonnees de la region selectionne dans la structure
de retour EVENT :
{id:parent, Top:event.top, Handler:0L, XD:xd, XF:xf, YD:yd, YF:yf}
X, Y de debut et de fin de la region. Ces valeurs sont exprimees en
coordonnees de pixels ramenes aux coordonnees de l'image, meme si celle-ci
a ete visualisee sur DIM pixels
COMMON BLOCKS:
IDENT_REG,cursor,reset,textx,texty,state
RESTRICTIONS:
On ne peut pas selectionne une region sur une imge provenant d'une
selection precedente. L'image doit correspondre au tableau IMAGE
EXAMPLE:
Imag = INDGEN(64,64)
ID = CW_REGION( Parent, Imag, 512)
La commande 'SELECT' permet la selection d'une region dans l'image
de 64*64 pixels qui a ete precedemment visualisee sur 512*512 pixels
La commande 'RESET reinitialise les limites de la region a celles du tableau
soit X= 0,63, Y= 0,63
MODIFICATION HISTORY:
(See util/cw_region.pro)
NAME:
CW_SELREG
PURPOSE:
COUMPOUND WIDGET de selection d'une region
CATEGORY:
COMPOUND WIDGET
CALLING SEQUENCE:
CW_SELREG, File, Dim
INPUTS:
File Nom du fichier
Dim Nombre de pixels de visualisation
OUTPUTS:
STR_LIM contient les valeurs selectionnee
COMMON BLOCKS
COMMON LIMIT contient la structure STR_LIM, voir RH_2D
PROCEDURE:
CE COMPOUND WIDGET utilise cw_region pour definir les coordonnees
d'une region
Il visualise en premier l'image puis permet la selection de la region
EXAMPLE:
CW_SELREG,im,str_temps.hd,256
remet a jour la structure str_reg
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 20/11/97
(See util/cw_selreg.pro)
Cette routine permet de connaitre les ellipses que l'on peut determiner avec 3 distances consecutives du tableau d APPEL: d: tableau des distances calculées par trv_dist gra: tableau des 8 petits axes grb: tableau des 8 grands axes tet: tableau des angles d'inclinaisons des ellipses
(See position/det_ellip.pro)
NAME: DISPLAY_IMNRH PURPOSE: Cette procedure affiche une image correspondant a la lecture d'un fichier 2D du NRH CATEGORY: Visualisation CALLING SEQUENCE: DISPLAY_IMNRH, Donnee, Header, str_visu INPUTS: DONNEE structure resultant de la lecture du fichier FITS du NRH par MRDFITS HEADER header du fichier FITS STR_VISU structure definnissant les conditions de visualisation voir(RH_2D) KEYWORD PARAMETERS: DIM dimension de la fenetre en pixels (256 par defaut) POLAR Traitement de l'image poalar (intensite par defaut) OUTPUTS: PROCEDURE: Cette procedure visualise une image 2D du NRH. L'indice, le parametre de STOKES i ou V sont definis dans STR_VISU L'image est ramenee sur 256*256 pixels L'heure est inscrite sur l'image EXAMPLE: FOR IND=0, NP THEN BEGIN DISPLAY_IMNRH, Donnee(ind), Header, str_visu end Visualise les NP premieres images contenues dans le tableau DONNEE precedamment lu par MRDFITS MODIFICATION HISTORY: Ecrit par: J Bonmartin le 08/12/97
(See visu_im/display_imnrh.pro)
NAME:
DISP_GRIMAGE
PURPOSE:
Cette procedure affiche une image dans une fenetre a une position
donnee, colonnes lignes
CATEGORY:
VISUALISATION NRH
CALLING SEQUENCE:
DISP_GRIMAGE, Data, Header,str, hr, stokes
INPUTS:
DATA Tableau contenant l'image
HEADER Entete resultant d'une lecture FITS
STR Structure definie dans GR_IMAGES.PRO
HR Heure de l'image tracee
STOKES Parametre de STOKES visualise 0: Intensite, 1: Parametre V
OUTPUTS:
Au retour STR.CRLI et STR.CRCO sont modifie pour pointe sur la
prochaine zone d'image
PROCEDURE:
You can describe the foobar superfloatation method being used here.
You might not need this section for your routine.
EXAMPLE:
i=MRDFITS('file',1,Header)
ind = 10
HR = msh(i(ind).time)
DISP_GRIMAGE(i(ind).stokesi, Header, Hr, 0)
Visualise la 10ieme image en intensite provenantdu
fichier 'file'
DISP_GRIMAGE(I(ind).stokesv, Header, HR, 1)
Visualise a la position suivante l'image correspondant
au parametre V
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 07/11/97
(See visu_im/disp_grimage.pro)
NAME: ECH_RS PURPOSE: Cette procedure genere une echelle en RAYONS SOLAIRES a partir des coordonnees de debut et de fin (en rayons solaires) CATEGORY: RADIO, ECHELLES CALLING SEQUENCE: ECH_RS, deb, fin, nbp, tab INPUTS: DEB coordonnee du premier point (rayons solaires) FIN coordonnee du dernier point (rayon solaire) NBP nombre de points OUTPUTS: TAB tableau de coordonnees en rayons solaires EXAMPLE: I1, I2, les indices des points d'une image dont le centre est a l'indice C et le Rayon P1 = IND_RS (I1, C, R) P2 = IND_RS (I2, C, R) ECH_RS, P1, P2, 100, AXE donne un tableau AXE de 100 valeurs contenant les coordonnees de 100 points MODIFICATION HISTORY: Ecrit par: J Bonmartin le 21/10/97 le 14/11/97 increment en pixels remplace par le rayon solaire
(See util/ind_rs.pro)
NAME: EXTRACT_CENTRES PURPOSE: Cette procedure recherche et extrait d'un image 2D, un ou plusieurs centre (volume gaussien) CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: EXTRACT_CENTRES, Tab, Tgauss INPUTS: Tab: Tableau contenant l'image KEYWORD PARAMETERS: FACT: facteur d'interpolation lineaire de l'image (defaut = 2) NBMAX: Nombre maximum de volumes gaussiens à extraire de l'image (defaut = 1) SEUIL: critere de mi-hauteur pour la recherche des 8 distances (defaut=2) NIVEAU: niveau de recherche exprime en % de la valeur maximum de l'image (defaut = 0.8 soit 80% du maximum) OUTPUTS: Tgauss: tableau de structures contenant la description des volumes gaussien extraits de l'image EXAMPLE: MODIFICATION HISTORY: Ecrit par: C Renie
(See position/extract_centres.pro)
Cette procédure recherche les positions contenues dans une image. Chaque position est caractérisée par les coordonnées et la valeur du maximum et par les paramètres de l'ellipse modelisant au mieux la position. APPEL: tab: tableau a deux dimensions contenant l'image facteur: degre d'interpolation de l'image d'origine nbmax: nombre maxi de gaussiennes a chercher seuil: critere de recherche des 8 distances tgauss: tableau de structures décrivant les sources trouvées
(See position/extract_posi.pro)
NAME: GR_IMAGES PURPOSE: WIDGET pour la visualisation de plusieurs images dans la meme fenetre CATEGORY: WIDGET CALLING SEQUENCE: GR_IMAGES, GROUP = group INPUTS: OPTIONAL INPUTS: GROUP Identifieur du widget appelant COMMON BLOCKS: FICHR, str_fic structure definie dans rh_2d.pro selection de fichiers IMAGES_GR, str_imgr li:3, nombre de lignes de la fenetre co:6, nombre de colonnes de la fenetre dim:128, dimension d'une image crli:0, ligne courante crco:0, colonne courante crwin:-1, fenetre courante tsel:' ', heure de l'image inc: increment d'indice stk:0 Parametre de STOKES 0: I, 1: V DATA_NRH2,Donnees, Header Donnees et Header lu PROCEDURE: Cette procedure permet de visualiser des images dans une meme fenetre et de les sortir dans un fichier PS. Les fichiers d'origine et la disposition sont libres. A chaque nouvelle image la position dans la ligne est incrementee. En fin de ligne la colonne est incrementee. L'utilisateur peut intervenir sur la position de l'image en modifiant les indices de lignes et de colonnes EXAMPLE: GR_IMAGES ou GR_IMAGES,GROUP= id MODIFICATION HISTORY: Ecrit par: J Bonmartin le 07/11/97
(See visu_im/gr_images.pro)
NAME:
IMAGE_2DNRH
PURPOSE:
Procedure de trace des images 2D du Radioheliographe (NRH), provenant
d'un fichier en format FITS:
Visualisation des images
Coupes
Utilisee par le widget VISU_2D
CATEGORY:
Visualisation
CALLING SEQUENCE:
IMAGE_2DNRH, Image, Header, Str_lim, Str_Visu, Forme
INPUTS:
IMAGE: Tableau des images 2 dimensions a visualiser, resultant de
la lecture des donnees au format FITS, tables binaires
HEADER: Header resultant de la du fichier FITS
STR_LIM Structure limites de traitement voir RH_2d
STR_VISU: Structure liee a VISU_2D, voir RH_2d.pro pour
la description
FORME: Forme du trace
'I' images bitmap
'C' contours
'X' coupes utilisant la fonction IDL PROFILES
'Q' coupe utilisant la fonction IDL PROFILE
et trace de la coupe
EXAMPLE:
Data = mrdfits('file', 1, Header)
Initialiser les valeurs contenues dans STR_VISU
Visualisation d'une image en bitmap
IMAGE_2DNRH, Data, Header, Str_visu, 'I'
Trace des contours
IMAGE_2DNRH, Data, Header, Str_visu, 'C'
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 20/10/97
(See visu_im/image_2dnrh.pro)
NAME: IND_RS PURPOSE: Cette fonction donne la coordonnee d'un pixel en RAYON SOLAIRE, a partir de l'indice du pixel, l'indice du centre le l'image, la dimension du rayon solaire en pixels CATEGORY: RADIO CALLING SEQUENCE: RS=IND_RS(ind, pcentre, rayon) INPUTS: IND Indice du pixel Pcentre Indice du centre de l'image Rayon Nombre de pixels representant le rayon solaire OUTPUTS: RS Coordonnee en rayon solaire EXAMPLE: RS = IND_RS(15, 32, 16) Rs coordonne en rayon solaire du 16ieme pixel d'une image de 64 pixels dont le centre est sur le 32ieme point, l'image representant 4 rayons solaires MODIFICATION HISTORY: Ecrit par: J Bonmartin le 21/10/97
(See util/ind_rs.pro)
Cette procédure remplie un tableu de structures de type position a partir d'un fichier de positions APPEL: fichposi: fichier dans lequel sont syockees les positions nbcentre: nombre de centres contenus dans le fichier nbposi: nombre de positions dans le fichier tabposi: tableau de structures de type position
(See position/mkstruct_posi.pro)
NAME: MSH PURPOSE: Transformation de l'heure en MS en chaine HH:MN:SS:milsec CATEGORY: CONVERSION CALLING SEQUENCE: SH = msh (temps) INPUTS: TEMPS temps en millisecondes. OUTPUTS: SH chaine contenant l'heure : HH:MN:SS:milsec EXAMPLE: PRINT, MSH(380200) imprime l'heure MODIFICATION HISTORY: Ecrit par:J Bonmartin a partir MSH$, seul changement de l'appel
(See util/msh.pro)
NAME: OPLOT_CIRCLE PURPOSE: Trace d'un cercle sur une image aux coordonnees 0,0 CATEGORY: TRACE CALLING SEQUENCE: oplot_circle, radius INPUTS: RADIUS Rayon du cercle EXAMPLE: OPLOT_CIRCLE, 1. trace un cercle representant le soleil optique sur une image representee en coordonnees heliographiques Cette routine est equivalente a TVCIRCLE de IDLASTRO, mais ne deborde pas du cadre pour les traces de contours Elle ne peut etre utilisee a la suite de TV ou TVSCL, car le cercle est centre sur les coordonnees O,O, utiliser alors TVCIRCLE MODIFICATION HISTORY: Ecrit par: J Bonmartin
(See util/oplot_circle.pro)
NAME: OPTIC_CIRC PURPOSE: Cette procedure visualise une image et demande de definir le cercle optique en cliquant 3 points (CIR_3PNT) CATEGORY: Visualisation CALLING SEQUENCE: OPTIC_CIRC,Image,Xcen, Ycen, Ray INPUTS: Image Image a visualiser (2 dimensions) OUTPUTS: Xcen coordonnee X du centre du soleil optique Ycen coordonnee Y du centre du soleil optique Ray rayon du soleil optique EXAMPLE: MODIFICATION HISTORY: Ecrit par: J Bonmartin le 25/11/97
(See util/optic_circ.pro)
NAME: PLOT_CENTRES PURPOSE: Cette procedure affiche tous les centres trouves lors d'une recherche de positions. Les centres sont classes par position. CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: PLOT_CENTRES, Tabposi, win INPUTS: Tabposi: Tableau de structures contenant les positions win: Numéro de la fenetre KEYWORD PARAMETERS: OUTPUTS: EXAMPLE: MODIFICATION HISTORY: Ecrit par: C Renie
(See position/plot_centres.pro)
NAME: PLOT_MAXPOS PURPOSE: Cette procedure affiche l'image au moment de sa position maximum + toutes les positions trouvees sous forme de contour CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: PLOT_MAXPOS, Tabpos, fichier, id_win INPUTS: Tabpos: Tableau de structures contenant les positions fichier: fichier images 2d id_win: numero de la fenetre KEYWORD PARAMETERS: FACT: facteur de multiplication de l'image (defaut = 1) EXAMPLE: MODIFICATION HISTORY: Ecrit par: C Renie
(See position/plot_history.pro)
NAME: PLOT_MAXPOS PURPOSE: Cette procedure affiche l'image au moment de sa position maximum + toutes les positions trouvees sous forme de contour CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: PLOT_MAXPOS, Tabpos, fichier, id_win INPUTS: Tabpos: Tableau de structures contenant les positions fichier: fichier images 2d id_win: numero de la fenetre KEYWORD PARAMETERS: FACT: facteur de multiplication de l'image (defaut = 1) EXAMPLE: MODIFICATION HISTORY: Ecrit par: C Renie
(See position/plot_maxpos.pro)
NAME: PLOT_POSVSTIME PURPOSE: Cette procedure affiche les parametres en fonction du temps pour une position donnee. CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: PLOT_POSVSTIME, Tabposi, Num, Selection INPUTS: Tabposi: Tableau de structures contenant les positions Num: Numéro de la position a afficher Selection: tableau binaire contenant les types de plots KEYWORD PARAMETERS: OUTPUTS: EXAMPLE: MODIFICATION HISTORY: Ecrit par: C Renie
(See position/plot_posvstime.pro)
NAME: RD_SOHO PURPOSE: Lecture des donnees SOHO au format FITS CATEGORY: Input, Output CALLING SEQUENCE: RD_SOHO,File, Image, Xcen, Ycen, Ray, HEADER = header INPUTS: File chemin et nom du fichier a lire KEYWORD PARAMETERS: OUTPUTS: Image tableau d'image Xcen coordonnee du centre de l'image en pixel Ycen coordonnee du centre de l'image en pixel Ray dimension du rayon en pixel OPTIONAL OUTPUTS: HEADER header du fichier FITS PROCEDURE: Cette procedure lit l'image contenue dans un fichier FITS SOHO Les mots cles CRPIX1, CRPIX2, SOLAR_R doivent exister Elle est notamen utilisee par SUP_NRH pour la superposition des donnees NRH et SOHO EXAMPLE: MODIFICATION HISTORY: Ecrit par: J Bonmartin le 24/11/97
(See util/rd_soho.pro)
NAME:
REGION_EVENT
PURPOSE:
Gestion des evenements de CW_REGION
CATEGORY:
WIDGET
CALLING SEQUENCE:
Result = REION_EVENT, event
OUTPUTS:
Au retour la fonction fournit la structure
result:{id:parent, Top:event.top, Handler:0L,$
XD:xd, XF:xf, YD:yd, YF:yf}
X, Y coordonnees de la region selectionnee
UVALUE = 'REGION'
COMMON BLOCKS:
IDENT_REG:
cursor identification du widget 'CURSOR'
reset identification du widget 'RESET'
textx identification du widget X:...
texty identification du widget Y:
state structure
MODIFICATION HISTORY:
(See util/cw_region.pro)
NAME:
RH_2D
PURPOSE:
Cette procedure cree les WIDGETS de traitement des donnees 2D du NRH
CATEGORY:
WIDGET
CALLING SEQUENCE:
RH_2D
INPUTS:
COMMON BLOCKS:
SELECTION DE FICHIERS
COMMON FICRH, STR_FIC= {STR_FIC,
rep: ' ', Repertoire (repertoire courant par defaut)
file: ' ', Nom du fichier
Filtre:'*.* ' Filtre de selection
Freq:'*'
Date:'*;'
HR:'*'}
INFORMATIONS SUR LE FICHIER
COMMON INFO2D, STR_INF2D = {STR_INF2D,
Nim: 0, Nombre de lignes dans le fichier
Npx: 0, Nombre de pixels en X sur l'image
Npy: 0, Nombre de points en Y sur l'image
Tscan: 0, Duree d'integation
Hd: ' ', Heure de debut(chaine ASCII)
Hf: ' ', Heure de fin(chaine ASCII)
Polar:0} 0 si Stokes I, 1 si Stokes I+V
LIMITES DE TRAITEMENT
COMMON LIMIT, STR_LIM = {STR_LIM,
Hd:'' heure de debut de traitement
Hf:'' heure de fin de traitement
XD: 0, Limite inferieure en X
XF: 0, Limite superieure en X
YD: 0, Limite inferieure en Y
YF: 0} Limite superieure en Y
PARAMETRES DE VISUALISATION D IMAGES
COMMON VISU_2D, STR_VISU= {STR_VISU,
Inten : 1, traitement du parametre I si = 1
Polar :0, traitement du parametre V si = 1
Coord:'H', transformation de coordonnee si fichier I et
str_visu.coord= 'H'
Print:0, Sortie PS si = 1
ind:0, Indice de l'image a traiter
dim: 256, Nombre de pixels de l'image visualisee
inc:1, Increment d'image pour le balayage du fichier
cont:5, Nombre de contours du trace CONTOUR
pcent:90, % du max de l'image pour le contour maximum
mcent:10} % du max de l'image pour le contour minimum
PARAMETRES POUR DONNEES EXTERIEURES
COMMON SUPER_INSTR STR_INSTR = {STR_INSTR,
Instr: 0, Indice du nom de l'instrument voir SUP_NRH.PRO
File: ' ', Nom du fichier a lire
max: 100, Niveau max de visualisation en % du max
min: 0} Niveau min de visualisation en % du max
EXAMPLE:
RH_2D
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 21/10/97
3/11/97 repertoire= repertoire courant ( J B)
(See rh_2d.pro)
NAME: ROUTINE_NAME PURPOSE: Tell what your routine does here. I like to start with the words: "This function (or procedure) ..." Try to use the active, present tense. CATEGORY: Put a category (or categories) here. For example: Widgets. CALLING SEQUENCE: Write the calling sequence here. Include only positional parameters (i.e., NO KEYWORDS). For procedures, use the form: ROUTINE_NAME, Parameter1, Parameter2, Foobar Note that the routine name is ALL CAPS and arguments have Initial Caps. For functions, use the form: Result = FUNCTION_NAME(Parameter1, Parameter2, Foobar) Always use the "Result = " part to begin. This makes it super-obvious to the user that this routine is a function! INPUTS: Parm1: Describe the positional input parameters here. Note again that positional parameters are shown with Initial Caps. OPTIONAL INPUTS: Parm2: Describe optional inputs here. If you don't have any, just delete this section. KEYWORD PARAMETERS: KEY1: Document keyword parameters like this. Note that the keyword is shown in ALL CAPS! KEY2: Yet another keyword. Try to use the active, present tense when describing your keywords. For example, if this keyword is just a set or unset flag, say something like: "Set this keyword to use foobar subfloatation. The default is foobar superfloatation." OUTPUTS: Describe any outputs here. For example, "This function returns the foobar superflimpt version of the input array." This is where you should also document the return value for functions. OPTIONAL OUTPUTS: Describe optional outputs here. If the routine doesn't have any, just delete this section. COMMON BLOCKS: BLOCK1: Describe any common blocks here. If there are no COMMON blocks, just delete this entry. SIDE EFFECTS: Describe "side effects" here. There aren't any? Well, just delete this entry. RESTRICTIONS: Describe any "restrictions" here. Delete this section if there are no important restrictions. PROCEDURE: You can describe the foobar superfloatation method being used here. You might not need this section for your routine. EXAMPLE: Please provide a simple example here. An example from the PICKFILE documentation is shown below. Create a PICKFILE widget that lets users select only files with the extensions 'pro' and 'dat'. Use the 'Select File to Read' title and store the name of the selected file in the variable F. Enter: F = PICKFILE(/READ, FILTER = ['pro', 'dat']) MODIFICATION HISTORY: Written by: Your name here, Date. July, 1994 Any additional mods get described here. Remember to change the stuff above if you add a new keyword or something!
(See position/cw_pos.pro)
NAME: RS_IND PURPOSE: Cette fonction donne l'indice d'un pixel dans untableau a partir de la position en rayon solaire, l'indice du centre le l'image, la dimension du rayon solaire en pixels CATEGORY: RADIO CALLING SEQUENCE: RS=IND_RS(ind, pcentre, rayon) INPUTS: RS Position du pixel en rayon solaire Pcentre Indice du centre de l'image Rayon Nombre de pixels representant le rayon solaire OUTPUTS: RS Coordonnee en rayon solaire EXAMPLE: IND = RS_IND(-1, 32, 16) IND indice du pixel situe a -1 rayon solaire MODIFICATION HISTORY: Ecrit par: J Bonmartin le 21/10/97
(See util/rs_ind.pro)
NAME:
SCAN_CENTRES
PURPOSE:
determine tous les volumes gaussiens contenus dans les images d'un
RH 2D dans un interval de temps donne.
CATEGORY:
RH_2D, Recherche de positions
CALLING SEQUENCE:
SCAN_CENTRES, Fich1, Hdebut, Hfin, fich2, POLAR
INPUTS:
Fich1: nom du fichier RH 2D contenant les images
Hdebut: heure de la premiere image en ms
HFin: heure de la derniere image en ms
OPTIONAL INPUTS:
Fich2: nom du fichier binaire dans lequel est stocke la description
des volumes gaussiens (defaut centres.dat)
KEYWORD PARAMETERS:
POLAR: pour travailler sur les images polarisees
OUTPUTS:
Cette procedure cree un fichier binaire qui contient la description
de tous les volumes gaussiens trouves.
COMMON BLOCKS:
BLOCK1: Describe any common blocks here. If there are no COMMON
blocks, just delete this entry.
SIDE EFFECTS:
Describe "side effects" here. There aren't any? Well, just delete
this entry.
RESTRICTIONS:
Describe any "restrictions" here. Delete this section if there are
no important restrictions.
EXAMPLE:
SCAN_CENTRES('f96de2301.2d2', 3e+7, 5e+7, 'cent2301_2.dat'
MODIFICATION HISTORY:
Ecrit par: C. Renie
(See position/scan_centres.pro)
NAME: SUPER_IMNRH PURPOSE: Procedure de superposition d'image RH et d'instruments autres CATEGORY: Visualisation CALLING SEQUENCE: SUPER_IMNRH, file, str_lim, str_visu, EXT_IM, $ EXT_XCEN, EXT_YCEN, EXT_R INPUTS: FILE Nom du fichier NRH HEADER: Header resultant de la du fichier FITS STR_VISU: Structure liee a VISU_2D, voir visu_2d.pro pour la description EXT_IM Tableau d'image de l'instrument autre EXT_XCEN Coordonnee X du centre de l'image EXT, en pixels EXT_YCEN Coordonnee Y du centre de l'image Ext, en pixels EXT_R Rayon solaire de l'image EXT, en pixels PROCEDURE: Cette procedure visualise l'image provenant d'un instrument autre que NRH en image et superpose l'image NRH en contours EXAMPLE: RD_SOHO,file,ext_im, ext_xcen, ext_ycen, ext_r, str_instr Lecture d'une image FITS de SOHO SUPER_IMNRH,str_fic.file, str_lim, str_visu, $ ext_im,Ext_xcen, Ext_ycen, Ext_r, str_instr Visualisation et superposition MODIFICATION HISTORY: Ecrit par: J Bonmartin le 20/11/97
(See visu_im/super_imnrh.pro)
NAME: SUP_NRH PURPOSE: Cette procedure contient les dialogues WIDGET pour superposer les contours d'une image du NRH a une image d'autres instruments CATEGORY: WIDGET CALLING SEQUENCE: SUP_NRH, GROUP = group INPUTS: KEYWORD PARAMETERS: GROUP Identication du widget appelant OUTPUTS: COMMON BLOCKS: FICHR structure contenant la selection de fichiers voir rh_2d INFO2D structure d'information dur les donnees, voir RH_2D VISU_2d structure contenant les parametres de visualisation DATA_NRH2 contenant les donnees et le header PROCEDURE: Cette procedure lit les donnees du NRH et d'un autre instrument puis visualise l'image de l'autre instrument et superpose le trace de contours de l'image NRH, StokesV ou StokesI. Pour rajouter des instruments non prevus: -ecrire une routine de lecture des donnees qui fournisse: une image dans un tableau EXT_IM, les coordonnees X et Y, en pixels, du centre de l'image dans les variables EXT_XCEN, EXT_YCEN, et le rayon dans EXT_R Entrer le nom de l'instrument dans la liste INSTRUM_LIST Entrer l'appel a la routine de lecture dans le traitement du Widget 'Display' EXAMPLE: MODIFICATION HISTORY: Ecrit par: J Bonmartin le 24/11/97
(See visu_im/sup_nrh.pro)
NAME: TICKSHOUR PURPOSE: Cette procedure convertie les etiquettes de l'axe des X en chaine de caracteres au format HH:MM:SS:MS. Elle doit etre utilisee avec le keyword [XYZ]TICKFORMAT. CATEGORY: RH_2D, recherche de positions CALLING SEQUENCE: TICKSHOUR, Axis, Index, Value PLOT, Y, XTICKFORMAT='TICKHOUR' INPUTS: Axis: axis number: 0(X), 1(Y), 2(Z) Index: tick mark index Value: default tick mark value (a floating point number) KEYWORD PARAMETERS: OUTPUTS: EXAMPLE: PLOT, Y, XTICKFORMAT='TICKHOUR' MODIFICATION HISTORY: Ecrit par: C Renie
(See position/tickshour.pro)
NAME:
TIME_IND
PURPOSE:
Recherche de l'indice correspondant a un temps donne dans un tableau de; temps
CATEGORY:
NRH 2D
CALLING SEQUENCE:
IND = TIME_IND(Time, val)
INPUTS:
TIME tableau de temps en ms
VAL Valeur du temps cherche
OUTPUTS:
IND indice dans le tableau
ERREUR si IND= -1, Temps non trouve, ou TIME n'est pas un
tableau a 1 dimension
EXAMPLE:
data = MRDFITS('Fichier',1,Header)
temps = hms('10:30:50:80)
IND= TIME_IND(data.tempms,temps)
donne l'indice de l'image correspondant a 11h,30mn,50s,80 centieme)
data(ind).np est le tableau correspondant au prametre de STOKES I
data(ind).p est le tableau correspondant au prametre de STOKES V
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 21/10/97
(See util/time_ind.pro)
NAME: TIME_IND_NRH PURPOSE: Cette fonction determine le numero de la ligne contenant les donnees correspondant a une heure donnee dans un fichier NRH CATEGORY: Traitement de fichiers NRH CALLING SEQUENCE: IND = TIME_IND_NRH, fichier, heure INPUTS: FICHIER Nom du fichier HEURE Heure recherchee (chaine ASCII) OUTPUTS: IND Numero de la ligne PROCEDURE: Cette fonction lit les heures successives contenues dans la colonne TIME des fichiers NRH, jusqu'a trouver l'intervalle d'heure recherchee Si l'heure cherchee n'est pas dans le fichier, un message d'erreur est envoye et le numero de la ligne retourne = 0 EXAMPLE: IND= TIME_IND_NRH( Str_fic.file, Str_visu.Hdem) MODIFICATION HISTORY: Ecrit par: J Bonmartin le 12/01/98
(See util/time_ind_nrh.pro)
NAME: TRI_CENTRES PURPOSE: Tri en position(s) les volumes gaussiens determines apres la procedure SCAN_CENTRES CATEGORY: RH_2D, Recherche de position CALLING SEQUENCE: TRI_CENTRES, Nbposi, Nbhit, Fich1, Fich2 OPTIONAL INPUTS: Fich1: nom du fichier binaire dans lequel est stocke la description des volumes gaussiens (defaut centres.dat) OUTPUTS: Nbposi: nombre de positions trouvees Nbhit: nombre maximum de centres par position OPTIONAL OUTPUTS: Fich2: nom du fichier binaire qui contient la description des volumes gaussiens classes par position (defaut positions.dat) EXAMPLE: TRI_CENTRES, nbposi, nbmaxhit, 'cent2101_2.dat', 'posi2101_2.dat' MODIFICATION HISTORY: Ecrit par: C. Renié
(See position/tri_centres.pro)
Cette procedure determine les distances entre le centre et la frontiere valmax/seuil dans 8 directions privilegiees (kpi/4) APPEL: tab: tableau a deux dimensions contenant l'image xm, ym: indices du maximum du tableau d: tableau des 8 distances a calculer seuil: critere de recherche des 8 distances
(See position/trv_dist.pro)
Cette procedure permet de localiser et de caracteriser une source gaussienne par la methode de la mi-hauteur APPEL: tab: tableau à deux dimensions contenant l'image xmax, ymax: indices du maximum du tableau gauss: structure qui recoit les parametres de la gaussienne seuil: critere de recherche des 8 distances
(See position/trv_gaus.pro)
NAME: TVELLIPSE PURPOSE: Draw an ellipse on the current graphics device. CALLING SEQUENCE: TVELLIPSE, rmax, rmin, xc, yc, [ pos_ang, color, /DATA, THICK = , NPOINTS =, LINESTYLE = ] INPUTS: RMAX,RMIN - Scalars giving the major and minor axis of the ellipse XC,YC - Scalars giving the position on the TV of the ellipse center OPTIONAL INPUTS: POS_ANG - Position angle of the major axis, measured counter-clockwise from the X axis. Default is 0. COLOR - Scalar giving intensity level to draw ellipse. The color can be specified either with this parameter or with the COLOR keyword. Default is !P.COLOR OPTIONAL KEYWORD INPUT: DATA - if this keyword is set and non-zero, then the ellipse radii and X,Y position center are interpreted as being in DATA coordinates. Note that the data coordinates must have been previously defined (with a PLOT or CONTOUR call). COLOR - Intensity value used to draw the circle, overrides parameter value. Default = !P.COLOR THICK - Thickness of the drawn ellipse, default = !P.THICK LINESTLYLE - Linestyle used to draw ellipse, default = !P.LINESTYLE NPOINTS - Number of points to connect to draw ellipse, default = 120 RESTRICTIONS: TVELLIPSE does not check whether the ellipse is within the boundaries of the window. The ellipse is evaluated at NPOINTS (default = 120) points and connected by straight lines, rather than using the more sophisticated algorithm used by TVCIRCLE TVELLIPSE does not accept normalized coordinates. EXAMPLE: Draw an ellipse of major axis 50 pixels, minor axis 30 pixels, centered on (250,100), with the major axis inclined 25 degrees from the X axis Use a double thickness line and device coordinates (default) IDL> tvellipse,50,30,250,100,25,thick=2 NOTES: Note that the position angle for TVELLIPSE (counter-clockwise from the X axis) differs from the astronomical position angle (counter-clockwise from the Y axis). REVISION HISTORY: Written W. Landsman STX July, 1989 Converted to use with a workstation. M. Greason, STX, June 1990 LINESTYLE keyword, evaluate at 120 points, W. Landsman HSTX Nov 1995 Added NPOINTS keyword, fixed /DATA keyword W. Landsman HSTX Jan 1996 Check for reversed /DATA coordinates P. Mangiafico, W.Landsman May 1996
(See position/tvellipse.pro)
NAME:
UVALUE_REGION
PURPOSE:
Cette procedure reactualise le contenu de UVALUE pour le widget
CW_REGION
CATEGORY:
Widgets
CALLING SEQUENCE:
UVALUE_REGION,Xdim,Ydim,Vdim
INPUTS:
XDIM dimension X du tableau contenant l'image
YDIM dimension Y du tableau contenant l'image
VDIM valeur superieur de la dimension de l'image
KEYWORD PARAMETERS:
OUTPUTS:
remise a jour du contenu de la structure STATE
state{size_imx, size_imy, size_vis}
remisse a jour des UVALUE de CURSOR et RESET
COMMON BLOCKS:
IDENT_REG:
cursor identification du widget 'CURSOR'
reset identification du widget 'RESET'
textx identification du widget X:...
texty identification du widget Y:
state structure
EXAMPLE:
UVALUE_REG,state.size_imx,state.size_imy,state.size_vis
pour reactualiser apres changement de donnees ou de
dimension
MODIFICATION HISTORY:
(See util/cw_region.pro)
NAME: VISU_2DNRH PURPOSE: WIDGETS pour la visualisation des images 2D du NRH CATEGORY: WIDGET CALLING SEQUENCE: Visu_2DNRH, GROUP = group INPUTS: OPTIONAL INPUTS: GROUP Identifieur du widget appelant COMMON BLOCKS: COMMON FICRH, str_fic structure definie dans rh_2d.pro selection des fichiers COMMON VISU_2D str_visu structure definie dans rh_2d.pro parametres de visualisation COMMON DATA_NRH2, Donnee, Header contenant les donnees lues PROCEDURE: Cette procedure donne acces aux fonctionsde -trace d'images en bitmap -traces de contours -traces de profils par PROFILE ou PROFILES -selection d'une region dans une image -selection de fichier EXAMPLE: VISU_2DNRH ou VISU_2DNRH, GROUP=Id MODIFICATION HISTORY: Ecrit par:
(See visu_im/visu_2dnrh.pro)