Author Topic: ImageIntegration documentation updated (preview)  (Read 4845 times)

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7089
    • View Profile
    • http://pixinsight.com/
ImageIntegration documentation updated (preview)
« on: 2013 October 03 10:47:37 »
Hi all,

I have just finished a complete revision of the reference documentation for the ImageIntegration tool. I have rewritten many sections, and I have added new material to document new features. Lots of errors and inaccuracies have also been fixed. While I release official updates to the core application, a new documentation system and some new tools, here is a preview of the new ImageIntegration reference document:

http://pixinsight.com/doc/tools/ImageIntegration/ImageIntegration.html

On the theoretical part of this document, I have tried to be much more rigorous and comprehensive with many key topics of the image integration task, with more detailed descriptions of the implemented algorithms. The practical part (the Usage section) is also more extensive, and documents all of the new features in the latest versions of the ImageIntegration tool. There are also more and better usage hints at the end of the document. I hope you like it and find it useful. As soon as I have another "time window", I'll start a complete revision of the documentation for StarAlignment.

The above document has been created with the latest version 1.4 of the PixInsight Documentation Compiler script, which I'll also release very soon. Among many improvements, the new compiler comes with automatic rendering of embedded LaTeX equations, automatic numbering of references, equations, tables and figures through symbolic references, a new document class for the PixInsight JavaScript Runtime, and generation of dynamic contents. Note for example what happens when you mouse over bibliographic and equation references.
Juan Conejero
PixInsight Development Team
http://pixinsight.com/

Offline Sean

  • PixInsight Addict
  • ***
  • Posts: 144
    • View Profile
    • My Personal Website
Re: ImageIntegration documentation updated (preview)
« Reply #1 on: 2013 October 03 14:14:19 »
Juan,

This is an impressive piece of work, both in terms of understanding the use of Image Integration in PI, and also gaining a deeper understanding of the general principles involved. I look forward to spending some time reading it in detail - it's like taking a course!

Thanks for all your hard work,

Sean

Offline Philippe B.

  • PixInsight Old Hand
  • ****
  • Posts: 398
    • View Profile
    • CIEL AUSTRAL
Re: ImageIntegration documentation updated (preview)
« Reply #2 on: 2013 October 03 23:40:08 »
Thank you Juan, nice and very useful !!!
Cheers

Offline georg.viehoever

  • PTeam Member
  • PixInsight Jedi Master
  • ******
  • Posts: 2132
    • View Profile
Re: ImageIntegration documentation updated (preview)
« Reply #3 on: 2013 October 04 02:32:05 »
Epic! The printed version is 43 pages. That's more documentation for a single module than I have seen as full documentation for many other "professional" products. Plus it is much more comprehensive than the usual "click here, than drag this..." type of documentation that you often get these days.

Will study it in the bath tub  :)
Georg
Georg (6 inch Newton, unmodified Canon EOS40D+80D, unguided EQ5 mount)

Offline bitli

  • PTeam Member
  • PixInsight Guru
  • ****
  • Posts: 511
    • View Profile
Re: ImageIntegration documentation updated (preview)
« Reply #4 on: 2013 November 19 12:09:26 »
Thank you. As usual it is more than a documentation, it is a piece of art.
I cannot overstate how much I feel that the documentation adds a lot of value to PI. It is both advanced and  by nature very relevant to the product.
Hope to see more,
Your never satisfied :-)
-- bitli

Offline jkmorse

  • PixInsight Padawan
  • ****
  • Posts: 931
  • Two questions, Mitch . .
    • View Profile
    • Jim Morse Astronomy
Re: ImageIntegration documentation updated (preview)
« Reply #5 on: 2013 November 20 02:36:52 »
Juan,

It is this type of intellectual rigor that makes using PI so damned much fun. 

Thanks for another outstanding piece of work.

Jim
Really, are clear skies, low wind and no moon that much to ask for? 

New Mexico Skies Observatory
Apogee Aspen 16803
Planewave CDK17 - Paramount MEII
Planewave IFR90 - Astrodon LRGB & NB filters
SkyX - MaximDL - ACP

http://www.jimmorse-astronomy.com
http://www.astrobin.com/users/JimMorse

Offline dayers

  • PixInsight Addict
  • ***
  • Posts: 201
    • View Profile
    • The Orlop
Re: ImageIntegration documentation updated (preview)
« Reply #6 on: 2013 November 20 08:13:31 »
+1
Dave Ayers
  Stellarvue 80 mm refractor on CG-5 mount, Orion 50mm guide scope. Imaging camera SBIG STF-8300M, guide camera ASI120mm. PHD Guiding. Sequence Generator Pro, PixInsight.

Offline pk825

  • Newcomer
  • Posts: 22
    • View Profile
Re: ImageIntegration documentation updated (preview)
« Reply #7 on: 2013 November 20 08:59:06 »
Great documentation!

I find a little error: the link of the SubframeSelector
(http://pixinsight.com/doc/scripts/SubframeSelector/SubframeSelector.html) in the middle of the document doesn't work.


Offline mschuster

  • PTeam Member
  • PixInsight Jedi
  • *****
  • Posts: 1087
    • View Profile
Re: ImageIntegration documentation updated (preview)
« Reply #8 on: 2013 November 20 11:07:22 »
Hi Juan,

A note on the Sn and Qn Estimators of Rousseeuw and Croux section in your new documentation.

The Sn definition includes normalization factors, a sample size dependent scaling along with an additional standardized dispersion scaling.

It appears the Statistics process implementation does use these factors (at least for large sample size image test I did), but the documentation does not mention them.

Thanks,
Mike

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7089
    • View Profile
    • http://pixinsight.com/
Re: ImageIntegration documentation updated (preview)
« Reply #9 on: 2013 November 22 02:15:37 »
Hi Mike,

Quote
The Sn definition includes normalization factors, a sample size dependent scaling along with an additional standardized dispersion scaling.

My implementation in PCL (and by extension on the whole PixInsight platform) applies correction factors for finite sample sizes. I haven't mentioned them because they are actually irrelevant for images, since in this context we are working with very large sample sizes, where these corrections are immaterial. Specifically, the correction factor c for sample sizes larger than 9 items is:

For Sn:
For odd sample size n: c = n/(n - 0.9)
For even sample size n: c = 1

For Qn:
For odd sample size n: c = n/(n + 1.4)
For even sample size n: c = n/(n + 3.8)

For coherence with already existing statistical estimators in PCL, the normalization factors are not applied by default in my implementation. They are not used in the ImageIntegration tool either, since in this case we are comparing the same scale estimates between pairs of images, and hence the normalization factors cancel out. The factors that make these estimators converge to the standard deviation of a normal distribution are:

For Sn: k = 1.1926
For Qn: k = 2.2219
Juan Conejero
PixInsight Development Team
http://pixinsight.com/

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7089
    • View Profile
    • http://pixinsight.com/
Re: ImageIntegration documentation updated (preview)
« Reply #10 on: 2013 November 22 03:09:35 »
Thank you all for your nice words. I'm glad you like this document.
Juan Conejero
PixInsight Development Team
http://pixinsight.com/