Esta bien yo tambien me incluyo aunque no siempre es asi, generalmente quizas muchos coincidan conmigo pero al hacer sofwtware que en realidad son scripts de un alto funcionamiento pero de pequeño codigo no consideramos que deba tener documentacion, es mas es porque es para un uso comercial personal .. pero..

Cuando comenzamos a hacer proyectos de mayor magnitud llamese sistema, portal inteligente, RIA, es necesario documentar... esteee disculpa xyox pero a que te refieres con documentar..

Cito:

En otras palabras, la documentación es un conjunto de información que expresa detalles de estos sistemas, la forma adecuada de operar con él, nos permite interpretar los errores, conocer su proceso, etc.

Bueno esto podemos decir que es algo tedioso, algo cansado, pero es algo que cuando lo terminemos nos dara un mejor nivel capaces de solucionar errores rapidamente y no cometerlos posteriormente, debe ser una costumbre nuestra.. a continuacion copypasteo el post realizado por ElCodigoK...

Si bien sabemos la importancia que tiene la documentación en los sistemas y aún sabiendo esto, rara vez hacemos el intento de documentar los procesos del sistemas, las funciones que incorpora, la estructura general de clases y ni hablar de los modelados de datos.

Creo que esta cuestión esta ligada por sobre todas las cosas a varios factores que voy a mencionar:

Falta de personas en un proyecto

Definitivamente es una variable que en la mayoría de los proyectos de software sucede y que es la falta de personas en los proyectos. Dependiendo del proyecto la cantidad de Ingenieros, Analistas o Programadores va a variar notablemente, y ésta falta de integrantes se hace sentir para tener todo documentado, seguramente los Analistas estarán preocupados en realizar un análisis y diseño perfecto, mientras que los desarrolladores se preocuparán más por la programación y las funcionalidades del sistema.

Mala distribución de las tareas

Vamos a suponer que nuestro limitante ahora no es la falta de personal, sino más bien una mala distribución de las tareas asignadas, dejando de lado y solo al final del proyecto la creación de los documentos y la propia documentación del código fuente. Esto también esta aparejado con el bajo control de exigencia para con estos documentos y por sobre todas las cosas no dejarlos como una última tarea sino más bien como una tarea paralela al Análisis, Diseño, Desarrollo y Pruebas.

Falta de experiencia

Nuevo limitante para la documentación, la experiencia es un factor importante y nos lleva a tener una buena idea de redacción y corrección de documentación precisa. Es de suma importancia adquirir experiencia en este tipo de tareas de documentación, tanto para no escribir documentos obsoletos y para que no falte información del proyecto.

No utilizar herramientas adecuadas

En la actualidad, la mayoría de los lenguajes de programación cuentan con herramientas que nos permite tanto organizar como agilizar el proceso de documentación en los códigos fuente. Con formatos mucho más profesionales y casi instantáneos, el echo de no utilizar estas herramientas hace que muchos de los programadores ni siquiera intenten documentar los procesos más importantes, las clases padres, etc.

Todos estos factores y seguramente muchos más hacen que la documentación de los proyectos de software sea nula, escasa, obsoleta, etc

Esto sin dudas es una tarea de suma importancia y un proceso de aprendizaje que no debemos dejar nunca de lado.

Saludos

El objetivo de esto es simple, necesitamos reconocer formas a partir de
simples líneas, cuadrados, rectángulos, triángulos y hasta círculos. Esto es un  reto para los métodos de inteligencia artificial, desde hace muchos años estos  métodos ya estaban en teoría desarrollados pero por las limitaciones de los  computadores, velocidad de procesamiento, memoria entre otras cosas era  muy pesado o poco probable desarrollar exitosamente estas técnicas.

Transformada de Hough

La transformada de Hough consiste en permitir descubrir las formas en una
imagen. Se basa en transformar puntos de la imagen en un espacio de
parámetros. La idea es encontrar rectas, como se menciono en teoría se
pueden encontrar varias formas, pero el costo computacional es elevado.

La aplicación mas simple de la transforma de hough es para la detección de
rectas, lo primero es tener una imagen binarizada, resultado de la detección
de bordes. Para cada punto x, y de la imagen que estemos utilizando pasan
infinitas rectas de la forma: y=ax+b, la ecuación de la recta. Luego cada
punto x, y vota para cada pareja de puntos que satisface b=y-ax.

El algoritmo tiene que recorrer todos los puntos x, y, y para cada uno votar
en el espacio de parámetros m, b o también llamado acumulador. Luego la
pareja m, b con más votos o el máximo del acumulador da la ecuación de la
recta.

Hasta aquí hemos llegado de manera sencilla con nuestro algoritmo, pero
existe un problema, los valores de m tienden al infinito, por lo que
almacenarlos y graficarlos será un impedimento para el uso de la
transformada.

La solución planteada es la siguiente, si bien y = ax + b, se dice que toda
ecuación puede ser representada en senos y cósenos es así que la ecuación de la recta de la forma y = ax + b, puede ser representada como:

p = xcos(θ) + ysen(θ)

Esta es la llamada ecuación en la forma normal de la recta, donde p es la
distancia de la recta al origen y θ es el ángulo entre la perpendicular y el eje  x, de esta forma son menos los puntos que hay que recorrer y por lo tanto más rápido es el algoritmo.

Los límites de estos están dados por las siguientes condiciones, θ varia entre 0 y 180 ya que a partir de 180 hasta 360 grados se vuelven a cruzar las curvas y p varia en la diagonal de la imagen es decir la hipotenusa con respecto a los lados de la imagen original.

Implementación en el lenguaje PHP

Si bien PHP esta orientado para el desarrollo de páginas dinámicas para entorno Web, eso no le quita potencialidad a la hora de usarlo como lenguaje de desarrollo para algoritmos complejos, ya que la gran facilidad que nos brinda en la manipulación de los tipos de datos lo hacen flexible a estas
situaciones.

PHP usa la librería GD para manipulación de imágenes, los pasos que
seguiremos en la implementación son los siguientes:

• Implementación de un frontend simple
• Detección de bordes, aplicando el filtro Sobel.
• Binarizacion de las líneas en contraste con el fondo.
• Implementación del acumulador.
• Graficar el acumulador en una nueva imagen.

La interfaz será sencilla, constara de un formulario base donde podamos subir una imagen y cajas de entrada para la personalización del método a emplear:

Al momento de subir la imagen, la convertiremos dinámicamente al formato PNG de acuerdo a su actual extensión

switch ($ext) {
case 'jpeg':
case 'jpg': $imEntrada = imagecreatefromjpeg($archivo['tmp_name']);
break;
case 'gif': $imEntrada = imagecreatefromgif($archivo['tmp_name']);
break;
case 'png': $imEntrada = imagecreatefromgif($archivo['tmp_name']);
break;
}
imagepng($imEntrada,$this->IMG_ENTADA);

Donde this->IMG_ENTADA es el nombre de entrada que definimos previamente junto con el nombre de salida de las imágenes

$tratamiento = new TratamientoImagen();
$tratamiento->IMG_ENTADA = "entrada.png";
$tratamiento->IMG_SALIDA = "salida.png";

Necesitamos detectar los bordes de la imagen, en este resumen no incluiré la forma como se desarrollara la misma, en el proyecto presentado se uso el Filtro Sobel

Ahora podemos aplicar la transformada de Hough:

for ($y=0; $y<$alto; $y++) {
    for ($x=0; $x<$ancho; $x++) {
        if ($matrImag[$y][$x] == 1) {
           for ($theta=0; $theta<$maximoTheta; $theta+=1) {
                $r = $x * cos(deg2rad($theta)) + $y * sin(deg2rad($theta));
                if (!isset($data[(int)$theta][(int)$r])) {
                  $data[(int)$theta][(int)$r] = 1;
                } else {
                  $data[(int)$theta][(int)$r] ++;
                }
             }
         }
      }
}

Donde la matriz $data es nuestro acumulador, finalmente graficamos los
votos recibidos en esta matriz

Descargar PDF
Descargar Codigo

Gracias a las listas de ubuntu por la noticia

Fuente