Moritz Lennert 798f3dd31d i.segment: manual page - added explanation of scaling of threshold 8 anni fa
..
Makefile 68e5c7cf07 i.segment: fix Makefile 12 anni fa
README bc8a87f167 i.segment: update README 8 anni fa
cluster.c 6d56fcaa5c i.segment: +mean shift 8 anni fa
create_isegs.c 32a94a98ef i.segment: improvement for https://trac.osgeo.org/grass/ticket/3084 8 anni fa
flag.c 47bc7b03bc move i.segment.xl to trunk 12 anni fa
flag.h 47bc7b03bc move i.segment.xl to trunk 12 anni fa
i.segment.html 798f3dd31d i.segment: manual page - added explanation of scaling of threshold 8 anni fa
i_segment_lsat7_pan.png 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
i_segment_lsat7_seg_min100.png 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
i_segment_lsat7_seg_min5.png 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
i_segment_ortho_segs_final.jpg 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
i_segment_ortho_segs_l1.jpg 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
i_segment_ortho_segs_l2_l5.jpg 228f6e68eb i.segment manual: Landsat7 example added 9 anni fa
iseg.h 6d56fcaa5c i.segment: +mean shift 8 anni fa
main.c 6d56fcaa5c i.segment: +mean shift 8 anni fa
mean_shift.c 6d56fcaa5c i.segment: +mean shift 8 anni fa
ngbrtree.c 32a94a98ef i.segment: improvement for https://trac.osgeo.org/grass/ticket/3084 8 anni fa
ngbrtree.h 32a94a98ef i.segment: improvement for https://trac.osgeo.org/grass/ticket/3084 8 anni fa
open_files.c 32a94a98ef i.segment: improvement for https://trac.osgeo.org/grass/ticket/3084 8 anni fa
outline 47bc7b03bc move i.segment.xl to trunk 12 anni fa
parse_args.c d01237a762 i.segment: watershed method disabled, see https://trac.osgeo.org/grass/ticket/3181 8 anni fa
rclist.c 0c5cffd1e9 i.segment update 12 anni fa
region_growing.c 6d56fcaa5c i.segment: +mean shift 8 anni fa
regtree.c 32a94a98ef i.segment: improvement for https://trac.osgeo.org/grass/ticket/3084 8 anni fa
regtree.h 47bc7b03bc move i.segment.xl to trunk 12 anni fa
watershed.c 13193822a6 i.segment: prepare for different algorithms 8 anni fa
write_output.c 6d56fcaa5c i.segment: +mean shift 8 anni fa

README

i.segment basically works in three steps:

[Note: the word "segment" has two meanings here - data segments which are like data tiles (SEGMENT library) and image objects that are the result of the segmentation algorithm. In following, an attemps is made to systematically use 'segment' for the former and 'object' for the latter.]

1) open input files and put the data in data segments: open_files(), implemented in open_files.c
Pre-defined boundaries can be supplied with the "bounds" option. The meaning of these boundaries is that objects will not cross these boundaries.
Seed objects can be supplied with the "seeds" option. All pixels belonging to the same seed are combined to one initial object.

2) run algorithm that identifies for each pixel the id of the object this pixel is part of: create_isegs(), implemented in create_isegs.c, which currently contains only one algorithm, region-growing, implemented in region_growing() and related functions

3) write output raster files: write_output() implemented in write_output.c

Variables and structures used in all functions are passed around using a structure called globals, defined in iseg.h.

All module parameters and flags are defined in parse_args.c

There are two generic balanced binary search tree (Red Black Tree) implementations used in the region-growing algorithm, one for keeping track of the object pixels belong to (regtree.c/h) and the other for keeping track of the neighbors (ngbrtree.c/h). There is a also a small library of routines allowing to "flag" pixels in raster maps (flag.c/h), used to flag null cells in the input maps.

A new algorithm can be added by adding new methods to the method option and creating the required functions to be called by create_isegs(). Additionally, the read_seed() function in open_files.c will also need to be updated to calculate the metrics per object required by the selected method.