pearl-public/igor-public
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

bug fixes in angle scan processing and documentation

Browse Source
This commit is contained in:
muntwiler_m
2019-02-28 18:55:29 +01:00
parent 9a81493a1a
commit 0fb0fd92c8
6 changed files with 132 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
doc/config.dox
View File

@ -768,7 +768,8 @@ INPUT = ../pearl \
# possible encodings.
# The default value is: UTF-8.
INPUT_ENCODING = CP1252
#INPUT_ENCODING = CP1252
INPUT_ENCODING = ISO-8859-15
# If the value of the INPUT tag contains directories, you can use the
# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
@ -874,14 +875,15 @@ INPUT_FILTER =
# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
# patterns match the file name, INPUT_FILTER is applied.
FILTER_PATTERNS = "*.ipf=\"gawk -f doxygen-filter-ipf.awk\""
#FILTER_PATTERNS = "*.ipf=\"/usr/bin/gawk -f doxygen-filter-ipf.awk\""
FILTER_PATTERNS = "*.ipf=/bin/sh doxygen-filter-ipf.sh"
# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
# INPUT_FILTER) will also be used to filter the input files that are used for
# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
# The default value is: NO.
FILTER_SOURCE_FILES = YES
FILTER_SOURCE_FILES = NO
# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and

3
doc/doxygen-filter-ipf.sh Executable file
View File

@ -0,0 +1,3 @@
#!/bin/sh
gawk -b -f doxygen-filter-ipf.awk "$1"

26
doc/src/anglescan-processing.dox
View File

@ -2,7 +2,7 @@
@tableofcontents
\section sec_intro Introduction
\section sec_anglescan_intro Introduction
This page describes the data processing steps of angle-scans using the PEARL Procedures.
The description relies on using the command line regardless of available GUIs.
@ -170,6 +170,9 @@ Depending on the quality of the measured data,
only some of the following processing steps are necessary.
Use your own judgement.
There is a GUI for the processing steps in @ref pearl-anglescan-panel.ipf
(@ref asp_show_panel function or the PEARL/process menu).
\subsection sec_norm_prep Preparations
Start by creating a new copy of the data and inspecting it:
@ -216,7 +219,7 @@ Then set <code>check=1</code> to apply the normalization to <code>NormData1</cod
\subsection sec_norm_wobble Azimuthal variation (wobble)
Reduce the effect of azimuthal wobble (misaligned surface) on intensity.
A misaligned surface may cause a sinusoidal variation of the intensity as a function of azimuthal angle with a 360&degree; period.
A misaligned surface may cause a sinusoidal variation of the intensity as a function of azimuthal angle with a 360&deg; period.
A strong azimuthal variation may affect the polar normalization in the next step.
The azimuthal normalization can be based on a restricted range of polar angles (theta range).
You have to find out which value works best for your sample.
@ -324,6 +327,25 @@ ModifyGraph zColor(polarY0)={mod_values,-0.2,0.2,BlueGreenOrange,0}
@endcode
\subsection sec_projection Projection
The @ref display_hemi_scan and @ref interpolate_hemi_scan functions take an optional argument `projection`
which selects one of the following projections.
By default, stereographic projection is selected.
| Selector | Projection | Function | Properties |
| :----: | :----: | :----: | :---- |
| kProjDist = 0 | azimuthal equidistant | r = c * theta | radius is proportional to polar angle |
| kProjStereo = 1 | stereographic | r = c * tan theta/2 | circles on sphere map to circles |
| kProjArea = 2 | azimuthal equal-area | r = c * sin theta/2 | preserves area measure |
| kProjGnom = 3 | gnomonic | r = c * tan theta | great circles map to straight lines |
| kProjOrtho = 4 | orthographic | r = c * sin theta | momentum mapping in ARPES and LEED |
For a description of the different projections,
see [Wikipedia](https://en.wikipedia.org/wiki/Map_projection), for example.
The projections in this package are defined for 0 <= theta < 90.
\section sec_export Data export
\subsection sec_export_plot Export picture