thm.rectify
(15 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{DavinciWiki_Function| | {{DavinciWiki_Function| | ||
− | + | Rotates and slants a geometrically projected [[THEMIS]] cube to minimize the black space and prepare the data for [[thm.deplaid]]. The image is first rotated to make a designated line of the image parallel with the x axis and then the left edge of the data is pixel shifted over to the y axis. This results in some reversible spatial distortion depending on the projection. This process is reversed with [[thm.reconstitute]]. | |
Located in "thm" module| | Located in "thm" module| | ||
− | + | Input: geometrically projected THEMIS cubes of at most 10 bands of type byte, short, int or float. | |
− | + | Output: a davinci structure containing the elements angle, leftedge and data| | |
− | + | [[Syntax]]: thm.rectify(obj = VAL [, ignore = VAL] [, trust = FLOAT] [, force = 1]) | |
− | + | obj - a geometrically projected THEMIS cube | |
− | + | ignore - the value in non-data pixels of the projected cube. Default is -3.402822655e+38. | |
− | + | trust - location in the image the angle should be determined. | |
− | + | 0 = top, 1 = bottom, .25 = 25 percent down the image, etc. Default is 0 (top). | |
− | + | force - forces rectify() to use an ignore value even if it complains. Default is 0. | |
TROUBLESHOOTING | TROUBLESHOOTING | ||
− | + | The ignore value will ALWAYS be set to -32768 when rectifying! | |
− | + | Rectify checks for appropriate ignore value before running. | |
− | + | You can override ignore value warning by setting force = 1 | |
| | | | ||
− | + | dv> a | |
+ | 1356x7100x10 array of float, bsq format [385,104,000 bytes] | ||
− | b = thm.rectify(a) | + | dv> b = thm.rectify(obj=a) |
+ | struct, 4 elements | ||
+ | angle: 3.33555 | ||
+ | data: 345x7179x10 array of float, bsq format [99,070,200 bytes] | ||
+ | leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] | ||
+ | width: 1356 | ||
− | b = thm.rectify(obj=a,ignore=0,trust=2,force=1) | + | dv> b = thm.rectify(a) |
+ | struct, 4 elements | ||
+ | angle: 3.33555 | ||
+ | data: 345x7179x10 array of float, bsq format [99,070,200 bytes] | ||
+ | leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] | ||
+ | width: 1356 | ||
+ | |||
+ | dv> b = thm.rectify(obj=a,ignore=0,trust=2,force=1) | ||
+ | struct, 4 elements | ||
+ | angle: 3.33555 | ||
+ | data: 345x7179x10 array of float, bsq format [99,070,200 bytes] | ||
+ | leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] | ||
+ | width: 1356 | ||
| | | | ||
− | [[Image: | + | [[Image:norectify.png|195px]] [[Image:rectify.png|100px]] |
| | | | ||
| | | | ||
*[[thm.reconstitute]] | *[[thm.reconstitute]] | ||
− | *[[ | + | *[[rotate]] |
*[[thm.deplaid]] | *[[thm.deplaid]] | ||
+ | | | ||
+ | | | ||
+ | 2.10 | ||
| | | | ||
}} | }} | ||
− | [[category: | + | [[category:Functions]] |
+ | [[category:Modules]] | ||
[[category:THEMIS Science]] | [[category:THEMIS Science]] | ||
− | [[category: | + | [[category:64-bit]] |
Latest revision as of 14:52, 16 January 2013
Contents: Description, Arguments, Usage, Examples, Images, Related Functions Supported Under Version: > 2.10 Current Davinci Version: 2.27 64-bit Safe: Yes
Description Rotates and slants a geometrically projected THEMIS cube to minimize the black space and prepare the data for thm.deplaid. The image is first rotated to make a designated line of the image parallel with the x axis and then the left edge of the data is pixel shifted over to the y axis. This results in some reversible spatial distortion depending on the projection. This process is reversed with thm.reconstitute. Located in "thm" module
Arguments and Return Values Input: geometrically projected THEMIS cubes of at most 10 bands of type byte, short, int or float. Output: a davinci structure containing the elements angle, leftedge and data
Usage Syntax: thm.rectify(obj = VAL [, ignore = VAL] [, trust = FLOAT] [, force = 1]) obj - a geometrically projected THEMIS cube ignore - the value in non-data pixels of the projected cube. Default is -3.402822655e+38. trust - location in the image the angle should be determined. 0 = top, 1 = bottom, .25 = 25 percent down the image, etc. Default is 0 (top). force - forces rectify() to use an ignore value even if it complains. Default is 0. TROUBLESHOOTING The ignore value will ALWAYS be set to -32768 when rectifying! Rectify checks for appropriate ignore value before running. You can override ignore value warning by setting force = 1
Examples dv> a 1356x7100x10 array of float, bsq format [385,104,000 bytes] dv> b = thm.rectify(obj=a) struct, 4 elements angle: 3.33555 data: 345x7179x10 array of float, bsq format [99,070,200 bytes] leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] width: 1356 dv> b = thm.rectify(a) struct, 4 elements angle: 3.33555 data: 345x7179x10 array of float, bsq format [99,070,200 bytes] leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] width: 1356 dv> b = thm.rectify(obj=a,ignore=0,trust=2,force=1) struct, 4 elements angle: 3.33555 data: 345x7179x10 array of float, bsq format [99,070,200 bytes] leftedge: 1x7179x1 array of int, bsq format [28,716 bytes] width: 1356
|
DavinciWiki Mini-Nav Bar Contents
Contact Developers
All other topics
Related Functions
Recent Core Changes Modified On: 01-16-2013 |