Institut de Recherche en Astrophysique et Planétologie OSP Editor - Tutorial

(1)

Institut de Recherche en Astrophysique et Planétologie

OSP Editor - Tutorial

Version 1.1 April 2016

Authors List

Created by Elodie Bourrec V1.0 September 2015

Modified by Elodie Bourrec V1.1 April 2016

Name Function

Baratchar Sébastien IRAP Development Engineer

Bourrec Elodie IRAP Development Engineer / Project manager

Brau-Nogué Sylvie IRAP Development Engineer / Project manager

Glorian Jean-Michel IRAP Development Engineer

Leborgne Jean-François IRAP Researcher

Pello Roser IRAP Researcher

Richard Johan CRAL Researcher

Valentin Hervé IRAP Optician

(2)

This documentation is on completion. Some images don't match exactly the soft and some functionnalities may have the same problem too.

If , in the soft, you can't do some operations you want to, some comments are in the Release file.

Some images are not actualized with the distributed version but they will be soon.

Application start.

When the application is launched, here the start screen.

Selecting a working space.

The first action to begin a project is to select a workspace.

You can click on the first button of the toolBar or

Select the menu "Project", then click on "New" sub-menu item.

A file chooser dialog window opened, and you can select the directory where you want to work.

Note that your server images will be downloaded here, and all you want to save.

(5)

When your directory is selected, press the "New" button.

Open an existing project.

You can also open an existing project.

Projects are stored in XML format file.

You can click on the second button of the toolBar or

Select the menu "Project", and then click on "Open" sub-menu item.

A file chooser dialog window is opened,

allowing you to choose the existing file describing your project.

(6)

(7)

Save a project.

The project can be saved using the third button of the toolbar Or

selecting the "Save" option of the "Project" menu

(8)

The name of the project must be filled in the next window

The project name is set in the window title.

(9)

Display settings of the instrument.

This function is not yet implemented. There is no effects in the soft

(10)

Load an image

Load an image from a local file.

The first method to load an image is to open a FITS file located on your personal computer.

Select the menu "Image", then "Load From" and click on "Local File" sub-menu item.

(11)

A file chooser dialog window is opened, allowing you to browse your disks and find your favorite FITS file.

When your file is selected, press the "OPEN" button to watch your image on the display.

(12)

Load an image from an image server.

The second method to load an image is to open a FITS file from an image server.

or

Select the menu "Image", then "Load From" and click on "Image Server" sub-menu item.

(13)

A catalog navigator window is opened, allowing you to browse catalogs.

When you click on your favorite, the query panel appears on the right.

First, fill the name of the object or give an alpha delta position.

Then don't forget to put width and height of your image and click on the "Query" button.

(14)

This will send a request and a loading window will be displayed

The image will be displayed when it's is loaded.

Repeat the process until you find the good one, and then use the "Close" button to close the window.

The last selected image is still loaded on the display.

(15)

Add the loaded image in the project.

Once your image choosen, it's added in the left side, under the field of view tree.

You can add several images in the project following this procedure.

Then you can work on different images selecting them on this field of view tree.

(16)

Image Manipulations

Move and Zoom on the Field Of View (FoV)

When your image is displayed you can move and zoom on the Field of View

To move your image :

Press the mouse on the yellow rectangle in the overview display, then drag it to your favorite place. [*]

Press the mouse directly on the image display then drag it to the best place.

To zoom in or out : [**]

Pressing the buttons "+" or "-", zoom in or out to the center of the display.

You can also roll your mouse wheel to move in or out.

The buttons "1:1" is used to recover the initial and minimal scale.

(17)

Change colors of the display

You can change colors of the image display, using the menu Image, then Edit colors.

Or double clicking on the image colorbar on the right, open the "Image Colors" dialog window.

(18)

Change cut levels of the display

To change the cut levels of the current image, click on the menu Image, then on the sub-menu Edit Cut Levels.

The cut levels window dialog is open.

(19)

Objects

Add Objects over the image

It's possible to add objects over the current image by loading from catalogs or manually.

Click on the menu Object then choose the sub-menu item you want.

(20)

Add Objects From catalogs.

To choose objects from catalog, click on the sub-menu item from Catalog.

This will open a the same window as to load an image from catalogs, but with the objects catalogs list.

Once the catalog choosen, the image properties will be displayed in the query panel.

Click on Query button will bring the objects list in the bottom panel

(21)

You can sort objects by their parameters clicking on the title of the column.

Also, with a selection of lines, and right-click, you can delete some objects.

This way, they will be unploted in display and not imported when the window will be closed.

When your selection is ready, clic on the Add Objects and Close button at the bottom of the dialog window

(22)

This adds the selected objects and some of their characteristics in the simulator.

(23)

Add Objects manually.

To add an object manually, choose the sub-menu item Add Objects Manually in the Object menu.

Or you can right-click in the image display, a sub-menu "Add object" appears.

All these choices open a pick Objects dialog window.

(24)

Put the mouse on your favorite objectin the display window. The object appears in the zoom panel of the dialog window, as well all its characteristics as in the image statistics panel

.

When you want to add the object, just click on it.

A cross will be displayed on the object, either in the zoom of the pick window, and on the image display.

The object is added to the sky object list at the bottom of the main window.

You can add many objects as you want.

When you finish, you just close the pick window.

(25)

(26)

(27)

You put the mouse on the object, click right, and choose the "Recalculate Centroid" option.

The cross displayed on image will turn light-green, and in the bottom array, recalculation is mentionned in the catalog column, and the new centroid value displayed in columns forward.

(28)

(29)

Recalcul Centroid for all Objects.

After loading by catalogs, sometimes all objects need recalculation.

You can do that with the "Object" menu option, and the "Recalcul centroid for all objects " sub-item.

The informations will be changed in the bottom array and the objects will be plotted (better) with green cross.

(30)

(31)

Remove Object manually.

Removing an object is possible :

You right-click on the selected object in the image display window.

A sub-menu will appears and the object will be enlightened in the bottom array

(32)

When you choose the "Remove object" option, it will erase the cross in the display and the corresponding line in array.

(33)

Manage Objects via Popup menu

Clicking-right on the mouse where you're positionned on an object, make a popup menu appearing.

This allows to manage the selected object.

You can set the object a reference object, the plot is changing and the "isRef" check box selected.

You can remove individually the object from the list of skyObject.

You can recalculate the centroid of the object.

You can assign the corresponding slit to the object, This option only appears when the mask is set

(34)

Set an Object as Reference.

As you click on the mouse menu option "is reference" when you are on an object,

(35)

it will change the cross symbol in a blue square on the image, and a sign is added in the reference column in the bottom array.

(36)

Masks

Add an EMIR mask

You can add several masks on an image. Select the menu "Mask", and click on "Add on current Image"

sub-menu item.

A new mask is added in the left side, under the image name node with a default name.

You can add several masks in the project following this procedures, then you can work on different masks selecting it on the field of view tree.

The coordinates of the mask center appears on the "Selected Mask Properties" panel.

The mask is also overplotted on the image display.

All slits are centered and opened to 0.6 arcsec by default.

The selected slit is plotted in green and by default, it's the number 1.

Slits characteristics are mentionned in the "Selected Slit Properties" panel.

.

(37)

Move and Turn the selected mask

MOVE

When your mask is added on your image display, you can move and/or turn it on the image.

There is two methods to move the selected mask : Select the menu "Mask",

and select the "Move Mask over the image" sub-menu radio-item.

Click on the "Move" button on the menu bar.

The mask is delimited with a red line as well as the "Move" button.

Press the mouse on the mask and drag it through the image.

(38)

(39)

TURN

To turn the mask, methods are the same : Select the menu "Mask",

and click on "Turn" sub-menu radio-item.

Click on the button "Turn" on the menu bar.

A red circle is plotted on the center of the mask, and the border of the "Turn" button appears in red.

Press the mouse on the mask and drag it to change the angle.

You can also change the angle directly on the "Selected Mask Properties".

The coordinates of the mask center appears on the "Selected Mask Properties" panel

.

(40)

Slits

Select a Slit and its properties

To select a slit, check the slit number with the Slit selector,

or click with the mouse directly on its location on the mask.

And then slit will be selected (in green) and its characteristics will be displayed in “the slit properties panel”.

(41)

,

The slits characteristics can be changed directly in this panel.

Or you can do it with the “ sliders.”

(42)

Assign an object to a slit

When the Object is selected, you can assign the closest slit to the object with 2 methods : 1 - Right-click on the mouse and then choose the “Assign to Slit “option.

The slit will be positionned on the object, and in the sky objects list, the slit number is mentionned in the object characteristics.

(43)

2 - Or, on the mask, you can double-click on the approximate position you want for the slit.

It will be positionned and after, you can adjust its parameters with the the “ slit properties panel “, and with the help of the "go and zoom" button.

(44)

(45)

Join contiguous slits.

You can join slits or by menu, or with mouse selection :

By menu : click on the Slit menu and then Join slits sub-item.

Enter the number of the first slit and the numbers of the last slit you want to join, and the slit reference position value that you want for all.

The second method by mouse is to selected the first slit on the image, and click on the last slit with pushing the "Ctrl" key on keyboard.

The same dialog window appears.

The result :

:

(46)

Split contiguous slits.

To split joined-slits, the methods are the same than to join.

You can click on the Slit menu then Split slits.

The same control panel appears but to split.

Select the first and the last number of the slits.

Or you can select the slits with the mouse and make appear the panel to split.

The result :

Attention, the slits positions stay at the position defined before split.

(47)

Undo

It's possible to undo somes moves.

The Undo button is activated when it's possible.

It concernes masks moves, turn and move, and slits corrections.

Spectra

Plot the spectra over the image.

The spectrum of the selected Slit or all the spectra could be displayed over the mask, to watch the extends.( Not yet good curvature )

Click on the menu Display Then select the appropriate plot option.

(48)

(49)

Search

Search automatically slits positions.

This search method propose several mask positions.

It takes calculations from the center of the position of the field of view.

It tests several angles with the objects in the field of view, and optimizes the slits positions for them.

It's not on all the image and with all the objects.

But you can run several testes from different situations in field of view.

There is a search window, with a progress bar which is displayed during calculations.

The ratio displayed aside the calculated mask is the number of objects in slits in the mask over the total number of objects loaded.

To lauch the research, click on the Search button.

(50)

The search window is displayed.

This window must be closed after calculations to display the mask solutions.

After a small time, depending on the number of object in the sky object list, the tenth better masks are added to the list of masks.

(51)

Some examples : Result 1:

(52)

Result 2:

(53)

Result 3:

(54)

Result 4:

(55)

Final operations

Validate and/or Write a mask.

Validate

After all manipulations, masks can be validated and saved.

For this, you select the Validate button.

But, before you validate, or write, a mask, you must have at less 3 reference objects in the detector field.

If not, you will have this message :

(56)

“ You don’t have enough reference objects to save the mask”

Once you've got enought reference objects and all requierements are completed, you can validate the mask.

You will have a confirmation message that says the mask is validated.

And, after that, it asks if you want the mask writed.

Write

At this point, the procedure is the same if you have clicked on the write button.

The screen asks you where you want to save the file and its name.

(57)

(58)

When you do that, the example generated xml file:

Reload a Mask.

To be completed

A written file of mask can be re-load.

With the Mask menu option, you can choose Load a mask.

A file chooser will be opened, and a file can be choosen.

The mask properties will be tested to verify it's in the image and after that, it will be loaded.