Home

LIFE User's Guide - Planck LFI

1. 6 5 1 1 General functions lama get num of sci tabs TEST test Function Return the overall number of scientific channels present in test If the TEST keyword was not specified use the default test In some cases the acguisition system is not able to identify the sky and reference signals correctly Lama provides the ability to swap the two signals by means of lama swap sky ref page 28 You can determine if a channel has been already swapped by using the function lama channel is swapped page 28 lama swap sky ref channel TEST test FEED HORN feed horn Procedure Swap sky and reference values If no keywords is specified do nothing If CHANNEL is specified swap sky and reference of that channel of the default test of the default feed horn If FEED HORN is specified swap sky and reference of all channels of the feed horn of the default test If TEST is specified swap all horns of the test lama channel is swapped channel num TEST test name Function FEED HORN feed horn PROC TYPE proc type Return 1 if the scientific sky and reference signals coming from channel ch are swapped If TEST FEED HORN and PROC TYPE are not specified the defaults are used Chapter 6 IDL Command Reference 29 6 5 1 2 Accessing binned data The following functions give access to the data saved in the AUX files i e the scientific data downsampled at 1 Hz lama get sky x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the tim
2. name name or identified by the two index numbers tab and element A typical usage is pathi lama get hk path LM101326 New LM syntax preferred path2 lama get hk path 1 5 Old syntax compatible with RaNAN print Node 1 is lama input get node description pathi print Node 2 is lama input get node description path2 The following procedure is used to get a list of all the available housekeeping parameters in the specified test lama dump hk tables TEST test Procedure This procedure prints on the IDL terminal a list of all the housekeeping parameters found in test or in the default test if the TEST keyword is not specified For each parameter the following information is provided Chapter 6 IDL Command Reference 38 1 The pair to be used with lama_get_hk_x page 36 and lama_get_hk_y page 36 2 The LM code of the parameter to be used with lama get hk x page 36 and lama get hk yl page 36 and as reference 3 The full description of the parameter The following function is a specialization of ama input unload node page 43 See also lama input unload feed horn page 35 and similar functions Refer to section ID LUnloadData page 43 for more information about unloading data from memory lama input unload hk name TEST test Procedure This function unloads the X and Y data from the housekeeping parameter identified by name You can still call lama get hk x page 36 and lama get hk yl
3. rad 1 ch 1 104 FH 3 20 rad 1 ch 1 132 FH 24 rad 0 ch 0 105 FH 19 rad 0 ch 0 133 FH 24 rad 0 ch 1 106 FH 19 rad 0 ch 1 134 FH 24 rad 1 ch 0 107 FH 19 rad 1 ch 0 135 FH 24 rad 1 ch 1 108 FH 19 rad 1 ch 1 136 FH 21 rad 0 ch 0 100 FH 18 rad 0 ch 0 137 FH 21 rad 0 ch 1 110 FH 18 rad 0 ch 1 138 FH 21 rad 1 ch 0 111 FH 18 rad 1 ch 0 139 FH 21 rad 1 ch 1 112 FH 18 rad 1 ch 1 140 FH 22 rad 0 ch 0 113 FH 26 rad 0 ch 0 141 FH 22 rad 0 ch 1 114 FH 26 rad 0 ch 1 142 FH 22 rad 1 ch 0 115 FH 26 rad 1 ch 0 143 FH 22 rad 1 ch 1 116 FH 26 rad 1 ch 1 144 FH 23 rad 0 ch 0 117 Feed horn 18 70 GHz 201 FH 23 rad 0 ch 1 118 Feed horn 19 70 GHz 202 FH 23 rad 1 ch 0 119 Feed horn 20 70 GHz 203 FH 23 rad 1 ch 1 120 Feed horn 21 70 GHz 204 FH 25 rad 0 ch 0 121 Feed horn 22 70 GHz 205 FH 25 rad 0 ch 1 122 Feed horn 23 70 GHz 206 FH 25 rad 1 ch 0 123 Feed horn 24 44 GHz 207 FH 25 rad 1 ch 1 124 Feed horn 25 44 GHz 208 FH 28 rad 0 ch 0 125 Feed horn 26 44 GHz 209 FH 28 rad 0 ch 1 126 Feed horn 27 30 GHz 210 FH 28 rad 1 ch 0 127 Feed horn 28 30 GHz 211 FH 28 rad 1 ch 1 128 LFI all radiometers 301 This way of numbering channels derives from the FEM channel numeration used by the SCOS2000 scripts to drive the FEM active units phase switches and LNAs Since tri
4. 4 6 Show fit The cross correlation module calculates the correlation coefficient as well as a simple linear least squares fit y a br for the data displayed on the plot window To display the fit check the Show Fit check box To hide the fit click on the check box again 4 4 5 Data Information Window The data information window has 8 columns 1 Description of X data 2 Description of Y data 3 Correlation coefficient for the full data set or the region of the dataset originally selected from Lama Plot 4 Correlation coefficient for the region currentely displayed in the correlation plot This number changes after a zoom operation Chapter 4 LAMA 23 5 Linear fit coefficient a for the full dataset or the region of the dataset originally selected from Lama Plot 6 Linear fit coefficient a for the region currentely displayed in the correlation plot 7 Linear fit coefficient b for the full dataset or the region of the dataset originally selected from Lama Plot 8 Linear fit coefficient b for the region currentely displayed in the correlation plot Chapter 5 OCA 5 OCA 24 Chapter 6 IDL Command Reference 25 6 IDL Command Reference This chapter provides a broad and fairly complete overview of the commands implemented by LIFE which are available through the IDL command line 6 1 The Lama Instance Lama uses a more complex design than RaNA It uses a mix of IDL C code to achieve greater speed and provide the user
5. Unload Test ud aus er Miskina a Eats Ti V View Data x22 nbs e erede ds ede 9 Function index 58 Function index lama_channel_is_swapped 28 lama input get node x units 41 lama dump hk tables esses 3T lama input get node y units 41 lama dump measure units 46 lama input get num of log messages 48 lama get aux paths sssusa 2 9 RR RV 35 lama input get selected feed horn 2T lama_get_calibration_sets 002 0500 50 lama input get selected test 26 lama get default calibration set 51 lama input is test available 26 lama get env ven mas ia nek n bb oN una 9T lama input load test e ccc ee e nn 26 lama get env SIE 1 0k epa 34 lama input select feed horn 2T lama get hk description 36 lama input select test ossis 26 lama get hk name e c n reds 36 lama input set current node 43 lama get hk path ieget r sre m UE 3T lama input unload aux sss 35 lama got hk Xi e IeenRPPLSM SET Ire MEG 36 lama input unload feed horn 35 lama get hk yi Settee tagiad eater tees 3T lama input unload hk ss 38 lama get num of sci tabs esse 28 lama input unload node s s 44 lama get ra w Sigma 6 x me sas N 30 lama input unload selection 36 lama get ra
6. bars For more information See Section 4 4 Cross page 20 Cross Corr TUN 0015 2711 Aux file Ref 2700 Aux file Sky Save Pata Reset A 4 gt vir athasm ats Max 45h 57m 395 Rarge thamas PletStre Manualzoon r Dalta nfermalticn r Plat X Dzta Y Data Corr 2711 Aux file Ref 2700 Aux file S 0 65108 Ky POER lt gt Swap XiY C Shaw Natz Paints LJ Shew ErrerBars QX OY Bin C Show rit Bin Size Bn Count 1 Legend Datase Color Style Visibe CrossCorr SclidLine True 1 0 5 Voltage 1 Sp Figure 2 5 Lama Crosscorrelation plot window Return to Lama View Select the feed horn 28 and press the button labeled Add to Existing In the menu select the voice Lama Plot 2700 window Now in the bottom of the window there is a list Select the voice Lama Plot 2700 window and press the button Chapter 2 Tutorial 7 labeled Bring to Front The Lama Plot window shows data of both feed horns Return to Lama View Select feed horn 24 and press the button labeled Add to new plot Return to Lama View again In the Window List select both windows and press the button labeled Combine Windows Now there is only one window which shows data contained in both previous windows At the end of the work session close Lama View this will close all the Lama Plot and Lama Cross opened windows and return to Lama Top Before
7. last the error associated with the binned value for Y The errors saved on the file are simply the standard deviation calulated from all the values in the bin The files containing data with associated error bars have a BIN appended at the end of the name 4 4 3 Time Span There are three numbers on the right upper corner immediately above the plot region 1 Min The time associated with the first sample used in the cross correlation 2 Max The time associated with the last sample used in the cross correlation 3 Range The time interval associated with the full timelines used in the cross correlation 4 4 4 Operations 4 4 4 1 Reset Clicking the button labeled Reset will undo all the operations on the data and reset the zoom list After clicking on this button the navigation buttons will be deactivated until another zoom operation is performed 4 4 4 2 Swap Axes Clicking on the check box labelled Swap X Y will swap the axes Before displaying the plot the data is sorted according to the values originaly displayed as Y Clicking one more time will display the original plot Chapter 4 LAMA 22 It is not possible to swap the axes when error bars are displayed Conversely when the axis are swaped it is also not possible to show error bars 4 4 4 3 Show points Clicking on the check box labeled Show Data Points will display the data points Note that when the cross correlation plot being displayed involves data streams with different sam
8. life pdf Chapter 2 Tutorial 3 2 Tutorial 2 1 Getting Help As well as reading this manual it is useful to know how to access the IDL help files for each function Use the show help command show help lama tune phase switch currents helpinput helpoutput This function will generate a help window containing information about the function you specify 2 2 A Lama View Session First of all a test is needed For this example download TUN 0015 tgz from Max and decompress it in a directory From command line execute idl run life pro IDL compiles LIFE and after this if there are no errors the main LIFE window appears Click on LAMA icon and Lama Top appears Figure 2 1 LAMA Lfi Array Measurements Ar PI Welcome to LAMA Lfi Array Measurements Analyser SAN LFI ARRAY MEASUREMENT ANALYSER Version 1 99 0 Start session Coase session Read data Sualyse data View data Report Configure Exit Help Figure 2 1 Lama Top main window The first task is to open a session All the operations done during the session are stored in a folder Click on the button labeled Browse to change the location of the directory Then click the button labeled Start Session to start the session Lama creates the new directory and all subdirectories needed for saving operations Click the button labeled View Data to open Lama View The window is empty For loading the test click the button labeled Add New Test an
9. m Plot Pht Seecton ScientifizIrfo Housekeeping Info Manualzoom Overall operetion ResetPlot J savePot AQE Show plain data Time range 1h 6m 9s 165 407 191735 Remove nean O Normalize te 1 1 Jataset Visible Sky 2700 Aux file Ref 2700 Aux file Sky 2701 Aux fle Ref 2701 Aux fie Sky 2710 Aux fle Ref 2710 Aux fie Sky 2711 Aux file Ref 2711 Aux file SolidLine I Ii Ii 1 1 1 1 1 1 1 1 1 1 1 i 1 1 i Lb 162 000 153 000 164 00C 165 C00 Tine s Figure 2 4 Lama Plot window In the top left of the Lama Plot window there are six buttons The buttons with the icons change the mouse interaction with the plot the first is for zooming the second is for selecting and the third is for pan Press left mouse button on the plot and move it a blue rectangle appears in the plot Now release the button and the plot is zoomed in Do the same pressing right mouse button for zooming out The two arrows let to navigate into the different zooms Now press the icon with the two sheet Pressing the left mouse button on the plot and moving it a blue rectangle shows the selection area See ScientificSelection page 16 for details Now press the icon with the mouse Pressing the left mouse button on the plot and moving it moves the entire plot Press the button labeled Reset to undo all the operations performed on the data and reset the zoom list On
10. node type path TEST name Function Return the type an integer of the node belonging to the test named name and specified by the string path If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used The type codes are listed here Code Description 0 A generic node This code usually indicates that there is an error in the node tree 1 The root node of the tree Its name is the name of the test 2 A parameter group 3 A node containing photometric calibration information for a channel 4 A feed horn 5 A radiometric channel 6 A processing type 7 An AUX file 8 A node containing the scientific output of a channel 9 An housekeeping parameter 6 5 3 2 The current node Each test loaded into memory has a current working node much similar to the concept of the current working directory in operating systems This is the default node used by almost all the functions described in this section The root node is always indicated with amp There are two functions designed to set retrieve the current node lama input get current_node and lama_input_set_current_node Chapter 6 IDL Command Reference 43 lama input get current node TEST name Function Return the path of the current node for the test named name If name is not provided return the current node for the default test lama input set current node path TEST nam
11. of elements in the array should match the return value of lama input get num of log messages page 48 Each string contains the date and time in ISO format e g yyyy mm ddThh mm ss where yyyy is the year mm the month dd the day hh the hours mm the minutes and ss the seconds when the log message was entered If test does not exist or if no log message was recorded the function returns 1 If the TEST keyword was not specified the default test will be used See lama input get selected test page 26 lama input get log text TEST test Function Return an array of strings containing the text of each log message recorded by the TOL The number of elements in the array should match the return value of lama input get num of log messages page 48 If test does not exist or if no log message was recorded the function returns 1 If the TEST keyword was not specified the default test will be used See lama input get selected test page 26 Typically the first log message contains a string which describes what the test is about We want to display it on the screen if lama input get num of log messages gt O then begin print Purpose of the test print lama input get log text O 0 endif Chapter 6 IDL Command Reference 50 lama input get log messages TEST test Function Return an array of structures containing information about each log message recorded by the TOL The number of elements in the array should match t
12. others are like directories Chapter 6 IDL Command Reference 40 e g parameter groups We used this analogy to develop an IDL interface to access the tree structure to find or uniquely specify a node you have to provide a path to the node Node paths are made by concatenating the names of each parent nodes following the hierarchical sequence separated by a amp For instance the full path to Cone Right Part is Temperatures amp FPU temperatures amp Cone Right Part To get the node names you can use the function lama_input_get_node_name lama input get node name path TEST name Function Return the name of the node relative to path a string and belonging to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used To traverse the node tree you need to know what are the children of a specified node This is provided by the function lama input get children lama input get children path TEST name Function Return a string array containing the children of the node specified by path and be longing to the test named name If path is not specified the current node of the test will be used see current node page 42 If name is not specified the default test will be used If the node has no children the function returns 1 Here is an example showing how to print the full node tree by implementing a rec
13. page 36 after a call to this function Lama will silently load the data again The following example shows how to save some memory when processing data from housekeeping parameters Retrieve data from an housekeeping parameter hk name LM302122 x lama get hk x hk name y lama get hk x hk name We have the housekeeping data available into the two IDL vectors X and Y so we can unload it from Lama View lama input unload hk hk name Now use X and Y freely 6 5 3 Browsing the node tree Starting from Lama 2 0 a new approach to access test data has been developed The house keeping and scientific parameters recorded during a test are stored in a tree like structure The basic element of this tree is a node i e a piece of information Nodes are connected hierarchically by means of parent child relationships each node has one parent node and several child nodes This is the view of some details of the full node tree used by Lama Scientific data 30 GHz feed horns FH 27 Processing type AVR1 Channel 00 Scientific node AUX node Calibration node Channel 01 Scientific node AUX node Calibration node Chapter 6 IDL Command Reference 39 Temperatures FPU temperatures Housekeeping Right Bottom FH28 Housekeeping Cone Right Part Housekeeping Right Side Wall Housekeeping Left Bottom FH25 Housekeeping Cold Plate Far Left Housekeeping Cone Left Part BEU temperatures Housekeeping
14. unit id path TEST name Function Return a string containing the full name e g seconds of the measure unit with ID unit id The measure unit must belong to the node specified by path and to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used Note that this function does not distinguish between X and Y measure units this means that you can use it either with IDs returned by lama input get node x units page 41 and lama input get node y units page 41 If the node does not contain an unit with ID unit id an empty string will be returned Chapter 6 IDL Command Reference 42 lama input get node unit description unit id path TEST name Function Return a string containing a short description e g Temperature of the measure unit with ID unit id The measure unit must belong to the node specified by path and to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used Note that this function does not distinguish between X and Y measure units this means that you can use it either with IDs returned by lama input get node x units page 41 and lama input get node y units page 41 If the node does not contain an unit with ID unit id an empty string will be returned lama input get
15. with a complete graphical user interface In order to use C modules you have to create an instance that is a data structure which keeps track of the various data structure that need to be shared both by IDL and by the C functions See lama instance create page 25 Only one instance of Lama is needed during the program execution typically it is created when the Start session button in the Lama Top window is pressed and destroyed when the Close session button is pressed lama instance create directory Function Create a new instance of LAMA This function needs to be called once usually when the Start session button in the Lama Top window is pressed The directory parameter is a string containing the full path to the life lama directory and is used to locate Lama specific files like lama_parameters xml If directory is not specified the current working directory will be used The return value is nonzero if the instance was created successfully zero if some error occurred result lama instance create home tomasi work life lama lama instance close Procedure Close the currently opened Lama instance It is usually called when the user presses the Close session button in the Lama Top window lama instance is created Function This function returns nonzero if lama instance create was called and therefore the Lama system has been initialized Since almost every function in the
16. 1 2 lama get sci nsamples ch TEST test FEED HORN horn Function PROC TYPE proc type Return an array of the same size as the ones returned by lama get sky x page 29 lama get sky yl page 29 lama get ref x page 29 and lama get ref y page 29 containing the number of scientific samples used to create the aux binned data If TEST FEED HORN and PROC TYPE are not specified the defaults are used lama get sci ave ch range min min time range max max time Function TEST test FEED HORN horn PROC TYPE proc type X UNIT x unit UNIT y unit Return the mean of the selected scientific reference data for channel ch If min time and max time are specified then the mean is calculated in the specified time window Otherwise it is calculated in the current statistical range see lama get statistic range page 33 The result is a two valued array where the first value refers to the sky the second to the reference load If X UNIT keyword is not specified then the function uses seconds for the time series If UNIT is not specified then the function returns values in Volt See measureUnits page 45 lama get sci sig ch range min min time range max max time Function TEST test FEED HORN horn PROC TYPE proc type X UNIT x unit UNIT y unit Return the standard deviation of the selected scientific reference data for channel ch If min time and max time are specified then the mean is calculated in the specified time window Otherwis
17. 12 4 2 1 6 Right Mouse Button Menu 0 12 42 2 Window List Ares erede Vane xeu eade Paus k it h e 13 4 3 The Lama Plot Window eeeee RR 13 4 3 1 The plot mme Her aep RR wees 13 ASI Zoom d n sesti gebe FS E e hani v henisi neut 14 4 3 1 2 Navigating into the data loose 14 4 3 1 3 Select data lille 14 A314 Pan plot sie duce Re eb i 15 4 3 1 5 Reset Plots aukase err ees b res 15 4 3 1 6 The Plot Legend leues essere 15 4 8 2 Operations lm ceeds KEI Meee eae EE a te 15 4 3 3 Scientific Selections merei rme lesen 16 4 3 4 Radiometric Operations ooo esses 17 4 3 4 1 Swap sky and reference soolon 18 4 3 4 2 Show gaps in scientific data 0002 000 18 4 3 5 Housekeeping information 00000 eee eens 18 4 3 6 Manual operations 00 0000 cece cece eee n 19 4 4 The Lama Cross correlation Window 00 005 20 4 4 1 Choosing Data 0 cece enn 20 4242 Wher plot 222219 proide idee hii Eee er dees 20 4 4 2 1 Navigating into the data loose 21 4 4 2 2 Save datas ae eaa E E E a E a 21 4 4 3 Tine Span creas cay ch es Knn EERTE EE ER ees 21 AAA Operations isese seb TB aa t s Ut ted obe Do E Kike 21 BAAN RESCH muasa sysadmin c rd a l e RP a 21 4 4 2 0 Swap xes iloon ehh hh 21 4 44 3 Show pots 2 22 bre re oru vA IUDA Oba ctore i 22 4 4 44 Show error bars oloon
18. 22 4 4 4 5 Binsdat cii iE reper ance dae hee end tsi s 22 AAAG Slow Hb setas eee aero d Maisa oeste NN D E DET 22 4 4 5 Data Information Window eess piierne esita a iuiieika ss 22 D OCGA 3551228000 50 orao oe aaen a Et 24 6 IDL Command Reference 25 6 1 The Lama Instance cirian nenea n 25 6 2 Opening and closing Lama View sossun 25 6 3 Loading unloading tests 2 2 2 ua usa kaa orna hern 26 0 4 Reed DO US ssi mn tele tact cece nana ane eae eee N as 27 6 5 ACCESSING data inc sicca ciere GU A Adalin ER 28 6 5 1 Scientific data ooo eee eee eens 28 6 5 1 1 General functions slisseeeseeee esee 28 6 5 1 2 Accessing binned data soo ooo lessen 29 6 5 1 3 Accessing full scientific data lise c ee eee 30 6 5 1 4 Statistics nes terrasa eiie nun 32 6 5 1 5 Photometric calibration 00000005 34 6 5 1 6 Miscellanea sloan 34 6 5 2 Housekeeping data ossaa NN 36 6 5 2 1 Housekeeping Statistics ooo nnnnnnnnn 37 6 55 22 Miscellanea usa useaa er cec Rok ere 37 6 5 3 Browsing the node tree 00 eee eee 38 6 5 3 1 Node paths s derer oe e eed 39 6 5 3 2 The current node usa kaus e eer Rs 42 6 5 3 3 Retrieving scientific housekeeping data 43 6 5 3 4 Unloading data from memory 00 43 6 5 3 5 Finding nodes in the tree oossoo 44 6 5 4 Using measure units o ouluun 45 6 5 4 1 R
19. CT pga RAW raw Return the standard deviation i e the root mean sguare of each scientific reference sample See lama selection get ref y page 31 lama selection get raw y ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned sky reference signal coming from channel ch The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama selection get sky yl page 31 lama selection get raw sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the standard deviation ie the root mean square of each scientific sky reference sample The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama selection get raw y page 31 Chapter 6 IDL Command Reference 32 6 5 1 4 Statistics Lama provides the user with some functions to perform guick analysis on the selected data They are useful e g for writing batch scripts range lama selection get range average lama selection get sci ave 0 sigma lama selection get sci sigma 0 print Between range 0 s and range 1 g the sky signal is print average O sigma 0 and the ref signal is print average 1 sigma 1 print The difference is then print abs average 0 average 1 sqrt sigma 0 2 sigma
20. Cold Plate Right 25 6392 Left Bottom FH25 25 6701 Cold Plate Far Left 25 1234 Cone Left Part 25 5833 0 00675827 0 00734205 0 00823891 0 00465057 0 00508229 0 0070377 0 00418306 0 00441531 0 00557483 0 00583277 0 0034626 0 00328098 D Figure 4 11 The plot housekeeping information tab 4 3 6 Manual operations The last tab in the right side of Lama Plot shows the manual operation Figure 4 12 There are two possible operations 19 e There are four cells Set one or more of those cells and press the button labeled Zoom shows the data in the selected range of zoom e Clicking the button labeled SET the two cells labeled X Origin and X End are updated with the range of the x axis This range can be used for computing statistics available from IDL command line See statistics page 31 Chapter 4 LAMA 20 Plot Selection Scientific Info Housekeeping Info Manual zoom x jv x J v Zoom Set Range For Statistics SET X Origin X End Figure 4 12 The plot manual operations tab 4 4 The Lama Cross correlation Window 4 4 1 Choosing Data There are two ways to display a cross correlation plot 1 Display a cross correlation plot form Lama View On the data tree select 2 timelines to be correlated right click and choose Cross Correlate Plot on the menu 2 Display a c
21. Cone Right Part FPU temperatures Right Side Wall FPU temperatures Cold Plate Far Rght FPU temperatures FF28 lange FPU temperatures Right 30nom FH26 FPU temperatures Let Side Wal FPU temperatures Cold Plate Left Irner FPU temperatures Cold Plate RightInner FPU temperatures Let Bottom FH25 FPU temperatures Cold Plate Far Left FPU temperatures Cone eft Part 7 Ering to front combine windows l Q Cose window Tes TUN 0015 read Etat Ieee eee Figure 4 4 Windows List in Lama View main window 4 3 The Lama Plot Window Lama Plot window plots scientific and housekeeping values 4 3 1 The plot The plot is the image in the left part of Lama Plot Figure 4 5 The image shows values of data selected in Lama View Node List view in different colors The x axis is ususally time instead the y axis is different for different types of data e g all scientific data are in volts In the bar at the top of the window there are different buttons for different operations Figure 4 6 The next sections show how to use those tasks Chapter 4 LAMA 14 Voltage V za Li e m mw 1 3 eS S 8 3 ESE AL 162 000 163 000 164 000 165 000 Time s Figure 4 5 The plot 4 3 1 1 Zoom data When the Zoom button Figure 4 6 is selected it s possible to zoom in in the plot by clicking the left mouse button Moving mouse with the left mouse pressed a rectangle is drawn in th
22. Figure 4 6 will undo all the operations performed on the data and reset the zoom list After clicking on this button the navigation buttons will be deactivated until another zoom operation is performed ResetPit J svert Jd lt gt Figure 4 6 The buttons for plot interactions 4 3 1 6 The Plot Legend In the right corner of the Lama Plot window there is the Legend Figure 4 7 In the Legend there is one row for each data stream plotted with its name its color its style and a boolean which says if it s visible It s possible to select some data stream in the legend Pressing the right mouse button a menu appears The menu has the possibility to change the style or the color to show or to hide a stream to remove a stream to open a crosscorrelation plot see Section 4 4 Cross page 20 for details Dataset Sky 2700 A Ref 2700 A Sky 2701 A Ref 2701 Au Sky 2710 A Ref 2710 Au Sky 2711 A mS Ref 2711 Au ZU SolidLine True SolidLine True Figure 4 7 The Legend of the plot 4 3 2 Operations The first tab in the right side of Lama Plot is the Operations tab Figure 4 8 It let to remove mean from the plot and to normalize data in the plot Those operation let a comparison between data plotted if they have a large range in the y axis e Remove Mean Pressing the Remove Mean button Lama Plot updates the plot remov ing the mean of each node plotted in the image e Normalize Data Pressi
23. L BEM 1 Housekeeping L BEM 2 This example should make the parent child relationship clear For instance the FPU temperatures node has six children all are housekeeping parameters while its parent is the Temperatures node Nodes are divided into different types according to the information they provide Scientific nodes They contain the sky and reference signal coming from a specified channel and recorded using a specified processing type Housekeeping nodes They are used to store information about an housekeeping parameter monitored by SCOS2000 AUX nodes These nodes contain the subsampled scientific data coming from a specified channel and processing type Calibration nodes These nodes contain the information needed to apply a photometric calibration on the data coming from a specified channel and processing type Parameter groups These nodes do not contain information but are used to hierarchically group a set of similar nodes e g the FPU temperatures node contains a set of housekeeping parameters used to monitor temperatures in the Front End Processing types These nodes are used to group together a set of channels belonging to the same feed horn Feed horns These nodes are used to group together a list of processing types 6 5 3 1 Node paths You can consider the node structure to be much like the layout of your hard drive some kind of nodes behave like files e g scientific housekeeping while
24. LIFE User s Guide The Planck LFI People This manual is for LIFE version 3 Lama 3 1 0 2008 09 05 15 36 10 Copyright 2004 2008 The Planck LFI People First version created by Maurizio Tomasi on 2006 06 22 Table of Contents E GJUBPVIOW 2299s xa Visits s esti d 1 L RANA e TrPIETIPrP EPEEM 1 DD HA MA PP 1 WI c 1 1 4 Conventions used in this manual 000000 c eee e eee 1 2 POO scr uere 3 wx swa ee tes ee 3 2 1 Getting Helpe 2e beer ATT ad dot et anda ge Ae 3 2 2 X Lama View SES8SlOl sc ded kas am neh kaa dee Bees eee J 3 3 DNA has tate nen tess hookers eset O 8 zx EAMA case otek eee auam e el ee RACE aberit EN S 9 4 1 The Lama Top Window 000 cece eee e 9 acd SSUAPIUIDOSSIODL gessi minimis tete T m n sen E Sarion sae 9 41 2 Mew DAE dank sce did ed died ae e Y oe ae a Back Ete Aad Sn 9 4 1 3 Analyse Datas srest enia ad nea dene pie ROC RR ends nt 9 ANA BRepOIU eue epu er IePURSOPEERADTe E grep Rr ds 9 4 1 5 Close Session 1020204 da delebo bs c DU INN dues e 9 4 1 6 Additional Buttons seeeeeee RII 9 4 2 The Lama View Window eee RII 10 ASQ Node isterse ssrds rere eed ba aes ood eed 10 4 2 1 1 Add new test see nn 11 4 2 1 2 Unload testsessies aina metr hr nmt m sialla 11 4 2 4 3 Add Data to New Plot eeeeeeee 11 4 2 1 4 Add data to an Existing Plot 12 4 2 1 5 The Default Selection 0 0 00 ce cece cence
25. Lama Input and Lama View modules reguires a working Lama instance this function is extremely useful in scripts to check if an instance has been created if lama instance is created then begin print Error you need to create a Lama instance exit 1 endif 6 2 Opening and closing Lama View lama view open Function This function opens the Lama View window If the window is already opened it does nothing This function always returns a nonzero value Chapter 6 IDL Command Reference 26 lama view close Function Close the Lama View window If the windows is not open does nothing lama view is opened Function Return nonzero if the Lama View window has been opened i e the lama_view_open page 25 function has been called 6 3 Loading unloading tests lama_input_load_test dir Function This function opens the test found in the directory named dir a string and marks it as the new default test If it is successful returns a nonzero value otherwise returns Zero The dir variable can contain either an absolute path or a path relative to the current working directory However in scripts the absolute path should be preferred test_to_load home tomasi work datasets TUN_0032 result lama_input_load_test test_to_load if result eq O then begin print Unable to open the file located in test to load end if lama input unload test name Procedure This function remove test named name from memory Note that nam
26. Lama View opens the list of opened windows By pressing the desired window Lama View adds the selected nodes in the Node List to the window 4 2 1 5 The Default Selection The IDL procedures and functions See Chapter 6 IDL page 25 for details need a default test a default feed horn and a default processing type Pressing the button labeled Make Default Figure 4 3 Lama View signs as default the selected node in the Node List The default nodes are bold in the Node List Eaa new test Unload tes Daa te new plot sato xisting Plot f Make defaut Figure 4 3 Buttons in Lama View main window 4 2 1 6 Right Mouse Button Menu By clicking the right mouse button on the Node List a menu appears The menu has five possible tasks to let the user to see information about files in the dataset folder load or unload files export data to file and open a cross correlation plot e Open object information One or more fits files are associated to each terminal node of the Node List To see information about those files select one or more nodes in the Node List click right mouse button and select Open Object Information A new window is opened in which there is the view with the selected nodes and the information about the selected fits files with information about theirs contents and if they are loaded or not e Load data Select one or more nodes in the Node List click the right mouse button and select Load Data Lama View load the fits f
27. N horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned reference signal coming from channel ch See lama get sky yl page 29 lama get ref sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the standard deviation i e the root mean sguare of each binned ref sample See lama get ref y page 29 Chapter 6 IDL Command Reference 30 lama get raw y ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned reference signal coming from channel ch The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama get sky yl page 29 lama get raw sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the standard deviation i e the root mean sguare of each binned sky ref sample The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama get raw yl page 29 6 5 1 3 Accessing full scientific data The following functions provide access to the full scientific data To be able to access this data the user must specify a time range where to load the data and a binning The freguency sampling of scientific data depends on the acguisition mode and the specified binning To load the full scientific dat
28. R 30 GH7 34 GHz feed horns 70 GHz feedho ns Temperatures Ej PU temperetures 0 0 LM301332 Richt Bottom F428 0 1 LM302332 Cone Right Part 0 2 LM303332 Right Side Wall U3 LM304332 CoU Pate Far Higit 04 LM305332 FH28 Flange 0 3 LM306332 Right Bottom FI I26 0 5 LM201332 Lc Side Well 202332 r EjAcd rewiest Lniead test Ade to new pot Aca to Existing Plot gg Make default Windows currently spered Parameter E Pot window 2700 Aux file TUN 0015 2701 Aux file TUN 0015 2710 Aux file TUN 0015 2711 Aux file TUN 0215 Feed horn 27 30 GHz Processing type AVR1 Channel 00 2700 Aux file Feed horn 27 30 GHz Processing type AVR1 Channel 01 270 A ix ile Feed horn 27 30 GHz Processing type AVR1 Channel 1C 2710 Aux le Feed horn 27 30 GHz Processing type AVR1 Channel 11 2711 Ax file Coss Corr TUN 0015 2720 Aux fie Sky 27 1 Aux file Ref Feed horn 27 30 GHz Processing type AVR1 Channel 00 2700 Aux file Feed horn 27 30 GHz Processing type AVR1 Channel 11 2711 Arx file Pot window 0 0 LM301332 Rigat Bottom FH2 TUN 0015 10 LM322 32 Core Right Par TJN 0015 0 2 LM3C3332 Right Side Wall TUN 0015 0 3 M304332 Cold Plate F Bring to front E conne windows J Cbse window Figure 4 1 Lama View main window 4 2 1 Node List The node list shows a tree in which each node represents a scientifi
29. a NE n NT t v xbhhh Oooo i e zero 000 d D s S w W n A character that follows a backslash matches the character it self except where mentioned below For example if you wished to match a literal caret at the beginning of a string you would write This matches the ASCII bell character BEL 0x07 This matches the ASCII form feed character FF 0x0C This matches the ASCII line feed character LF 0x0A Unix newline This matches the ASCII carriage return character CR 0x0D This matches the ASCII horizontal tab character HT 0x09 This matches the ASCII vertical tab character VT 0x0B This matches the Unicode character corresponding to the hex adecimal number hhhh between 0x0000 and OxFFFF matches the ASCII Latin1 character corresponding to the oc tal number ooo between 0 and 0377 This matches a digit This matches a non digit This matches a whitespace space or tab This matches a non whitespace This matches a word character a letter a number or _ This matches a non word character The n th backreference e g M M2 etc Because quotes special characters is a regular expression that matches only and is a regular expression that matches only and so on A 1 Backreferences Backreferences are used to refer to a previously matched part of the regular expression When you use constructs like e g first 1st you cannot know which word w
30. a use the lama select range page 30 procedure lama select range ch min max bin TEST name HORN horn Procedure PROC TYPE proc type Load scientific data inside the specified time range min max in seconds and using bin samples for the binning i e bin equal to 1 means that there is no binning If TEST FEED_HORN and PROC_TYPE are not specified the defaults are used In order to determine if some scientific selection has been loaded you can use either lama selection is sky available page 30 and lama selection is ref available page 30 The two functions are eguivalent under Lama lama selection is sky available ch TEST name HORN horn Function PROC TYPE proc type Return nonzero if the scientific selection loaded by the last call to lama select range page 30 contains a non void stream of sky data lama selection is ref available ch TEST name HORN horn Function PROC TYPE proc type Return nonzero if the scientific selection loaded by the last call to Jama select range page 30 contains a non void stream of sky data lama selection get sky x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the time series for the scientific binned sky signal coming from channel ch If TEST FEED HORN and PROC TYPE are not specified the defaults are used If UNIT is specified return the series in the specified measure unit otherwise return time in seconds See measureUnits page 45 Chapter 6 IDL Command R
31. aNA issa sada maa osa ker alasi aes Gene paces 45 0 54L2 k seek edd TeSt atur SENA ma md i 45 0 07 CIT e per PDT 46 6 17 Log Messages c cre a RP HERE RU Rte ee PAR EE ees 48 6 8 DAE cal bration s4s s0 eiit dre T Maid Ed 50 ii Appendix A Regular expressions AD Ba ckteleronces n 24 mahaan mask eir sc R met oes A eins paleo Concept IRON uua exor utra od OR CP oo DP Function index een ii Chapter 1 Overview 1 1 Overview This is the LFI User s Guide a document which illustrates the features of LIFE 3 It is in a very rough format but it provides some useful information about LIFE from the point of view of an user There is no need to be a programmer to read this manual However knowing the IDL language will help reading those sections which describe the interface between LIFE and IDL LIFE is a package of a number of different tools They are RaNA used to test the LFI RCAs LAMA used to test the two LFI RAAs and OCA introduced with LAMA 2 0 it is a tool written by Michele Maris to test the REBA 1 1 RaNA RaNA the Radiometer aNAlyser is a tool used during the LFI OM FM RCA test cam paigns It opens FITS files produced by Rachel and let the user to calibrate the chains and perform a number of operations on the scientific housekeeping data 1 2 LAMA LAMA the LFI Array Measurement Analyser is a tool for the LFI OM FM RAA test campaigns It can read the FITS files cre
32. alues are stored in fits files in wrong way Lama shows data as they are stored in the fits files so in this case the data shown are wrong The Swap sky ref button lets the user to swap sky and reference in the plot Select the channel from the list of radiometric data and click Swap sky ref button After this operation the last column change from false to true and the background of the row become grey Clicking again the button reset sky and reference in the plot and the row in the list of radiometric data 4 3 4 2 Show gaps in scientific data During operations DAE or REBA could loose some packets Pressing the Show Gaps button let the user to know it this is happened 4 3 5 Housekeeping information The fourth tab in right side of Lama Plot shows the housekeeping statistics of the plotted data Figure 4 11 The list in this tab contains three columns The first column is the name of the housekeeping parameter The second and the third columns show mean and sigma values of the parameter in the actual plot Note that if the plot is zoomed the statistics are referred to this Chapter 4 LAMA Plot Selection Scientific Info J Housekeeping Info Manual zoom r Housekeeping Information Dataset Mean Sigma Right Bottom F 26 4034 Cone Right Part 27 7448 Right Side Wall 27 1924 Cold Plate Far Ri 25 7552 FH28 Flange 26 1739 Right Bottom F 26 525 Left Side Wall 25 1782 Cold Plate Left In 25 0559
33. apter 6 IDL Command Reference 28 This function is guaranteed to return a value which is usable by lama input select feed horn page 27 6 5 Accessing data In this section we provide the documentation for functions accessing the scien tific housekeeping data With scientific data we mean the samples coming out from the radiometers while housekeeping data include everything other stream of data recorded by SCOS2000 i e drain currents temperatures and so on 6 5 1 Scientific data The functions listed in this sections let to access the scientific data coming from the ra diometers You must know there are two kind of scientific data available with Lama Full scientific data This is the data coming from the radiometers Its sampling frequency depends on the radiometer being greater for the 70 GHz ones and the REBA processing type but it is never smaller than 1 Hz Binned data This is the default type of data loaded by Lama View Its sampling frequency is always 1 Hz regardless of the radiometer and the processing type and it is calculated from full scientific data by evaluating the mean value and the standard deviation in a time span of 1 second per each binned sample Binned data is something that is not produced by the TQL TMH software the binned datasets are created by Lama on the fly in order to reduce the time needed to load and display data The FITS files containing binned data are called AUX files
34. as matched By using n with n being a digit you can backreference a parenthesis For instance Appendix A Regular expressions 55 b w W 1 b will match hello hello because b w matches the first hello W matches and 1 matches the expression specified by w which was hello To use parentheses only to specify alternatives and not for backquoting you can use the e g current voltage This kind of parentheses is slightly more efficient because the parser has less book keeping to do Concept index 56 Concept index Concept index A Add New lest roce nrebPREE Gd ere 11 Add to Existing Plot 2 22 005 12 Add to New Plot 22b Re ona autona as 11 Analyse Datacenter yan be 9 AUX MES vuotaa aut enchants da rico aah 28 B Binned data rivedere 28 Bring to TrOnt soiva onde oe 4 vakoon aa Ee 13 C Close SESSION i 2229 obest nete isa kaada 9 Close WIDAOW criso kan mm emet RE RS 13 Combine Windows 13e saatavt ndiii eerie 13 Computing statistics lesse 19 Conventions for this manual 1 Correlation coefficient 0000 ee 22 Cross correlation plot Binned data 22 Cross correlation plot open lt 20 Cross correlation plot Reset 0 lt 21 Cross correlation plot Save Data 21 Cross correlation plot Show error bars 22 Cross correlation plot Show fit 22 Cross cor
35. ated by TM2TOI and perform a number of analysis similar to RaNA In order to simplify the analisys for the 44 FM RCAs the analysis modules now have a command line interface which eases the use of scripts to perform automatic procedures 1 3 OCA OCA is a tool written by Michele Maris maris oats inaf it to test the REBA 1 4 Conventions used in this manual This reference lists the IDL procedures and functions defined by LIFE and accessible through the IDL command line Here is a list of the conventions we used in this manual e IDL procedures are marked with Procedure They never return a value and are called by following their name with a command and a list of arguments An example is ama instance close page 25 e IDL functions are marked as Function Their return value is described in the text following the function definition When calling a function you must provide the argu ments enclosed into rounded brackets Brackets should be used even when the function has no arguments An example is ama instance is created page 25 e When providing an example we use the symbol to indicate what is the output of the commands e g print Hello world Hello world e Every procedure and function described in this manual is listed in the Function index page 58 if it is not it is a bug Chapter 1 Overview You can download a PDF version of this manual at http belzebu lambrate inaf it lifedocs life manual
36. c node or an housekeeping node Figure 4 2 The root of the tree is the test of the desired data The scientific nodes are ordered by freguency 30 GHz 44 GHz 70 GHz horn from 18 to 28 and channel 4 for each horn The housekeeping nodes are divided in groups temperatures voltage and currents of the FEM DAE and REBA parameters Each node is selectable and must be selected in order to perform all the operations that are shown in the next sections Chapter 4 LAMA 11 Lama View Jataset tree Parameter E TUN 0015 O Scientific cata E 30 GHz feed homs l Feed horn 27 30 GHz E Processing type AVR1 F 44 GHz feed homs 70 GHz feed ho ns Ej FPU temperetures 0 0 LM301332 Richt Botiom F428 0 1 LM302332 Cone Right Part 0 2 LM303332 Right Side Wall 0 3 LM304532 CoU Mate Far Kight 04 LM305332 FH28 Flange 0 5 LM306332 Right Dottom FI 126 0 5 LM201332 Le Side Well 0 7 LM302332 Cold Plate Left Inner 03 LM203332 Cold Plate Right Inrer 03 12043321 e Rottem FH25 0 10 LM205332 Cold Plate Far Left 0 11 LM206332 Cone Left Fart E 3EU temperstures FEN currestsand voltages E Phase switch 4 KHz status E Phase switch position DAEgain 3 VAE oset REBA parameters S rewiest Lnicad te st Cae 10 new pot Oaa 1 Existing Plot v mare default Figure 4 2 Node List in Lama View main window 4 2 1 1 Add new test When Lama View is o
37. d select the directory in which are saved the TUN_0015 test Click open Now the test is opened and Lama View appears like in Figure 2 2 Chapter 2 Tutorial 4 Lama View Dataset tree Parameter TUN_0015 fp Ada new test Unload test Ega to new plot jada to Existing Plot yf Make default Windows currently opened 75 Bring to front 3 Combine windows Close window Figure 2 2 Lama View after the loading of the TUN 0015 test Click on the symbol to expand the tree In this example we plot the feed horn 27 Select this feed horn and click the button labeled Add to New Plot as in Figure 2 3 to open the new window Select in Node List with ctrl pressed other nodes to open more than one feed horn or housekeeping data Parameter TUN 0015 B Scientific data Ej 30 GHz feed horns Feed horn 28 30 GHz 44 GHz feed horns 70 GHz feed horns amp Temperatures FEM currents and voltages Phase switch 4 KHz status Phase switch position DAE gain DAE offset REBA parameters EJ E 9 E E EJ Figure 2 3 How to open new Lama Plot window The new window appears like in Figure 2 4 We can see on the left the plot with the data opened on the top left the possible plot operation on the right one tab with different possibilities and the legend of the plot Chapter 2 Tutorial 5 Plot window 2700 Aux file TUN 0015 2701 Aux file TUN 0015 2710 Aux file TUN 0015 2711 Aux file TUN 0015
38. e Function Change the current node for the test named name to the node specified by path If name is not provided set the current node for the default test Return true nonzero if the node was found and selected false zero if path is not a valid path If you want to extract multiple pieces of information from the same node e g the name the description and the type it is faster to set that node as the current one Print information about the blanking time parameter x lama input set current node REBA parameters amp LM100326 print Name lama input get node name print Description lama input get node description print Type lama input get node type Apart from the small increase in the speed this also produces cleaner code 6 5 3 3 Retrieving scientific housekeeping data lama input get hk node pair path TEST name Function Return the pair of numbers tab index used by functions like lama get hk y page 36 for the housekeeping node specified by path and belonging to the test named name If path is not specified use the current node If name is not specified use the default test If the node specified by path is not valid or is not an housekeeping parameter i e the value returned by lama_input_get_node_type page 42 is not equal to 9 the function returns 1 There are two other functions that returns the node path of an AUX selection housekeepingf files They are lama
39. e it is calculated in the current statistical range see lama get statistic range page 33 The result is a two valued array where the first value refers to the sky the second to the reference load If X UNIT keyword is not specified then the function uses seconds for time series If UNIT is not specified then the function returns values in Volt See measureUnits page 45 Chapter 6 IDL Command Reference 33 lama selection get binning TEST test FEED HORN horn Function PROC TYPE proc type Return the binning used in the last call to lama select range page 30 to load a selection of scientific data for the specified feed horn and processing type If TEST FEED HORN and PROC TYPE are not specified the defaults are used lama selection get nsamples ch TEST test FEED HORN horn Function PROC TYPE proc type Return the number of samples loaded during the last call to lama select range page 30 to load the scientific data for channel ch If TEST FEED HORN and PROC TYPE are not specified the defaults are used lama selection get range TEST test FEED HORN horn Function PROC TYPE proc type Return the time range used in the last call to Jama select range page 30 The result is a two valued array containing the two time limits in seconds where scientific data has been selected lama selection get sci avg ch TEST test FEED HORN horn Function PROC TYPE proc type X UNIT x measure unit UNIT y measure unit Return the mean of the s
40. e must be the name of the test not the full directory See lama input get list of tests page 27 lama input is test available Function This function returns nonzero if at least one test has been loaded See lama input load test page 26 lama input select test name Function This function makes name the default test Every time a function which provides the TEST keyword e g lama get sky y page 29 is called without specifying it the test passed to lama input select test will be used The function will return true nonzero if the test was selected false if the specified test does not exists i e it has not been loaded name must be one of the strings returned by lama input get list of tests page 27 lama input get selected test Function Return a string containing the name of the currently selected test Here is an example of use Save the currently selected test saved test lama input get selected test Load a new test lama input load test home tomasi work datasets XXX 0012 Chapter 6 IDL Command Reference 27 Do whatever you want with XXX 0012 Now select again the old test lama input select test saved test lama input get list of tests Function Return an array of strings containing the currently loaded tests Each string contains only the test name not the full path You can use any of them with lama input select test page 26 and lama input unload test page 26 this is guara
41. e series for the scientific binned sky signal coming from channel ch If TEST FEED HORN and PROC TYPE are not specified the defaults are used If UNIT is specified return the series in the specified measure unit otherwise return time in seconds See measureUnits page 45 lama get ref x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the time series for the scientific binned reference signal coming from channel ch See lama get sky x page 29 lama get raw x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the time series for the scientific binned reference signal coming from channel ch The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama get sky x page 29 lama get sky y ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned sky signal coming from channel ch If no_ofs is nonzero the values will have their mean removed from the data i e they will have zero mean The PGA CORRECT and RAW keywords are implemented for compatibility with RaNA See measureUnits page 45 lama get sky sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the standard deviation i e the root mean sguare of each binned sky sample See lama get sky yl page 29 lama get ref y ch TEST test FEED HOR
42. e window After the release of the button Lama Plot updates the plot drawing data contained in the rectangle If the user presses the right mouse button and moves the mouse Lama Plot draws a rectangle in the plot After the release of the button Lama Plot updates the plot zooming out with in the center the content of the rectangle 4 3 1 2 Navigating into the data Using the Navigation buttons Figure 4 6 it s possible to navigate backward and forward in the different zooms applied by the user to the plot Note that columns mean and sigma in the data information box will show information which is related with the portion of the plot shown in the plot window Zooming in or out in the plot will make these values change 4 3 1 3 Select data When the Select button is selected Figure 4 6 it s possible to select data into the plot by pressing the right mouse button and moving it After the release Lama Plot stores the begin and the end of the x range selected This operation is possible only for scientific data The next operation is to load selected data see ScientificSelection page 16 for details Chapter 4 LAMA 15 4 3 1 4 Pan plot When the Pan button is selected Figure 4 6 it s possible to pan the plot If the right mouse button is pressed when the user moves the mouse into the plot then the plot is moved After the mouse release the plot is in the last position 4 3 1 5 Reset plot Clicking the button labeled Reset
43. easure unit to use Here is a list of supported measure units as well as the function which support them 0 Clock ticks lama get sky x page 29 lama_get_ref_x page 29 lama get raw x page 29 lama selection get sky x page 30 lama selection get ref x page 30 lama selection get raw x page 31 lama get hk x page 36 1 Seconds s lama get sky x page 29 lama get ref x page 29 lama get raw x page 29 lama selection get sky x page 30 Chapter 6 IDL Command Reference 46 lama selection get ref x page 30 lama selection get raw x page 31 lama get hk x page 36 2 Raw radiometer output ADU lama get sky yl page 29 lama get ref y page 29 lama get raw y page 29 lama selection get sky y page 31 lama selection get ref y page 31 lama selection get raw yl page 31 3 Radiometer output V lama get sky y page 29 lama get ref y page 29 lama get raw y page 29 lama selection get sky y page 31 lama selection get ref y page 31 lama selection get raw yl page 31 4 Radiometer output without DAE offset V lama get sky yl page 29 lama get ref y page 29 lama get rawy page 29 lama selection get sky yl page 31 lama selection get ref y page 31 lama selection get raw yl page 31 5 Temperature K lama get hk yl page 36 when applicable 6 Photometric calibration constant V K this measure unit is for internal use only 7 Raw housekeep
44. eference 31 lama selection get ref x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the time series for the scientific binned reference signal coming from channel ch See lama selection get sky x page 30 lama selection get raw x ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit Return the time series for the scientific binned sky reference signal coming from channel ch The sky and reference samples are alternating in order to mimic the way they come from the BEU See lama selection get sky x page 30 lama selection get sky y ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned sky signal coming from channel ch For a discussion about UNIT PGA CORRECT and RAW see lama get sky y page 29 lama selection get sky sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the standard deviation i e the root mean sguare of each scientific sky sample See lama selection get sky y page 31 lama selection get ref y ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRECT pga RAW raw Return the data series for the scientific binned reference signal coming from channel ch See lama selection get sky yl page 31 lama selection get ref sigma ch TEST test FEED HORN horn Function PROC TYPE proc type UNIT unit PGA CORRE
45. elected scientific reference data for channel ch The result is a two valued array where the first value refers to the sky the second to the reference load If X UNIT keyword is not specified then the function uses seconds for time series If UNIT is not specified then the function returns values in Volt See measureUnits page 45 lama selection get sci sigma ch TEST test FEED HORN horn Function PROC TYPE proc type X UNIT x measure unit UNIT measure unit Return the standard deviation of the selected scientific reference data for channel ch The result is a two valued array where the first value refers to the sky the second to the reference load If X UNIT keyword is not specified then the function uses seconds for time series If UNIT is not specified then the function returns values in Volt See measureUnits page 45 lama is statistic range selected TEST test Function Return nonzero if the user has selected a range for computing statistics through one of the Lama Plot windows See Manual Operations page 19 If test is not specified the default one will be used lama get statistic range TEST test Function Return the range used by lama get sci ave page 32 and lama get sci sig page 32 to do statistics If test is not specified the default one will be used Chapter 6 IDL Command Reference 34 6 5 1 5 Photometric calibration Lama has the ability to perform a photometric calibration to convert the voltages coming out f
46. es e g AVRI and COM5 you have to provide two calibration curves To determine if a channel already has a calibration curve associated with its scientific data use the Jama is channel calibrated page 34 function lama is channel calibrated ch TEST test FEED HORN horn Function PROC TYPE proc type Return nonzero only if channel ch has a photometric calibration curve This happens when one of the following two conditions are met 1 The function lama set calibration page 34 has been called for this channel during the current working session 2 There is a FITS file in the toi directory of the test named test the default test if not specified which contains a valid calibration curve for the specified channel 6 5 1 6 Miscellanea The following two functions are designed to get the path of a scientific node for further use with browsing functions like lama input get node description page 41 see section IDLBrowse page 38 Chapter 6 IDL Command Reference 35 lama get aux path ch TEST test FEED HORN horn Function PROC TYPE proc type Return the path of the AUX data node associated with channel ch test test feed horn horn and processing type proc type lama get selection path ch TEST test FEED HORN horn Function PROC TYPE proc type Return the path see section IDLBrowse page 38 of the node associated with the scientific selection of channel ch test test feed horn horn and processing type proc_type This pat
47. et hk yl page 36 and return the X data series time and the Y data series whose meaning depends on the parameter being selected lama get hk x nameltab element TEST test UNIT measure unit Function Return the X data stream time associated with the specified housekeeping parame ter If test is not specified the default one will be used If UNIT is not specified return time in seconds See measureUnits page 45 The function can be called in two ways 1 When used with one parameter name you pass a string containing the LM code of the parameter 2 When used with two parameters tab element you pass the tab and element numbers of the housekeeping Tabs and elements are the remnants of the way old Lama 1 0 handled housekeepings and should be avoided in new code You should prefer to use the LM code as it is guaranteed not to change between different tests This is the first form The name refers to the drain current of FHH27 M1 x1 lama get hk x LM051322 And this is the second one Note that the housekeeping specified by the 1 15 pair is not always the same but depends on the test currently loaded x2 lama get hk x 1 15 Chapter 6 IDL Command Reference 37 lama get hk y nameltab element TEST test UNIT measure unit Function Return the X data stream time associated with the specified housekeeping param eter If test is not specified the default one will be used UNIT specifies t
48. exit the program close the session pressing the button labeled Close Session in Lama Top Now exit the program For more details about Lama View see See Section 4 2 View page 10 Chapter 3 RaNA 3 RaNA Chapter 4 LAMA 9 4 LAMA This chapter provides an overview of the LAMA Lfi Array Measurement Analyser soft ware It is divided into two main parts the lama top section describes the functionality of the lama main window the lama view section and the following describe how to access to the data and plot them The purpose of LAMA is to load and analyse data aguired during the LFI RAA FM test campaign It provides a graphical user interface to load the data saved during the tests plot scientific and housekeeping values and provides a number of analysis tools to estimate the tuning parameters and the performances of the instrument 4 1 The Lama Top Window The main window of Lama is the Lama Top window see image Through this window the user can use Lama utilities the Lama View software the analyisis modules and the report The next sections describes how the buttons of the Lama Top window work 4 1 1 Start Session The first operation when the user open Lama is to start a session A session is a folder where all the operations made during the work are stored The predefined folder is the home folder but the user can change it by pressing the brwose button and choosing another folder If the user doesn t open a session it
49. for the Lama Plot window The navigation buttons also work in the same way as those for the Lama Plot window Note that columns x y and z in the data information box will show information which is related with the portion of the plot shown in the plot window Zooming in or out on the plot will make these values change NOTE The zoom button will probably be removed in the near future since there is no other navigation mode available for the cross correlation window 4 4 2 2 Save data The Save Data button will save data to an ASCII file To save data click the Save Data button and select a directory where you would like the data file to be stored The name of the file will be automatically generated from the X and Y data in the plot There are two different formats for the ASCII file generated by pressing the Save Data button 1 Unbinned data If the Bin button is not checked the file will contain two columns the first containing X data and the second Y data Note that this is not necessarily the actual raw data as some binning might have already ocurred to deal for instance with different sampling rates for the X and Y timestreams 2 Binned data If the Bin button is checked the file will contain five columns the first contains X corresponding to the center of the bins the second the average of all X values contributing to the bin the third the error associated with the bin average in column 2 the fourth the binned valued of Y and the fifth and
50. g the name of the calibration set being used for the test named name If path is not specified the current test will be used If an error occurred during the execution of this function the value 0 is returned lama set default calibration set new set TEST name Function Select the new calibration set to be used for the test specified by name or for the default test if the TEST keyword is not specified The value of new set must be one of the strings returned by lama get calibration sets If an error occurred during the execution of this function the value 0 is returned The following example shows how to use these three functions to set up the calibration set for the default test 333 Retrieve the list of calibration sets available for the default test list of calibrations lama get calibration sets Check that the operation was successful e g that at least one testi 33 has been loaded if keyword set list of calibrations then begin We now try to select a new calibration if lama set default calibration set CoolestCalibrationEver then begin Done We have successfully changed the configuration print The new DAE calibration is lama get default calibration set Of endif else begin something went wrong warn the user print Error Unable to set the DAE calibration endelse endif Of course in a real world you would check that CoolestCalibrationEver is one of the supported calibrations b
51. get aux path page 34 lama get selection path page 35 and lama get hk path page 37 Refer to sections IDLScientific page 28 and IDLHK page 36 for further information 6 5 3 4 Unloading data from memory Some node types have the ability to load data from FITS files These are the AUX scientific and housekeeping nodes their types are respectively 7 8 and 9 see lama input get node type page 42 There is no need for the user to tell when to load the FITS files because Lama is smart enough to load them when needed Starting from version 3 0 Lama gives the user the ability to unload the data loaded from FITS files This can save a lot of memory expecially when performing automated tests where a number of radiometric channels and housekeeping parameters must be accessed seguentially Unloaded data can be reloaded by Lama if they are needed again Also if you unload data that are plotted in a window the window will continue to be usable as each window maintains a local copy of each data stream Chapter 6 IDL Command Reference 44 lama input unload node path TEST name Procedure This function unloads any data associated with the node pointed by path If the node does not contain any datum the function does nothing This function will not free data associated with child nodes use lama input unload subtree page 44 The following function is a wrapper for lama input unload node page 43 which also frees the memo
52. ggers are mainly used for tuning tests we chose to use the same FEM numeration in the functions dealing with triggers lama_input_get_list_of_triggers start end channel time Function lama_input_get_trigger is an high level procedure wrapped around lama_input_ find_trigger It is used to find a list of start end trigger pairs found in the test The start trigger is coded by start while the end trigger is coded by end The time parameter specifies the start time where to look for triggers The return value of this function is a 2 times N matrix where each row contains the start and end time of each trigger If no triggers with the specified start end codes exist in the current test the function returns 1 Search for print lama input get list of triggers 1 2 101 0 0 lama input find trigger channel code time TEST test Function lama input find trigger looks for a trigger with code code and associated with the FEM channel channel into the specified test test or the default test if TEST is not specified The first trigger occurring at a time greater than time is returned If no suitable trigger is found return 1 Chapter 6 IDL Command Reference 48 This example looks for the first start end trigger in the test and then select data inside No error checking is made start lama input find trigger 101 1 0 0 Note that we start our search from time START instead of 0 0 end time lama input find trigger 101 2
53. h TEST test FEED HORN horn Procedure PROC TYPE proc type Free any memory associated with the AUX datastream for channel ch test test feed horn horn and processing type proc type Chapter 6 IDL Command Reference 36 lama input unload selection ch TEST test FEED HORN horn Procedure PROC TYPE proc type Free any memory associated with the scientific selection for channel ch test test feed horn horn and processing type proc type Calling this function when there is no scientific solution does not harm the function will silently returns with no error Note that unlike lama select range page 30 this function will operate on one chan nel rather than on all the scientific channels of a feed horn 6 5 2 Housekeeping data lama get hk name tab element TEST test Function Return the name of an housekeeping parameter It can be in the form LMxxxxxx with each x being a digit for housekeeping parameters recorded by SCOS2000 or Hfm XXX nn with XXX being a lowercase name and nn a number for cryofacility tem peratures lama get hk description namel tab element TEST test Function Return the description of an housekeeping parameter It is an human readable de scription of the parameter e g Drain current for 2700 For an explanation of the parameters of this function see lama get hk x page 36 There are two functions to get the data associated with an housekeeping file They are lama get hk x page 36 and lama g
54. h can be used with a number of browsing functions like lama input get node description page 41 Note that this function works even if no selection has been loaded yet for the specific channel It simply returns a path to the position where the selection would be loaded The following functions are specializations of ama input unload node page 43 and are useful when you have completed some elaboration on a feed horn or radiometric channel and want to free some memory See also lama input unload hk page 38 Refer to section IDLUnloadData page 43 for more information about unloading data from memory lama input unload feed horn feed horn num TEST test Procedure This function unloads any X and Y data associated with the feed horn number feed horn num this includes any selection made through lama select range page 30 You can still call lama get sky x page 29 lama get sky yl page 29 lama get ref x page 29 and lama get ref y page 29 after a call to this function Lama will silently load the data again The following example shows how to save some memory when processing data from feed horns Retrieve sky data from feed horn 27 30 GHz feed horn 27 x lama get sky x feed horn y lama get sky y feed horn We have the sky data available into the two IDL vectors X and Y so we can unload it from Lama View lama input unload feed horn feed horn Now use X and Y freely lama input unload aux c
55. he desired measure unit See measureUnits page 45 For an explanation of the parameters accepted by this function see lama get hk x page 36 6 5 2 1 Housekeeping Statistics lama get env ave ch hk tab hk element TEST test Function X UNIT x measure unit Y UNIT y measure unit Return the mean of the housekeeping parameter hk tab hk element The mean is calculated in the current statistical range see lama get statistic range page 33 If X UNIT keyword is not specified then the function uses seconds for time serie If Y UNIT is not specified then the function uses RAW data for data serie See mea sureUnits page 45 lama_get_env_sig ch hk_tab hk_element TEST test Function X_UNIT x_measure_unit Y UNIT y measure unit Return the sigma of the housekeeping parameter hk tab hk element The mean is calculated in the current statistical range see lama get statistic range page 33 If X UNIT keyword is not specified then the function uses seconds for time serie If Y UNIT is not specified then the function returns raw uncalibrated data See measureUnits page 45 6 5 2 2 Miscellanea The following function is designed to get the path of an housekeeping node for further use with browsing functions like lama input get node description page 41 see section IDLBrowse page 38 lama get hk path namel tab element TEST test Function Return the path of the data node associated with the housekeeping parameter with
56. he return value of lama input get num of log messages page 48 Each element of the array is a structure with three fields time The same value as returned by lama input get log time page 48 time str The same value as returned by lama input get log time str page 49 text The same value as returned by lama input get log text page 49 If test does not exist or if no log message was recorded the function returns 1 If the TEST keyword was not specified the default test will be used See lama input get selected test page 26 6 8 DAE calibration The DAE calibration tables are used to convert the digital output produced by the DAE into a voltage Three tables are required 1 A TSCAL file which associates the DAE gain levels with the actual gains 2 A TZERO file which includes a usually small correction to be applied to the voltage after having applied the TSCAL table 3 A OFFSET file which associates the DAE offset levels with the actual offsets Within LAMA these three tables are named a calibration set Up to LIFE 3 1 only two calibration sets were required one for the Qualification Model QM and the other one for the Flight Model FM LAMA decided which calibration table to apply according to the instrument type information read from the test files But we must consider that in the future there will be the need to update the calibration tables more than once e A new calibration table to be
57. ific Info Housekeeping Info Manual zoom Range Load Selection Start 164190 gi Unload Selection End 164484 G Hide Binning fi J Selection Plot 0 0 164 200 164 250 164 300 164 350 164 400 164 450 Figure 4 9 The plot selection tab 4 3 4 Radiometric Operations The third tab in right side of Lama Plot shows the radiometric statistics of the plotted data Figure 4 10 The list contains 6 columns The first column is the name of the channel and the file AUX or Scientific The second and the thrid columns show the mean and the sigma values of the sky data stream the fourth and the fifth the mean and the sigma values of the reference data stream The last column is boolean the shows if the sky and reference data stream are swaped of not Note that if the plot is zoomed the statistics are referred to this Chapter 4 LAMA 18 Plot Selection Scientific into Housekeeping Info Manualzoom r Scientific Information Dataset Sky Mean Sky Sigma Ref Mean Ref Sigma Swap 2700 Aux file 1 82461 0 503435 0 nan False 2701 Aux file 0 nan 180704 0446546 False 2710 Aux file 1 69359 0 502792 0 nan False 2711 Aux file 0 nan 135117 0 365767 False Swap Sky Ref LJ Calibrate to Kelvin O Show gaps in scientific data Figure 4 10 The plot operations tab 4 3 4 1 Swap sky and reference If the DAE inverts sky and reference values those v
58. iles associated to the selected nodes After this operation the loaded nodes are in italics character e Unload data Select one or more nodes in the Node List click the right mouse button and select Unload Data Lama View unload the fits files associated to the selected nodes After this operation the unloaded nodes returns to normal character e Export data to file Select one or more nodes in the Node List click the right mouse button and select Export data to file Lama View opens new window in which the user can select the name of file and the place where it must be saved The file format is CSV Comma Separated Values a text file in which data are stored in the same row separated by commas It s the simpler text format that can be imported in Excel or OpenCalc e Cross correlation plot Select two nodes in the Node List click the right mouse button and select Cross correlate plot Lama View load the fits files associated to the selected nodes if necessary and then open a new Cross correlation plot that shows the cross correlation plot between the two selected nodes See Section 4 4 Cross page 20 for details Chapter 4 LAMA 13 4 2 2 Window List The Window List shows the list of all plot windows opened either Lama Plot either Lama Cross with theirs titles Figure 4 4 Expanding one node of the list Lama View shows the content of the expanded node e Bring to front Selecting one window from the Window List and clic
59. ing data DEC lama_get_hk_y page 36 when applicable 100 Pure number lama_get_hk_y page 36 when applicable If you do not specify a UNIT keyword Lama will use an appropriate default choice e Time is expressed in seconds UNIT 1 e Radiometric output is expressed in voltages UNIT 3 e Housekeeping parameters are expressed using their natural measure unit e g tem perature UNIT 5 Please note that Lama supports also the old RAW and PGA_CORRECT keywords in functions returning radiometric output but their use is now discouraged in favour of the more general UNIT keyword To upgrade the old code here are some rules 1 If no PGA CORRECT nor RAW keyword is specified the result is the same as using UNIT 3 2 If PGA CORRECT is set to zero the result is the same as using UNIT 4 3 If RAW is specified the result is the same as using UNIT 2 The following function is useful when you get lost while using Lama from the command line Basically it provides you the same table shown above lama dump measure units Function Print a table containing the list of measure units available 6 6 Triggers All the trigger functions explained in this section use a peculiar way to specify the LFI channels Unit Code Unit Code FH 27 rad 0 ch 0 101 FH 20 rad 0 ch 0 129 FH 27 rad 0 ch 1 102 FH 3 20 rad 0 ch 1 130 Chapter 6 IDL Command Reference 47 FH 27 rad 1 ch 0 103 FH 20 rad 1 ch 0 131 FH 27
60. ions to access these messages lama input get num of log messages TEST test Function Return the number of log messages recorded by the TOL for test named test If test does not exist the function returns 1 If there are no log messages recorded it returns 0 If the TEST keyword was not specified the default test will be used See lama input get selected test page 26 Chapter 6 IDL Command Reference 49 lama input get log time TEST test Function Return an array of double values containing the time in second when each log message was recorded by the TOL These times are comparable with those returned by e g lama get sky x page 29 The number of elements in the array should match the return value of lama input get num of log messages page 48 If test does not exist or if no log message was recorded the function returns 1 If the TEST keyword was not specified the default test will be used See lama input get selected test page 26 The first and the last log message usually mark the beginning and the end of the test We use them to estimate how long the test lasted log time lama input get log time num of logs n elements log time if num of logs gt O then begin print The test lasted log time num of logs 1 log time 0 endif lama input get log time str TEST test Function Return an array of strings containing the date and time when each log message was recorded by the TOL The number
61. ix operator that specifies repetition between N and M times that is the preceding regular expression must match at least N times but no more than M times If M is omitted then there is no upper limit but the preceding regular expression must match at least N times Appendix A Regular expressions 53 vai is an alternation that is it matches any of the regular expression enclosed between the For instance fh FH feed horn will match either fh FH or feed horn Parentheses is also used in backreferences see backreferences page 54 is a character set which begins with and is terminated by In the simplest case the characters between the two brackets are what this set can match Thus ad matches either one a or one d and ad matches any string com posed of just as and ds including the empty string from which it follows that c ad r matches cr car cdr caddaar etc You can also include character ranges in a character set by writing the starting and ending characters with a between them Thus a z matches any lower case ASCII letter Ranges may be intermixed freely with individual characters as in a z which matches any lower case ASCII letter or 4 or period Note that the usual regexp special characters are not special inside a character set A completely different set of special characters exists inside character sets and To include a in a character set you must make it the fi
62. king the Bring to front button the selected window is brought to the front of the desktop e Combine windows Selecting two or more windows from the Window List and clicking the Combine windows button the selected windows are closed and the data contained in all the windows are shown in a new plot window The selected windows disappear from the Window List and a new item appear that represents the new window e Close window Selecting one or more windows from the Window List and clicking the Close window button the selected windows are closed and disappear from the Window List Parameter Plotwindow 2 00 ALX tle IUN UU15 2 017 Aux tile JUN UL15 2 10 Aux tile JUN UU15 2 11 Aux tile 1 UN_UU15 Feed hurr 27 30 GHz Processine type AVR1 Channel 00 2700 Ax file Feed horn 27 30 GHz Processinc type AVR1 Channel 01 270 Aux file Feed horn 27 30 GHz Processinc type AVR1 Channel 12 2710 Aux file Feed horn 27 30 GHz Processinc type AVR1 Channel 11 2711 Aux file B Cross Corr TUN 0015 2700 Aux file Sky 271 Aux file Refi Feed horn 27 30 GHz Processinc type AVR1 Channel 00 2700 Aux file Feed horn 2 30 GHz Processing type AVR1 Channel 11 2 11 Aux tile Plotwindow 0 0 LM301332 Right Bottom FII20 TUN 005 0 1 LM302332 Cone Right Part TUN 0015 0 2 LM303232 Rigat Side Wall TUN OC15 0 3 M204332 Cold P ate F FPU temperatures Right 3otiom FH28 FPU temperatures
63. named DAE gain for FH27 it will be included into r2 but not into r1 To make the two searches exactly the same you can use the special characters and see Appendix A Regular expressions page 52 for an explanation of their meaning Now ri and r2 are the same ri lama input find nodes DAE gain amp recursive r2 lama input find nodes DAE gain amp recursive regexp 6 5 4 Using measure units 6 5 4 1 RaNA RaNA implements a simple way to specify which measure unit to use when asking for scien tific data Functions returning a radiometric output datastream lama get sky yl page 29 lama get ref y page 29 lama_selection_get_sky_y page 31 lama selection get ref yl page 31 implement the keywords RAW and PGA CORRECT for this purpose Their meaning is the following e If no PGA CORRECT nor RAW keyword is specified the array returned by the function will contain voltages e If PGA_CORRECT is set to zero the array returned by the function will contain voltages but the DAE offset correction will not be applied e If RAW is specified the array returned by the function will contain raw ADU values The default behavior is therefore to return a stream of voltages 6 5 4 2 Lama Lama implements a simple and powerful way to specify measure units when asking for scientific or housekeeping data by means of the UNIT keyword The argument for the UNIT keyword is a number specifying the m
64. ng the Normalize Data button Lama Plot updates the plot drawing each node plotted in the image in a range between 1 and 1 Chapter 4 LAMA 16 Plot Selection ScientificInfo Housekeeping Info Manual zoom Overall operation Show plain data Remove mean Normalize to 1 1 Figure 4 8 The plot operations tab 4 3 3 Scientific Selections The second tab in right side of Lama Plot let the user to load scientific data Figure 4 9 The data plotted in Lama Plot are the values contained in AUX files in which the scientific data are binned at the frequency of 1 Hz If the user needs to see the complete values has to load them from the scientific files e Pressing the Load Data button Lama Plot loads values from the scientific fits files in the range selected in the plot with the choosen bin value and append them to the Node List After this operation the scientific nodes in the Node List appeats in italic character e Pressing the Unload Data button Lama Plot unloads the scientific fits files removing them from the Node List After this operation the scientific nodes in the Node List appeats in normal character e Pressing the Show Data button Lama Plot shows the loaded scientific data in a subplot After this operation the Show Data button changes its name in Hide Data If the user presses the button another times Lama Plot hide the subplot and brings back the name to Show Data Chapter 4 LAMA 17 Plot Selection Scient
65. ng to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used If the node does not contain data e g if it is a group node 1 will be returned lama input get node y units path TEST name Function Return an array of IDs containing the valid measure units to be used for the Y data of node with path path and belonging to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used If the node does not contain data e g if it is a group node 1 will be returned lama input get node unit name unit id path TEST name Function Return a string containing the short name e g s for seconds of the measure unit with ID unit id The measure unit must belong to the node specified by path and to the test named name If path is not specified the current node in the test will be used see current node page 42 If name is not specified the current test will be used Note that this function does not distinguish between X and Y measure units this means that you can use it either with IDs returned by lama input get node x units page 41 and lama input get node y units page 41 If the node does not contain an unit with ID unit id an empty string will be returned lama input get node unit full name
66. nteed to work if it does not it is a bug This code will select the first tests as the default tests loaded lama input get list of tests if lama input select test tests loaded 0 then begin print Error unable to load test tests loaded 0 endif 6 4 Feed horns lama input select feed horn feed TEST test Function Set feed to be the default feed horn for test named test If the TEST keyword it is not specified the default test will be used See lama input select test page 26 The feed variable can be specified in three ways 1 A string with the feed horn number alone e g 28 2 A string with the pound character followed by the feed horn number e g 4287 3 The number of the feed horn e g 28 This is useful when you are selecting horns in a for loop The function will return true i e nonzero if the feed horn was selected false if the feed horn does not exists or its output has not been recorded by SCOS during the specified test This code will cycle through all the 11 feed horns for i 18 28 do begin if lama input select feed horn i then begin print Error with feed horn i skipping endif else begin Do some operation on feed horn number I endelse endfor lama input get selected feed horn feed TEST test Function This function will return the selected feed horn for test named test or for the default test if TEST was not specified See lama input select test page 26 Ch
67. pened the Node List is void In order to show some data is necessary that the user chosees a dataset Pressing the button labeled Add new test Figure 4 3 the software open a window where it s possible to choose the folder in which the desired data are stored After this operation Lama View shows the new root of the dataset 4 2 1 2 Unload test When a dataset is no more usefull or if the memory of the pc is full it could be necessary to unload some data Pressing the button labeled Unload test Figure 4 3 the software unload one or more selected dataset from the Node list It s necessary that the user select one or more root in order to perform this task After this operation the tree is updated without the unloaded data 4 2 1 3 Add Data to New Plot In order to view data in a plot to analyze them Lama View let the user to open a Lama Plot window See Section 4 3 Plot page 13 for details Pressing the button labeled Add Data to New Plot Figure 4 3 Lama View opens new Lama Plot window with data selected in the Node List If the user selects one node which one or more children all of them are plotted in the new window After this operation Lama View update the Windows List tree adding the new opened Lama Plot window Chapter 4 LAMA 12 4 2 1 4 Add data to an Existing Plot Observing one plot it could be usefull compare data shown in the plot window with other data Pressing the button labeled Add data to an Existing Plot Figure 4 3
68. ping parameter matching the LM code of the DAE parameter and then retrieving the tab number and tab index reguired by lama get hk yl page 36 LM001326 is the code for the DAE gain of FH 27 channel 00 node path lama input find nodes LM001326 amp recursive name pair lama input get hk pair node path gain lama get hk y pair 0 pair 1 If regexp is nonzero the pattern will be considered a regular expression This provides an extremely powerful tool to search into a tree For instance the following code will print a list of nodes whose description either contains Feed horn feed horn FH or fh followed by a two digit number with optional space between them result lama input find nodes Ff eed horn FH fh s d d recursive regexp Chapter 6 IDL Command Reference 45 For more information about regular expressions see Appendix A Regular expres sions page 52 Note that if regexp is true then lama_input_find_nodes will return all the nodes whose name matches the regular expression while if regexp is false it will return all the nodes whose description or name if name is used is exactly equal to pattern Therefore in this example r1 and r2 are not necessarily equal ri lama input find nodes DAE gain amp recursive r2 lama_input_find_nodes DAE gain amp recursive regexp This happens because if there is a node
69. pling rates or when the sampling rate is the same for the two data streams but the sampling times are not synchronised some binning will automatically be performed and therefore the points displayed are not necessarily the real data points Cliking again to uncheck the box will return to the line plot The same action is obtained from the legend pop up menu Selecting Change Style gt Points from the menu when selecting a plot in the legend will also show the data points 4 4 4 4 Show error bars To show error bars in the plot click on the Show Error Bars check button after choosing which error bars to dsiplay using the radio buttons labeled X and Y It is not possible to display error bars before binning the data Cliking one more time will hide the error bars As mentioned before See Swap Axes page 21 it is not possible to display error bars when the axes are swaped 4 4 4 5 Bin data There are two ways to bin data 1 Choose the number of points you want on the binned plot by clicking on the Bin Count radio button entering the number of points in the box and checking the check button labeled Bin This will produce regularly distributed points 2 Choose the number of points you want on each bin by checking the radio button labeled Bin Size and proced as in 1 This will produce irregularly distributed points in the plot To change the number of bins data points per bin change the number in the edit box and click on bin again 4 4
70. relation plot Show points 22 Cross correlation plot Swap Axes 21 Crosscorrelation plot open ossi 12 D DAE calibration calibration 50 E Export data to file simaa eere es 12 F L L ma example 3 i4 eee b Kana taos 3 57 Lamia Open scien ob eh ae qb qe usce 9 Load D8t izkiuieijeesteev i empdemee 12 16 M Make Default 2 uestem aina od es 12 Manual Zootn 22 eI e e bates eee 19 Measure units oloon nnen 45 Messages Log vuus sniastuk evumt ea ee xe 48 N Node List i oe mas td booli pri i4 10 Node paths ssi e muona dad Kanon P DRE Us 39 Normalize d t 2 ss lg Rem 15 Open Object Information 12 OVeEtvieW s osaansa is EGET Deeg nde Ev ahei I P Path to nodes orem ena STA ni 39 R RaN A ansaan E EXPE Asa aimo aatia i aiias 8 Regular expressions lesse esses 44 52 Remove Me n osan saa dele erai arini xD 15 Reports 16i 4 00 e konen conga Lee bee avs ansan dee 9 Scientitic daba cui siiiepde i pD arD ER SEER EA 28 Show Dala as murtaa oie ahd E bea age eae bs 16 Show GAPS iess mo wale pce oy ni Deki uitai iik 18 Start Session 2 665625 05 cece eee nnne 9 Swap sky ref esse eae maw hears saa as RES 18 T TYG SONS io da eas ee ee Saree dele evi a te re 46 Tutorial wi acs ana cet cae peered eee PAASI das 3 U Units of measure l oloon 45 Unload Data s nsa tern Er epe 12 16
71. rom a radiometer into an antenna temperature In order to do this the user must supply a calibration curve per each channel and processing type This curve will be saved into FITS files which will be reused by Life A calibration curve must be provided as a TOD i e a stream of time ordered data using the lama set calibration page 34 function lama set calibration ch time cal TEST test FEED HORN horn Function PROC TYPE proc type Set the photometric calibration curve for channel ch If test horn and proc type are not specified the defaults will be used The time and cal arguments are two arrays with the same size containing the time in seconds and the calibration constant in K V to be used respectively The return value is nonzero if the calibration was set successfully and written on the disk zero if some error occurred An example of use is time 32671 32900 cal 1 031 1 046 result lama set calibration 0 time cal if result eg O then begin print Error unable to set calibration for channel O endif This example will instruct Lama to use the photometric constant 1 031 from time 32671 to 32900 and the constant 1 046 from 32900 till the end of the scientific datas tream The function will also save this calibration curve into a FITS file so that it will be no longer needed to specify the curve if the test is to be loaded again Note that if a channel has been sampled using two different acquisition mod
72. ross correlation plot from the Plot Window On the legend select the two timelines to cross correlate right click on the legend and choose Cross Correlate Plot Any of these actions starts the same cross correlation plot window There however a few differences in the type of data that can be choosen When a cross correlation plot is displayed from the Lama View window only cross correlation plots involving the sky signal can be created since the Lama Node List does not allow to choose between Sky and Reference for each channel from Lama View On the other hand opening a cross correlation plot from the legend in the plot window will not only allow for sky or reference to be choosen but also to perform the cross correlation on a selected chunk of data the cross correlation plot will only contain data displayed in the plot window To display the cross correlation for a particular segment of data we can first zoom in on the relevant region in the Lama Plot window and then select the cross correlation plot It is therefore recommended that a cross correlation plot should start almost always from the plot window 4 4 2 The plot The plot is shown on the plot window which occupies most of the cross correlation window the leftmost part of the cross correlation window Chapter 4 LAMA 21 4 4 2 1 Navigating into the data The zoom button activates the zoom function To zoom in on a particular region in the plot the procedure is exactely the same as
73. rst character For example Ja matches or a To include a write as the first or last character of the set or put it after a range Thus matches both and To include in a set put it anywhere but at the beginning of the set At the beginning it complements the set see below begins a complemented character set which matches any character except the ones specified Thus a z0 9A Z matches all characters except ASCII letters and digits is not special in a character set unless it is the first character The character following the is treated as if it were first in other words and are not special there A complemented character set can match a newline unless newline is mentioned as one of the characters not to match This is in contrast to the handling of regexps in programs such as grep signifies the beginning of the string If you wish to match a literal you must escape it by writing N For example Feed horn will only match strings which begin with the characters Feed horn is similar to but matches only at the end of a line Thus x matches a string of one x or more at the end of a line has two functions it quotes the special characters including V and it intro duces additional special constructs Element Meaning c Any character represents itself unless it has a special regexp meaning Thus c matches the character c Appendix A Regular expressions 54 c
74. ry allocated by every descendant of the start node lama input unload subtree path TEST name Procedure This function unloads any data associated with the node pointed by path and with every descendant It is implemented in IDL and uses lama input unload nodel page 43 Consider also using the more specialized functions lama input unload feed horn page 35 lama input unload aux page 35 lama input unload selection page 35 and lama input unload hk page 38 6 5 3 5 Finding nodes in the tree Because of the complexity of the node tree sometimes it is guite difficult to find the desired node The function lama input find nodes provides a powerful way to look into the tree for nodes matching some pattern lama input find nodes pattern start path REGEXP regexp Function RECURSIVE recursive NAME name TEST name This function searches into the list of the children owned by the node specified by start path for any node whose description is egual to pattern If name is true then the node name will be matched instead of the description If recursive is true all the nodes having start path as ancestor i e its children grandchildren and so on will be checked The function returns a list of strings each containing the full path to the found nodes or an empty string if no matching node was found This example will initialize gain to the DAE gain states of feed horn 27 channel 00 It finds the right node by looking for an housekee
75. s impossible to begin working When a session is started Lama open the log messages window in which are stored all the software messages during the session 4 1 2 View Data The View Data button open the Lama view window that is the software for plotting data See Section 4 2 The Lama View Window page 10 for details 4 1 3 Analyse Data 4 1 4 Report 4 1 5 Close Session Before exit the program it s necessary to close the session in order to let LIFE to use others software Pressing close session button the session is closed 4 1 6 Additional Buttons At bottom of the Lama Top window there are three additional button e The Configure button let the user to choose the LaTex software for reporting opera tions the DVI Reader for reading the reports and the internet browser e The Exit button close Lama It doesn t work if one session is still opened e The Help button Chapter 4 LAMA 10 4 2 The Lama View Window Lama view lets the user to plot data of the LFI instrument and the housekeeping data The main window of Lama view shows two views the node list and the windows list Figure 4 1 The first view is a tree of nodes which represents scientific and housekeeping data the second view is the list of the plot windows opened Lama View Jataset tree TUN 0015 B Scientific cata B 30 SHz feed horns l Feed horn 27 30 GHz E Processing type AVR1 Channel 00 Channel 01 Channel 10 Channel 11 E Feed nom Q
76. ssion repetitively as many times as possible Thus o matches any number of o including no os always applies to the smallest possible preceding expression Thus fo has a repeating o not a repeating fo It matches f fo foo and so on The matcher processes a construct by matching immediately as many repe titions as can be found Then it continues with the rest of the pattern If that fails backtracking occurs discarding some of the matches of the modified construct in case that makes it possible to match the rest of the pattern For example in matching ca ar against the string caaar the a first tries to match all three as but the rest of the pattern is ar and there is only r left to match so this try fails T he next alternative is for a to match only two as With this choice the rest of the regexp matches successfully is a postfix operator similar to except that it must match the preceding expression at least once So for example ca r matches the strings car and caaaar but not the string cr whereas ca r matches all three strings is a postfix operator similar to except that it can match the preceding expres sion either once or not at all For example ca r matches car or cr nothing else N is a postfix operator that specifies repetition N times that is the preceding regular expression must match exactly N times in a row For example x 4 matches the string xxxx and nothing else N M is a postf
77. start lama select range 0 start end time 1 Internally a trigger is a sequence of values stored in an housekeeping parameter Setting a trigger in a test is an operation which takes some time usually a few seconds The time specified in the time parameter always points to the beginning of the sequence while the returned value points to the end of the same sequence Here is an example We imagine that in some test the trigger sequence with code 1 was started at 100 s and was made by 6 values each lasting for 4 seconds Therefore the trigger ended at 124 s Here is how the lama input find trigger works in this case Look for trigger 1 starting from 100 s print lama input find trigger 101 1 100 0 124 0 This has several benefits 1 It is trivial to perform repetitive searches This will print a list of triggers found in the test and referring to the FEM channel 101 time 0 0 repeat time lama input find trigger 101 1 time print Found a trigger at time until time lt 0 0 2 Usually a test starts after the SCOS operator has finished sending the trigger sequence Therefore the value returned by lama input find trigger marks exactly the start of the test 6 7 Log messages When a test is running the TQL operator has the ability to write comments that are stored in the test They are referred as log messages and are used to keep track of what the user is doing Lama provides some IDL funct
78. the right of the Lama Plot windows there is a tab with five pages e In the first page there are three radio buttons for seeing real data data normalized in the range between 1 and 1 and data without theirs mean e The second page is for selection operation and works only with radiometric data The radiometric data loaded and plotted by Lama View are AUX files in which data are Chapter 2 Tutorial 6 binned at 1 Hz The selection page let to load complete or with a different bin value data See ScientificSelection page 16 for more information e The third and the fourth pages shows statistical information about plotted data If the data are zoomed the statistics are referred to those data e The fifth page has a manual zoom and a button to select statistical range for IDL functions On the right bottom of the Lama Plot window there is the legend in which are listed the data stream plotted with the name and the color Select one or more lines and right click The menu let to change style color and hide or show the selected data stream Now select the first line sky 2700 and the last line ref 2711 and right click the mouse Select Cross correlation from the menu This opens a new window the Crosscorrelation plot Figure 2 5 This plot window shows data correlated The main difference between this window and the Lama Plot window is in the first page of the tab in which it s possible to invert axes to bin data to show error
79. ursive IDL procedure pro print node tree start path indent level Create a string made by a number of INDENT LEVEL whitespace characters if indent level gt O then begin byte arr bytarr indent level byte arr byte C indent string byte arr endif else indent Print the name of the node print indent lama input get node name start path Recursively iterate through children child list lama input get children start path if size child list n dim gt O then begin for i 0 n elements child list 1 do begin Make up the path of this child node if start path ne amp then child path start path amp child list i else child path amp child list i Print the node tree of this child print node tree child path indent level 2 Chapter 6 IDL Command Reference 41 endfor endif end There are additional functions which retrieve other information about a node They are listed here lama input get node description path TEST name Function Return a description for the node with path path and belonging to the test named name If path is not specified the current node in the test will be used see cur rent node page 42 If name is not specified the current test will be used lama input get node x units path TEST name Function Return an array of IDs containing the valid measure units to be used for the X data of node with path path and belongi
80. used during the analysis of the tests acquired during the Planck cryogenic campaign must be produced e In the CPV phase the first months after the launch of Planck we will calibrate the DAE again therefore producing new tables However we do not want to throw away the old calibration tables as they will still be needed to load the old tests acquired in the many ground tests performed before the launch What we want is that for each test recorded during the ground test LAMA applies the right calibration tables Unfortunately so far the software offered no tools to perform this task With version 3 1 we have introduced new facilities that give the user full control over the calibration sets In LAMA each test can have its own calibration set Within IDL each set is identified through a string like QM To get a list of the calibration sets available for a specified test you can use the lama get calibration sets function lama get calibration sets TEST name Function Return an array of strings representing the list of available calibration sets for the test named name If path is not specified the current test will be used If an error occurred during the execution of this function the value 0 is returned Chapter 6 IDL Command Reference 51 The default test can be retrieved and changed with lama get default calibration and lama default calibration lama get default calibration set TEST name Function Return a string containin
81. w X resne hidh E eee oe EE 29 lama input unload subtree 44 lama get raw y cie bc d e e E Td 30 lama input unload test sss 26 lama get ref Sigma il seed Rees 29 lama instance close niia 25 lama get ref x x s ils 29 lama instance create cece eee 25 lama get ref y i eerte Rud 29 lama instance is created 25 lama get sci ave dead is hoes ES 32 lama is channel calibrated 34 lama get sci nsamples 000 32 lama is statistic range selected 33 lama get sci sIPssssi aga beens vasteen 32 T m select range weak kanaa ana 30 lama get selection path 35 lama selection get binning 33 lama get Sky sigmavsas sas 9 vds eere 29 lama selection get nsamples 33 lama get Sky X saamen 2444050548 de LES 29 lama selection get range 33 lama get Sky Ferier ea a e E ees ERE 29 lama selection get raw sigma 31 lama get statistic range 33 lama selection get raw X 31 lama input find nodes 44 lama selection get raw y 31 lama input find trigger 47 lama selection get ref sigma 31 lama input get children 2 sa ou as iii 40 lama selection get ref X 31 lama input get current node 43 lama selection get ref
82. y 31 lama input get hk node pair 43 lama selection get sci avg 33 lama input get list of tests 2f lama selection get sci sigma 33 lama input get list of triggers 47 lama selection get sky sigma al lama input get log messages 50 lama selection get sky X 30 lama input get log text 49 lama selection get sky y 31 lama_input_get_log_time 49 lama_selection_is_ref_available 30 lama input get log time str 49 lama selection is sky available 30 lama input get node description 41 lama set calibration 34 lama input get node name 40 lama set default calibration set SL lama input get node type 42 lama_swap_sky_Tef ss ms eee ab ems 28 lama input get node unit description 42 lama_view_close cece cee eee 26 lama_input_get_node_unit_full_name Al lama view is opened uses esses 26 lama input get node unit name A1 lama view Open e REA RE tones 25
83. y checking that it is included into list of calibrations Appendix A Regular expressions 52 Appendix A Regular expressions Regular expressions have a syntax in which a few characters are special constructs and the rest are ordinary An ordinary character is a simple regular expression which matches that same character and nothing else The special characters are 4 3 L G and Any other character appearing in a regular expression is ordinary unless a precedes it For example f is not a special character so it is ordinary and therefore f is a regular expression that matches f Likewise o is a regular expression that matches only o Any two regular expressions A and B can be concatenated The result is a regular expression which matches a string if A matches some amount of the beginning of that string and B matches the rest of the string As a simple example we can concatenate the regular expressions f and o to get the regular expression fo which matches the string fo Still trivial To do something nontrivial you need to use one of the special characters Here is a list of them period is a special character that matches any single character except a new line Using concatenation we can make regular expressions like a b which matches any three character string that begins with a and ends with b is not a construct by itself it is a postfix operator that means to match the preceding regular expre

LIFE User's Guide - Planck LFI

Contents

Download Pdf Manuals

Related Search

Related Contents