home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / pgmkernel.1 < prev    next >
Text File  |  1996-11-18  |  1KB  |  61 lines
  1. .TH pgmkernel 1 "10 December 1992"
  2. .IX pgmkernel
  3. .SH NAME
  4. pgmkernel - generate a convolution kernel
  5. .SH SYNOPSIS
  6. .B pgmkernel
  7. [
  8. .B \-weight
  9. .I w
  10. ]
  11. .I width 
  12. [ 
  13. .I height 
  14. ]
  15. .SH DESCRIPTION
  16. Generates a portable graymap array of size
  17. .I width 
  18. x 
  19. .I height 
  20. (or 
  21. .I width 
  22. x 
  23. .I width 
  24. if 
  25. .I height 
  26. is not specified) to be used as a convolution file by
  27. .BR pnmconvol .
  28. The data in the convolution array K are computed according to the
  29. formula:
  30. .PP
  31. K(i,j) = 1 / ( 1 + w * sqrt((i-width/2)^2 + (j-height/2)^2)) 
  32. .PP
  33. where 
  34. .I w 
  35. is a coefficient specified via the 
  36. .I \-weight 
  37. flag, and
  38. .I width 
  39. and 
  40. .I height
  41. are the X and Y filter sizes.
  42. .PP
  43. The output PGM file is always written out in ASCII format.
  44. .SH OPTIONS
  45. The optional 
  46. .I -weight 
  47. flag should be a real number greater than -1.
  48. The default value is 6.0.
  49. .SH BUGS
  50. The computation time is proportional to 
  51. .I width 
  52. * 
  53. .IR height .
  54. This increases rapidly with the increase of the kernel size.  
  55. A better approach could be using a FFT in these cases.
  56. .SH "SEE ALSO"
  57. pnmconvol(1), pnmsmooth(1)
  58. .SH AUTHOR
  59. Alberto Accomazzi (alberto@cfa.harvard.edu).
  60.  
  61.