Author Topic: Delayed Documentation - Apologies and Explanations / Retraso en la Documentación - Disculpas y Explicaciones  (Read 18256 times)

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7111
    • http://pixinsight.com/
[Texto en Español abajo]

Hi all,

The official documentation for the core PixInsight application has been delayed almost two months. In this post I want to apologize for this unfortunate situation, as well as to expose the main reasons for this delay.

We started writing PixInsight Core 1.1 in February. This new version is very important for a number of technical reasons. It includes important improvements to the core processing engine, and overcomes a number of critical limitations in Core 1.0. I'll try to explain these limitations briefly in what follows.

As probably most of you know, PixInsight is based on the Qt framework to implement a portable, cross-platform graphical user interface. Qt is a well-known Trolltech product:

http://trolltech.com/qt/

The PixInsight core application is just one piece (obviously an essential one) of the PixInsight platform. It implements a sophisticated workspace with many functions that exceed what is customary in most imaging applications. For this reason, we had to write many custom adaptations of internal Qt code in the early stages of development, especially during 2006, and also in 2007. Unfortunately, some of these customizations cause serious problems with the latest versions of the Qt framework (with Qt 4.4 in particular).

These incompatibilities have forced us to write a completely new workspace system for PixInsight Core. Basically, the GUI (Graphical User Interface) has been rewritten from scratch in PixInsight 1.1: image windows, processing windows, and the entire workspace functionality. Initially, we thought that this task could be completed in two weeks. It has required more than one month of 12h/day work, and is now almost complete and ready for release. Of course, PixInsight continues being firmly sticked to Qt, but the difference is that now the core application is 99% new code that doesn't depend on custom adaptations of internal Qt code. The new workspace is much more stable, fast and versatile.

Besides incompatibility problems, there are some important projects that have required significant changes in critical parts of PixInsight. One of these projects has involved a full rewrite of all file format support modules. This project -which I prefer not to describe for now- means an amazing enhancement of PixInsight's capabilities.

All that I've described means a huge amount of work. We are a very small, emerging company, with few hands are lots of hard work. We fight to deliver the best software we are able to write, but sometimes we cannot face several important tasks simultaneously.

Now that we have almost completed version 1.1, the documentation is our highest priority. We'll be writing new documentation chapters at a constant rate in a week or earlier, starting from now. I ask you for a bit more of patience; what we have written is well worth the wait.

Thank you.

========================================================

Hola a todos.

La documentación oficial de la aplicación principal de PixInsight se ha retrasado casi dos meses. En este mensaje quiero pedir disculpas por esta situación desafortunada, así como exponer las principales razones para este retraso.

Comenzamos a escribir la versión 1.1 de PixInsight Core en febrero. Esta nueva versión es muy importante for varias razones técnicas. Incluye importantes mejoras en el motor de procesamiento de la aplicación principal, y supera varias limitaciones críticas que existen en Core 1.0. En lo que sigue trataré de explicar brevemente estas limitaciones.

Como probablemente sabe la mayoría, PixInsight está basado en el entorno de desarrollo Qt para implementar una interfaz gráfica de usuario portable y multiplataforma. Qt es un producto muy conocido creado por Trolltech:

http://trolltech.com/qt/

La aplicación principal de PixInsight es sólo una pieza (obviamente esencial) de la plataforma PixInsight. Implementa un espacio de trabajo sofisticado con muchas funciones que exceden lo que es habitual en la mayoría de las aplicaciones de edición de imágenes. Por esta razón, tuvimos que escribir muchas adaptaciones personalizadas de ciertas partes del código interno de Qt durante las etapas iniciales de desarrollo, especialmente en 2006, y también en 2007. Desafortunadamente, algunas de estas adaptaciones causan problemas serios con las últimas versiones del entorno Qt (en particular, con Qt 4.4).

Estas incompatibilidades nos han obligado a escribir un espacio de trabajo completamente nuevo para Pixinsight Core. Básicamente, toda la interfaz gráfica ha sido reescrita desde cero en PixInsight 1.1: ventanas de imagen, ventanas de proceso, y toda la funcionalidad del espacio de trabajo. Inicialmente, pensamos que esta tarea podría estar completada en unas dos semanas. Sin embargo ha requerido más de un mes completo a razón de 12 horas diarias de trabajo, y está casi terminado y listo para ser publicado en este momento. Por supuesto, PixInsight sigue firmemente fiel a Qt, pero la diferencia es que ahora la aplicación principal es 99% código nuevo que no depende de adaptaciones personalizadas de código interno de Qt. El nuevo espacio de trabajo es mucho más estable, rápido y versátil.

Aparte de problemas de incompatibilidad, hay varios proyectos importantes que han necesitado cambios significativos en partes críticas de PixInsight. Uno de estos proyectos ha supuesto la reescritura completa de todos los módulos de soporte de formatos de archivo. Este proyecto -que me permitiréis que no comente por el momento- significa una mejora impresionante de las capacidades de PixInsight.

Todo lo que he descrito significa una enorme cantidad de trabajo. Somos una empresa muy pequeña recién creada, con pocas manos y montones de duro trabajo. Luchamos para ofrecer el mejor software que somos capaces de escribir, pero a veces no podemos enfrentarnos con varias tareas importantes al mismo tiempo.

Ahora que casi hemos completado la versión 1.1, la documentación es nuestra prioridad máxima. Estaremos escribiendo nuevos capítulos de la documentación a un ritmo constante dentro de una semana o antes, a partir de ahora. Os pido un poco más de paciencia; la espera merece la pena por todo lo que hemos escrito.

Gracias.
Juan Conejero
PixInsight Development Team
http://pixinsight.com/

Offline avastro

  • PixInsight Addict
  • ***
  • Posts: 181
    • http://astrosurf.com/avastro/
Hola Juan,
Gracias por informarnos de la situación del desarrollo de PI.
Hicisteis un trabajo estupendo con este programa novador que no tiene comparación en esta área.
Estamos todos con ganas de poder utilizar todas las posibilidades de PI y poder llegar a niveles de resultados como los que publica el PI team y algunos colegas.
La documentación queda a mi punto de vista la tarea más importante a ser cumplida.
Sin duda su calidad es mucho más importante que la cantidad, así que toméis el tiempo de hacer algo que sea al nivel de lo que esperamos, que valga la pena la expectación.
Buen coraje a todos.':D'


Antoine
http://astrosurf.com/avastro/
Antoine
Lentin Observatory
http://www.astrosurf.com/avastro/

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com
Hello Leaders

I know you probably get tired of people asking but how long will it be before full documentation
will be completed


Regards Harry
Harry Page

Offline Nocturnal

  • PixInsight Jedi Council Member
  • *******
  • Posts: 2727
    • http://www.carpephoton.com
Hi,

indeed. I think for PI to truly break through this is the one point that needs attention. The software is different enough from CUI that the initial curve is a bit steep so that requires documentation.

I realize there's only so much time in the day. Maybe we should prioritize what we think should be documented? My vote is to first describe all processing modules in the 'fly out' section of the process explorer. Some of them are blank. Let's get a few paragraphs for each. Some of them are obscure enough that I'll admit I'm clueless what they do.
Best,

    Sander
---
Edge HD 1100
QHY-8 for imaging, IMG0H mono for guiding, video cameras for occulations
ASI224, QHY5L-IIc
HyperStar3
WO-M110ED+FR-III/TRF-2008
Takahashi EM-400
PIxInsight, DeepSkyStacker, PHD, Nebulosity