Changes between Version 30 and Version 31 of glga_manual

Timestamp:

Aug 19, 2016, 10:49:46 PM (10 years ago)

Author:

ehsan

Comment:

--

glga_manual

@@ -202 +202 @@
 
  a. Undo
-   * remove the last added region  
-   * only works on common regions (all-bands, green)
+   * Remove the last added region  
+   * Only works on common regions (all-bands, green)
  b. Add ...
-   * add new masking regions (by left clicking to define vertices, right click to close the region)
-   * works on both common and band regions (green and magenta)
-   * to switch between common and band regions, go to ''change mask'' option, under the same menu
+   * Add new masking regions (by left clicking to define vertices, right click to close the region)
+   * Works on both common and band regions (green and magenta)
+   * To switch between common and band regions, go to ''change mask'' option, under the same menu
  c. Remove one
-   * remove masking regions one by one (click inside the region of interest)
-   * works on both common and band regions (green and magenta)
-   * to switch between common and band regions, go to ''change mask'' option, under the same menu
+   * Remove masking regions one by one (click inside the region of interest)
+   * Works on both common and band regions (green and magenta)
+   * To switch between common and band regions, go to ''change mask'' option, under the same menu
  d. Clean all
-   * remove all masking regions based on the current mask status
-   * works on both common and band regions (green and magenta)
-   * to switch between common and band regions, go to ''change mask'' option, under the same menu
+   * Remove all masking regions based on the current mask status
+   * Works on both common and band regions (green and magenta)
+   * To switch between common and band regions, go to ''change mask'' option, under the same menu
  e. Save
-   * saves newly added '''common''' regions
+   * Saves newly added '''common''' regions
  f. Change Mask
-   * switch between common and band regions
-   * it is effective when a particular band is chosen
+   * Switch between common and band regions
+   * It is effective when a particular band is chosen
 
 
 === Ellipse ===
  a. Edit ...
-   * edit ellipse information
-   * look at terminal for the effective short key 
-   * you need to switch back and force between TV and terminal 
+   * Edit ellipse information
+   * Look at terminal for the effective short key 
+   * You need to switch back and force between TV and terminal 
  b. Original
-   * updates the ellipse info. and switched back to the original ellipse
-   * refresh the TV
+   * Updates the ellipse info. and switched back to the original ellipse
+   * Refresh the TV
 
 === Stars === 
  a. Find ...
-   * find new point sources based on the entered PSF and limiting magnitudes
-   * use terminal to enter the input variables
+   * Find new point sources based on the entered PSF and limiting magnitudes
+   * Use terminal to enter the input variables
  b. Delete ...
-   * delete the masked point sources
-   * define a region (left/right mouse clicks)
-   * all point sources inside the region would be removed from the point source mask
-   * useful to deselect the star forming regions of spiral galaxy arms
+   * Delete the masked point sources
+   * Define a region (left/right mouse clicks)
+   * All point sources inside the region would be removed from the point source mask
+   * Useful to deselect the star forming regions of spiral galaxy arms
  c. Edit/Add ...
-   * add more point sources manually
-   * edit the existing point sources, e.g. increase/decrease their sizes
+   * Add more point sources manually
+   * Edit the existing point sources, e.g. increase/decrease their sizes
 
 
 === Background === 
  a. Back. Region
+   * Defining regions to measure the background
+   * When using these regions, the elliptical annulus would no longer be used
  b. Clear Region
+   * Clean the previously defined background regions and go back to the annulus background estimation
 
 
 === ds9 ===
  a. Open
+   * Opens the fits imaged of the current TV band on ds9
+   * If TV is in the composite image mode, the main fits file (use-file) would be used
  b. Contours on/off
+   * turning on/off the contours on the ds9 image
  c. Import ellipse
+   * Imports the red elliptical aperture from ds9 to TV
  d. Export ellipse
+   * Exports the current ellipse from TV to ds9
  e. Close all
+   * Closes all open ds9 windows
+   * be careful this would close all ds9 windows, not necessarily those opened by GLGA TV
 
  
 === SExtractor === 
  a. Run
+   * Run SEWxtractor on the fits images of the current band
+   * If TV is in the composite image mode, the main fits file (use-file) would be used
+   * If SExtractor has been previously run, this asks the user to either use the existing results, or re-run SExtractor
+   * Sometimes, masking the image helps SExtractor to fit a better ellipse
+   * If users chooses to re-run SExtractor, a temporary fits image would be created, which includes all the common-/band- masks and the SExtractor uses that file to extract the ellipse paramters
+   * Note: if the image is large, this process may take time. A large temporary file needs to be prepared for SExtractor, and SExtracting also takes time
  b. Segmentation
+   * This would display the Segmentation image that is produced by SExtractor. If this is not available, you need to run SExtractor first.
  c. Masked Image
+   * This would display the temporary masked region that has been already used in this session
  d. Region on
+   * This would turn on all the fitted ellipses by SExtractor. To see them, you need to open ds9
+   * Segmentation, Maksed Image, TV Image can be used in ds9 to see these regions
  e. Region off
+   * This would turn off all regions previously openned in all ds9 windows
  f. Use-Mask
+   * User can define a regions to be specifically used by SExtractor in this session
+   * When TV starts, all previous SExtractor regions would be deleted, so this region is only valid in the current session
+   * The rest of the image would be totally masked for SExtractor in the process of making the temporary file
+   * The un-maksed defined region, then later would be masked by common/band/centroid masks
  g. Force-Mask
+   * User can define a regions to be specifically used by SExtractor in this session
+   * This mask would not be affected by any other common/band/centeroid masks
+   * For example, this is useful when a spike cuts a galaxy in to two halves and we do not want SExtractor fits two separates ellipses for one single object
  h. Clear-Mask
+   * Clear both Use-Mask and Force-Mask in the current session
+   * If you don't clear these masks, they would be removed on the next run, because users are expected to run SExtractor only a few times to find the proper ellipse
+   * Once a good ellipse is found, no more messing up with its parameters
 
 === Pylipse === 
  a. Open
+   * Opens Pylipse, a python program
+   * There is a complete help on how to use this program
+   * This can also be used stand-alone
+   * ds9 can be used as a bridge to import/export ellipse to/from this program
+
  b. Load Ellipse