parse pdf c# : Edit pdf metadata acrobat SDK software service wpf winforms web page dnn userguide2-part362

The ESA/ESO/NASA FITS Liberator User’s Guide 
21 
change more than one value in an instant, thus potentially saving a lot of time by only 
making the FITS Liberator do the calculations once. 
4.3.4  Flipping the output image 
If the image is flipped (i.e. check box 71 in Figure 10 is checked) when saving to a 
TIFF file the performance upon loading into Photoshop, e.g., may be decreased if the 
FITS file is large. This is due to the fact that Photoshop has to flip the image and that 
can take some time for large files. In this case it may be advantageous to not flip the 
image, depending on the situation. 
Edit pdf metadata acrobat - add, remove, update PDF metadata in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Allow C# Developers to Read, Add, Edit, Update and Delete PDF Metadata
pdf metadata viewer online; pdf keywords metadata
Edit pdf metadata acrobat - VB.NET PDF metadata library: add, remove, update PDF metadata in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Enable VB.NET Users to Read, Write, Edit, Delete and Update PDF Document Metadata
endnote pdf metadata; pdf xmp metadata
The ESA/ESO/NASA FITS Liberator User’s Guide 
22 
 Reference Guide 
Figure 9 This infrared picture shows a cloud, known as DR22, bursting with new stars in the Cygnus 
region of the sky. Spitzer's infrared eyes can both see through and see dust, giving it a unique view into 
star-forming nests. The blue areas are dusty clouds, and the orange is mainly hot gas. 
Credit: NASA/JPL-Caltech/J. Hora (Harvard-Smithsonian CfA) 
C# PDF Converter Library SDK to convert PDF to other file formats
manipulate & convert standard PDF documents in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat.
remove metadata from pdf acrobat; edit pdf metadata acrobat
.NET PDF Document Viewing, Annotation, Conversion & Processing
Read PDF metadata. Search text content inside PDF. Add, insert PDF native annotations to PDF file. Edit, update, delete PDF annotations from PDF file. Print.
change pdf metadata; pdf metadata reader
The ESA/ESO/NASA FITS Liberator User’s Guide 
23 
n this section, we provide more in-depth information about the many different 
options that FITS Liberator v.3 provides. To give the full overview we will first list 
all the components in the Graphical User Interface. 
Figure 10 FITS Liberator screen shot with all tools and functions marked. These are described below. 
Note that the Image Statistics can be shown for either the Scaled version of the image (as here) or for 
the Stretched version of the image. The numbers 41-45 are therefore absent. 
Tabs 
1.  Processing tab 
Preview image and import settings 
2.  Metadata tab 
Metadata input 
3.  FITS header tab 
4.  Help Guide tab 
FITS Header information 
Hints and help to the usage of the plug-in 
Tools 
5.  Move tool 
Move tool (v) 
6.  Zoom tool 
Zoom tool (z) 
7.  Black level selector 
Black level selector tool (s) 
8.  White level selector 
White level selector tool (w) 
9.  Background level selector 
Background selector tool (b) 
10.  Peak level selector 
Peak level selector tool (p) 
Preview Window 
11.  Preview window 
8-bit representation of the image 
12.  Minus button 
Decrease zoom factor 
13.  Plus button 
Increase zoom factor 
14.  Zoom pop up 
Choose a zoom factor 
Histogram Window 
15.  Histogram window 
Shows the distribution of greyscale levels in the image 
16.  Black level slider 
Drag to change the black level 
17.  White level slider 
Drag to change the white level 
18.  Black level text field 
Black level 
19.  White level text field 
White level 
20.  Black level button down 
Increase the black level 
21.  Black level button up 
Decrease the black level 
22.  White level button down 
Increase the white level 
C# Windows Viewer - Image and Document Conversion & Rendering in
standard image and document in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat. Convert to PDF.
edit pdf metadata; view pdf metadata
C# Word - Word Conversion in C#.NET
Word documents in .NET class applications independently, without using other external third-party dependencies like Adobe Acrobat. Word to PDF Conversion.
remove metadata from pdf; batch pdf metadata editor
The ESA/ESO/NASA FITS Liberator User’s Guide 
24 
23.  White level button up 
24.  Histogram markers 
Network drive warning 
25.  Yellow network drive warning 
Decrease the black level 
The different coloured lines show various markers in the 
histogram 
Shows a small yellow symbol when a file is loaded via a 
network drive, which may decrease performance 
Image Data 
26.  Image/Plane selector 
Change image and/or plane 
27.  X coordinate 
X-coordinate 
28.  Y coordinate 
29.  Right ascension 
30.  Declination 
Y-coordinate 
WCS coordinate 
WCS coordinate 
31.  Input value 
Input value 
32.  Stretched value 
Stretched value 
33.  Scaled value 
Scaled value 
34.  Width 
Image width 
35.  Height 
Image height 
Image Statistics 
36.  Minimum Input 
Minimum of Input Image 
37.  Maximum Input 
Maximum of Input Image 
38.  Mean Input 
Mean of Input Image 
39.  Median Input 
Median of Input Image 
40.  Standard Deviation Input 
Standard deviation of Input Image 
41.  Minimum Stretched 
Minimum of Stretched Image 
42.  Maximum Stretched 
Maximum of Stretched Image 
43.  Mean Stretched 
Mean of Stretched Image 
44.  Median Stretched 
Median of Stretched Image 
45.  Standard Deviation Stretched 
Standard deviation of Stretched Image 
46.  Minimum Scaled 
Minimum of Scaled Image 
47.  Maximum Scaled 
Maximum of Scaled Image 
48.  Mean Scaled 
Mean of Scaled Image 
49.  Median Scaled 
Median of Scaled Image 
50.  Standard Deviation Scaled 
Standard deviation of Scaled Image 
Scaling and Stretch (Advanced) 
51.  Stretch function pop up 
Select Stretch function 
52.  Background level text field 
Set Background level 
53.  Peak level text field 
Set Peak level 
54.  Scaled Peak level text field 
Set Scaled Peak level 
55.  Set Background level button 
Inserts Black level as Background level 
56.  Set Peak level button 
Inserts White level as Peak level 
57.  Auto Scaling button 
Insert Black level from Input Image as Background level, insert 
White level from Input Image as Peak level, Set Scaled Peak 
level to 10 
58.  Apply values 
Apply stretch values if enabled (see Options Dialog) 
Channels 
59.  Channels 8-bit radio button  
Import as 8-bit image 
60.  Channels 16-bit radio button  
Import as 16-bit image 
61.  Channels 32-bit radio button  
Import as 32-bit image 
Undefined Values 
62.  Undefined Black radio button  
Import undefined values as black 
63.  Undefined Transparent radio button  
Import undefined values as transparent 
Other Settings 
64.  Open file button 
Open a new FITS or PDS file 
65.  Save file button 
Save the current image as a tiff file with the current settings 
66.  Save & edit button 
Save the current image as a tiff file and open it with the default 
viewer/editor 
67.  Options button 
Open the options dialog 
68.  About button 
Open the about box 
69.  Reset button 
Reset settings to default values 
70.  Preview checkbox 
Enabled/disable preview 
71.  Flip Image 
Set vertical orientation of image 
72.  Freeze settings
checkbox 
Keep current settings 
73.  Undefined (red) checkbox 
Show/hide undefined pixels 
74.  White clipping (green) checkbox 
Show/hide white clipped pixels 
75.  Black clipping (blue) checkbox 
Show/hide black clipped pixels 
76.  Scaled radio button 
Show Scaled values 
77.  Stretched radio button 
Show Stretched values 
VB.NET PDF: How to Create Watermark on PDF Document within
logo) on any desired PDF page. And with our PDF Watermark Creator, users need no external application plugin, like Adobe Acrobat.
add metadata to pdf; view pdf metadata in explorer
The ESA/ESO/NASA FITS Liberator User’s Guide 
25 
The FITS Liberator Graphical User Interface (shown above) controls all elements of 
the image processing by means of four panels accessed by the tabs along the top 
row (1-4) and a selection of buttons and options along the right side. The first 
Processing tab (1) contains all of the controls for adjusting the input FITS image. The 
second, the Metadata tab (2) accesses the image and creation tags that are useful 
for documenting the image and interfacing with services like the Virtual Observatory. 
The FITS header tab (3) shows the content of the header for the input image. Finally, 
the Help Guide tab (4) provides a document with tips & tricks on how to use the FITS 
Liberator. The Open file button (64), the Save file button (65) and the Save & Edit 
button (66) control the opening and saving of files, and the Reset button (69) clears 
any user settings and returns the image to the default best-guess settings. 
Text entered into the text fields is accepted when either the Enter or Tab keys are 
pressed. The Enter key maintains focus on the current field while Tab advances to 
the next one. Copy/paste commands are recognised within the text fields. 
5.1  Tabs 
There are four tabs (1-4) along the top of the Liberator interface:  
1.  The Processing tab where the image processing is handled. 
2.  The Metadata tab where Metadata can be entered. 
3.  The FITS header tab where a text version of the FITS header is listed. 
4.  The Help Guide with a short guide to the usage of the plug-in. 
The elements of the Processing tab (1) will be covered in the next sections (5.2 
onwards). 
The Metadata tab (2) is discussed in more detail in sections 3.4 and Appendix A 
(below). 
The FITS Header tab (3), selected along the top of the FITS Liberator interface, 
allows the user to view the raw FITS header. This can contain useful, if cryptically 
encoded, information about the original data. Text from this window can be selected 
and copied to the clipboard. More information about FITS headers and keywords 
may be found at: 
http://fits.gsfc.nasa.gov/ 
5.2  Processing Tab: Tools 
The available tools are found on the left side of the interface on the Processing tab in 
three groups: the Move and Zoom tools (5,6), Black and White level selectors (7,8), 
Background and Peak level selectors (9,10).  
The top hand-shaped Move tool (5) is for panning in the Histogram and Preview 
windows. When selected the user can simply click and drag in either window to move 
items into view. The Move tool may also be temporarily activated by holding down 
the space bar. 
The Zoom tool (6) allows interactive zooming within the Preview (11) and Histogram 
windows (15). Clicking in either window will zoom in a step around the area clicked. 
Holding down the alt/option key will zoom out. The user may also drag out a 
rectangular region to zoom exactly into that portion. 
The ESA/ESO/NASA FITS Liberator User’s Guide 
26 
The Black and White levels and Background/Peak level eyedroppers (7-10) are 
similar in use, but apply to different portions of the interface. They allow their 
corresponding parameters to be set interactively by clicking within the Preview 
window. The upper two (7,8) set the Black and White levels (16,17) under the 
Histogram window; they use a single-pixel sample. The lower two (9, 10), 
distinguished by the “B” & “P” labels, set the Background/Peak levels (52,53) in the 
Scaling and Stretching pane. 
Keyboard shortcuts may be used to activate the Tools:  
 v for Move tool; 
 z for Zoom tool; 
 w for White level selector; 
 s for Black level selector; 
 b for Background level selector ; 
 p for Peak level selector. 
5.3  Processing Tab: Preview Window 
The large Preview window (11) in the upper left part of the Processing tab displays a 
greyscale preview of the imported image that reflects the current Black and White 
levels and Stretching settings and shows how the image would look if imported. Any 
update to the display settings will trigger an immediate redraw, which may take some 
time on slower systems or for larger images. Underneath the window are readouts 
and controls for setting the Zoom level (12-14). A specific Zoom level may be 
selected from the pop-up menu (14), or the +/- buttons (12,13) can be used to 
increment/decrement the zoom value. 
5.4  Processing Tab: Histogram Window 
The display window on the lower left of the FITS Liberator window (15) shows the 
current histogram of the image that is displayed in the Preview window. This is 
similar to the histograms generated within Photoshop, except that the histogram here 
changes depending on whether the image is the Input Image, the Scaled Image or 
the Stretched Image. Changes to the Scaling and Stretching settings (see below) will 
cause the histogram to be regenerated, reflecting any changes to the brightness 
distribution. The Histogram window may be zoomed in or out using the Zoom tool (6) 
and moved using the Move Tool (5). 
The Black and White levels are set underneath the histogram with the small 
black/white triangles (16,17). These controls function in much the same way as the 
Levels dialog box in Photoshop. The black/white sliders may be dragged within the 
window, or numeric values may be typed into the text fields. Tab or Enter will cause 
the number to be accepted. The up/down arrows (20-23) by each field adjust the 
level in increments of 1/10
th
of a displayed column to allow for finer adjustments than 
dragging allows. The up/down arrows on the keyboard will work the same way if the 
text field is highlighted. 
5.5  Processing Tab: Image Data 
Image/Plane selector (26): The pop-up menu selector (which defaults to “Image 1, 
Plane 1”) allows the user to select the desired sub-image within a complex data file. 
While FITS files contain a single image, some datasets allow multiple images to be 
included in a single file. These can include multiple concatenated images strung 
The ESA/ESO/NASA FITS Liberator User’s Guide 
27 
together (identified by the Image number), or 3D data cubes (identified by the Plane 
number). 
Multiple images are sometimes combined when they form a series taken of a single 
source, possibly at different positions or using different filters. Data cubes usually use 
the third axis to include multiple values of a third parameter, such as steps in 
wavelength for spectral line imaging. 
The FITS Liberator can read in one image at a time by selecting the desired image 
from the pop-up menu. If multiple images need to be read in using identical settings 
(as is often the case with a data cube), the user may select the Freeze settings 
checkbox (72) as the first one is read in to retain all Black and White levels and 
Background/Peak/ Stretch settings (see Other Settings below). 
The information area underneath the Image/Plane selector (26) is used as the cursor 
moves over the Preview window. The left column shows the absolute X and Y 
coordinate (27, 28) of the cursor in the original image relative to the upper left corner. 
The middle column shows the World Coordinate System (WCS) coordinates Right 
Ascension (29) and Declination (30) (both in degrees) of the cursor position if WCS 
info is present in the FITS header of the file. The right-hand column gives the data 
value at that position for both the Input Image (31) and the Scaled Image (33) (the 
data after the Background level and a Scaling factor have been applied) respectively 
or the Stretched Image (32) (after a Stretch function has been applied), depending on 
the setting of the radio button for Show Image information for on the far right side of 
the interface (76,77). 
Further down there is the Width and Height of the image (in pixels (34,35)). 
5.6  Processing Tab: Image Statistics 
The Image Statistics information area (36-50) provides overall statistics for the whole 
image. As with the Image Data area these values are presented for both the original 
Input Image and either the Scaled or Stretched Images. The statistics provided 
include the minimum and maximum data values (36/46, 37/47) as well as the mean 
(or average) (38/48), median (39, 49), and standard deviation (40, 50). 
5.7  Processing Tab: Scaling and Stretch (Advanced) 
The Scaling and Stretch functions (51-58) in FITS Liberator apply a mathematical 
Stretch to the raw data values to bring out faint details in the image without having to 
over-saturate the brightest areas of interest. Such Stretches are needed in datasets 
with a high dynamic range. 
The Stretch function pop-up (51) provides a list of mathematical functions that can be 
applied to the raw data before it is translated to levels of grey for display. These 
come in four basic groupings: 
 Linear – no stretch;  
 Logarithmic – ArcSinh(x) and Log(x); 
 Roots – x^(1/2), x^(1/3), x^(1/4), x^(1/5); 
 Compound functions – combinations of the above. 
Of the Logarithmic functions, the inverse hyperbolic sine, or ArcSinh(x), is preferred 
for its anti-symmetric behaviour around x=0 (ArcSinh(-x) = -ArcSinh(x)). The scaling 
The ESA/ESO/NASA FITS Liberator User’s Guide 
28 
of the data has a strong effect on the result of these functions. Log(x) is included for 
historic reasons, though due to the fact that Log(0) is undefined it is implemented 
internally as Log(1+x) which behaves very similarly to ArcSinh(x) for x ≥ 0. 
The Root functions are more commonly known as square root (x^[1/2]), cube root 
(x^[1/3]), etc. The FITS Liberator implements each of them to be anti-symmetric 
around x=0, even though mathematically roots should return undefined (or imaginary) 
results. Here they are merely used as tools for dynamic range compression. The 
Root functions are unaffected by image scaling. 
The compound functions provide a variety of subtle differences in how dynamic 
range is compressed at different levels in the image. Image scaling strongly affects 
the results of these functions. 
Each function provides a slightly different bias to the bright and dark features, and 
often experimentation is the only way to determine which function is best for a given 
file. Note that the Histogram window will update with each change in Stretch function 
to show how it affects the distribution of light and dark pixels. This can be helpful in 
finding correct background levels and choosing a good Stretch. 
All of the Stretch functions in the Liberator work best when the Background level of 
the data (i.e. the value of the darkest parts of the image) is close to zero. In many 
astronomical datasets this is not the case due to the way the data were collected or 
processed. One can examine the data values of the background in an image by 
passing the cursor over the darkest regions and study the input value readout in the 
Image Data section. If these values are not clustered around zero, the user should 
provide an offset to zero them out (explained below). 
Some of the Stretch functions provide very different results depending on the Peak 
level of the data (the largest data values of interest). These functions include 
ArcSinh(x) or any Log(x) function. If the Peak level is much smaller than 1, the result 
will be very similar to an unstretched, or Linear, function. If the entire image is scaled 
upwards (by multiplying by a constant) these Stretch functions will enhance the 
fainter parts of the image relative to the brightest peaks. This enhancement increases 
as the Scaled Peak level (54) is scaled to larger numbers (100, 1000, etc.). 
The FITS Liberator can zero the background properly and adjust the value of the 
peak. These are set using the values in the Background level (52), Peak level (53), 
and Scaled Peak level (54) text boxes. Before a Stretch function is applied to an 
image, its data will be rescaled using the formula: 
Scaled Image = Scaled Peak level * (Input Image – Background level) / (Peak level – 
Background level)
1
The Background level (52) should be set to equal the numeric value of the pixels in 
the image that should be rendered as black. These numbers can be determined, for 
example, by running the cursor over the darkest parts of the image in the Preview 
window and looking at the Input values under image data (31). 
The Peak level (53) should be set to equal the numeric value of the brightest areas of 
interest in the image. Note that this may not be the absolute brightest object in the 
image! Often the important part of an image is a nebula or galaxy that is much fainter 
1
Note that this equation is slightly simplified as the parameter Scaled Background level 
mentioned in Appendix B has been set explicitly to zero since FITS Liberator v.2. 
The ESA/ESO/NASA FITS Liberator User’s Guide 
29 
than the brightest stars. In this case, the Peak level should be set to the very 
brightest level of the nebula or galaxy. 
The Scaled Peak level (54) is a free parameter that the user can adjust to obtain the 
best visual result after the Background level (52) and Peak level (53) have been set 
appropriately. Note that this will only affect the results of a Log() or ArcSinh() Stretch 
function. Useful values tend to be in the range of 10 to 10,000, with the larger values 
bringing up more of the faint detail. Values as small as 0.1 are nearly 
indistinguishable from a simple Linear function and will not enhance faint structure at 
all. 
The FITS Liberator allows the Background level (52) and Peak level (53) to be set in 
four different ways:  
1.  Auto Scaling button (57): Clicking this button will use the existing settings 
for the Black and White level indicators below the Histogram window and set 
the Scaled Peak level to 10. This is often a good first guess. 
2.  Background level and Peak level from reading the Black and White level 
buttons under the Histogram window (18, 19)The buttons to the right (55, 
56) allow the user to individually set the Background/Peak levels based on 
the respective Black and White level settings. Unlike the Auto Scaling button, 
only one of the values is updated at a time, and the Scaled Peak level (54) 
keeps its current value. Note that the histogram range (15) will be adjusted 
when the Scaling takes place (as the Background level and the Peak level 
change), i.e. the histogram now shows the pixel value distribution of the 
Scaled Image and not the original Input Image. 
3.  Background/ Peak level selectors (9, 10): The bottom two eyedropper tools 
in the toolbox will directly sample Background/Peak levels from within the 
image. They take the median value of a 10x10 box around the click location. 
4.  Text field entry (52, 53): Values can be typed directly into the text fields. 
Hitting either the Tab or Enter keys is necessary for the change to take effect. 
Scientific notation of the form “1.25e5” may be used if desired. 
NOTE: The Background level must logically be smaller than the Peak level. Any 
attempt to violate this using any input method will be ignored. Note also that the initial 
values for Peak level and Scaled Peak level are set to the best guess for the White 
level; this means that the default result for the Scaled data will be equal to the Input 
value (i.e. no Scaling). 
If the “Apply stretch directly” in the Options Dialog is disabled (i.e. not checked) then 
the button “Apply values” (58) is enabled. In this case applying the typed in values in 
the Background, Peak and Scaled Peak level text fields (52-54) happens by clicking 
the Apply values button (58). In this way it is possible to adjust all three values 
without having to do all the image statistics for each text field entry. This may save 
significant time when working with large images. 
To experiment with these adjustments, open an image with high dynamic range (for 
example a galaxy or nebula image). Use one of these methods to set the 
Background level to the value of the background noise in the image and the Peak 
level to the brightest area of interest. Now choose either the Log(x) or ArcSinh(x) 
Stretch function. 
To see how Scaled Peak level (54) affects the Stretch, experiment by entering 
different numbers in this field. Start with values around 0.1 and switch back to Linear 
for comparison; they should look very similar. Switch back to the other function and 
The ESA/ESO/NASA FITS Liberator User’s Guide 
30 
start increasing the Scaled Peak level by factors of 10: 1, 10, 100, 1000. Notice how 
the larger values enhance the fainter structures better. Figure 6 illustrates the effects 
of the different Stretch functions and Peak level on a single image. 
5.8  Processing Tab: Channels 
The Channel radio buttons (59-61) determine the bit depth with which the TIFF file is 
saved. Photoshop 7 and CS can both handle 8-bit or 16-bit channels, while since 
CS2, Photoshop can handle 32-bit channels.  
The default for this is 16-bit channels, which gives a lot of flexibility in subsequent 
adjustments in, e.g., Photoshop without risk of posterizing (this is most likely when 
using large gamma or Curves adjustments to bring up faint features). It is possible to 
use 8-bit as well, but this is suggested only for extremely large images, since it will 
reduce the file size by a factor of two.  
Photoshop does support 32-bit channels, but treats such images differently. This 
mode is intended for HDRI (High Dynamic Range Imaging) that captures the full 
luminance in a photographic scene. While this is similar to the challenges faced in 
rendering high dynamic range astronomical images, few of the standard tools are 
supported, making it difficult to create good image composites in this mode. 
5.9  Processing Tab: Undefined Values 
Undefined data values arise in an image if there is no data for that region. Some 
FITS files mark empty pixels as “blank” using a special data value. The FITS 
Liberator uses the Undefined Values Radio buttons (62, 63) determine how these 
pixels are saved in the TIFF file. If Black (62) is selected, then they simply appear as 
black pixels. If Undefined Transparent (63) is selected, the image is saved with 
transparent areas wherever the image is undefined. 
NOTE: Some image viewers / editors may have problems with reading TIFF files with 
transparency pixels embedded. In this case there are two things the user can do. 
Either use a different viewer/editor (both Photoshop and The GIMP support 
transparency in TIFF files) or save as black pixels. 
5.10  Processing Tab: Other Settings 
The far right column (64-77) of the FITS Liberator provides a number of useful 
settings. In addition to the Open new file (64), Save file (65) and Save & edit (66) 
buttons, the user can use the Reset button (69) to return to the best initial guesses 
for the parameters and the Preferences/Options button (67) to open a new dialog 
with various options for setting the initial guess and histogram markers. The Preview 
checkbox (70) enables the Preview window (11) on the left (it may be useful to turn 
this off to improve performance on large files). The About button (68) displays the 
about box associated with the FITS Liberator. 
The Flip Image checkbox (71) determines how a FITS image will be rendered. The 
FITS format is very flexible in how image data can be recorded as data; it may be 
entered row-by-row from either the bottom or top. Standard image viewing formats 
always display from the top down. Therefore it is often necessary to vertically flip an 
image so it displays properly in Photoshop (this usually means how it is seen on the 
sky). The FITS Liberator will attempt to determine the proper setting for this checkbox 
from the header, but if the image appears mirror-imaged, the user can flip it the other 
Documents you may be interested
Documents you may be interested