[SoC] Final Report - New rules for the Topology Framework in gvSIG Desktop

[José Olivas]

Hello everyone;

The GSoC2020 period code is finished. Now is time to present the final
report of my project. The work during these three months has been an
amazing experience and a huge challenge to develop my skills. But first of
all I would like to say thank you to Google, OSGeo and gvSIG for this
opportunity.

This report is done according to Google's Guidelines
<https://developers.google.com/open-source/gsoc/help/work-product> and OSGeo
GSoC Admins recommendations
<https://lists.osgeo.org/pipermail/soc/2020-August/004612.html>.

1. Basic info
*Title:
<https://github.com/jolicar/GSoC2020/wiki/GSoC2020-New-rules-for-the-Topology-Framework-in-gvSIG-Desktop%C2%A0>*New
rules for the Topology Framework in gvSIG Desktop
<https://github.com/jolicar/GSoC2020/wiki/GSoC2020-New-rules-for-the-Topology-Framework-in-gvSIG-Desktop>
*Organization:* gvSIG <http://www.gvsig.com/en/home> under OSGeo
<https://www.osgeo.org/>

2. Abstract
The project improves the topology core of gvSIG Desktop. In these three
months I have implemented five topology rules, three new rules and two
existing rules that have some issues.

The topology rules that I want to modify are
TopologyRuleMustBeProperlyInsidePolygonsPoint
<https://github.com/jolicar/TopologyRuleMustBeProperlyInsidePolygonsPoint>
and TopologyRuleContainsPointPolygon
<https://github.com/jolicar/TopologyRuleContainsPointPolygon>.

   - *TopologyRuleMustBeProperlyInsidePolygonsPoint;* The rule evaluates
   the point situation in or out polygons. This point's rule returns True when
   the points falls within the polygon's area, not on the boundary or out of
   it.
   - *TopologyRuleContainsPointPolygon;* If each polygon has at least one
   point inside, the rule returns True. The points have to fall within the
   polygon's area, not on the boundary or out of it.

The new rules to create are TopologyRuleContainsOnePointPolygon
<https://github.com/jolicar/TopologyRuleContainsOnePointPolygon>,
TopologyRuleMustCoverEachOtherPolygon
<https://github.com/jolicar/TopologyRuleMustCoverEachOtherPolygon> and UDR
(TopologyRuleUserDefinedRule)
<https://github.com/jolicar/TopologyRuleUserDefinedRule>.

   - *TopologyRuleContainsOnePointPolygon;*  If each polygon has only one
   point inside, the rule returns True. The point has to fall within the
   polygon's area, not on the boundary or out of it.
   - *TopologyRuleMustCoverEachOtherPolygon;* All dataset 2 polygon areas
   must cover the dataset 1 polygon area and all dataset 1 polygon areas must
   cover the dataset 2 polygon area too. The rule returns False when a part of
   the dataset 1 polygon area or dataset 2 polygon area is not covered or not
   completely covered.
   - *UDR (TopologyRuleUserDefinedRule);* This rule allows the user to
   define a data check expression and another expression to correct it. The
   dataset features are evaluated for the check expression and it gives a
   boolean. If the result is False,the feature dont fulfill the rule and it
   creates an entry in the error report. If the result is True, the feature
   fulfills the expression. On "Inspector de errores del Plan de topologia"
   window we can remove the feature or apply the corrective expression.

I had to create or update the documentation and create a test plan too.

3. The state of software BEFORE your GSoC
GvSIG desktop software has some topology rules but after studying these in
my internship at gvSIG Association that I have already completed I detected
some errors and important absence of useful topology rules for the users.
On development gvSIG Desktop had all GUI on his topology project. I just
need to modify the create rule GUI to allow additional parameters

4. The addition (added value)
The project is complete and the two new main additions are:

   - Five completely functional topology rules with new documentation and
   operative fixes actions.
   - New changes on topology core of gvSIG Desktop. This allows additional
   parameters in some topology rules. These changes can be useful in new rules
   implementation. Revisión 2067
   <http://devel.gvsig.net/redmine/projects/gvsig-projects-pool/repository/revisions/2067>
   and Revisión 2174
   <http://devel.gvsig.net/redmine/projects/gvsig-projects-pool/repository/revisions/2174>
   .

5. Future work to this project
The project is complete but it always can be improved. A possible
improvement is the creation of new fixed action for these five topology
rules. For example, the Subtract fixed action to MustCoverEachOtherPolygon
topology rule. This fix action deletes the no overlapping part to wrong
features.

6. Links

*WIKIS*

   - Project Wiki:
   https://github.com/jolicar/GSoC2020/wiki/GSoC2020-New-rules-for-the-Topology-Framework-in-gvSIG-Desktop

*DOCUMENTATION*

   - TopologyRuleMustBeProperlyInsidePolygonsPoint:
   https://github.com/jolicar/TopologyRuleMustBeProperlyInsidePolygonsPoint/blob/master/readme.md
   - TopologyRuleContainsPointPolygon:
   https://github.com/jolicar/TopologyRuleContainsPointPolygon/blob/master/readme.md
   - TopologyRuleContainsOnePointPolygon:
   https://github.com/jolicar/TopologyRuleContainsOnePointPolygon/blob/master/readme.md
   - TopologyRuleMustCoverEachOtherPolygon:
   https://github.com/jolicar/TopologyRuleMustCoverEachOtherPolygon/blob/master/readme.md
   - UDR (TopologyRuleUserDefinedRule:
   https://github.com/jolicar/TopologyRuleUserDefinedRule/blob/master/readme.md

*CODE*

   - TopologyRuleMustBeProperlyInsidePolygonsPoint:
   https://github.com/jolicar/TopologyRuleMustBeProperlyInsidePolygonsPoint/tree/master/code
   - TopologyRuleContainsPointPolygon:
   https://github.com/jolicar/TopologyRuleContainsPointPolygon/tree/master/code
   - TopologyRuleContainsOnePointPolygon:
   https://github.com/jolicar/TopologyRuleContainsOnePointPolygon/tree/master/code
   - TopologyRuleMustCoverEachOtherPolygon:
   https://github.com/jolicar/TopologyRuleMustCoverEachOtherPolygon/tree/master/code
   - UDR (TopologyRuleUserDefinedRule:
   https://github.com/jolicar/TopologyRuleUserDefinedRule/tree/master/code
   - Topology core Revisión 2067 :
   http://devel.gvsig.net/redmine/projects/gvsig-projects-pool/repository/revisions/2067
   - Topology core Revisión 2174 :
   http://devel.gvsig.net/redmine/projects/gvsig-projects-pool/repository/revisions/2174

*TEST PLAN*

   - TopologyRuleMustBeProperlyInsidePolygonsPoint:
   https://github.com/jolicar/TopologyRuleMustBeProperlyInsidePolygonsPoint/tree/master/testing/cases/TP00_TopologyRules/RU01_MustBeProperlyInsidePolygon
   - TopologyRuleContainsPointPolygon:
   https://github.com/jolicar/TopologyRuleContainsPointPolygon/tree/master/testing/cases/TP00_TopologyRules/RU00_ContainsPoint
   - TopologyRuleContainsOnePointPolygon:
   https://github.com/jolicar/TopologyRuleContainsOnePointPolygon/tree/master/testing/cases/TP00_TopologyRules/RU02_ContainsOnePoint
   - TopologyRuleMustCoverEachOtherPolygon:
   https://github.com/jolicar/TopologyRuleMustCoverEachOtherPolygon/tree/master/testing/cases/TP00_TopologyRules/RU04_MustCoverEachOther
   - UDR (TopologyRuleUserDefinedRule:
   https://github.com/jolicar/TopologyRuleUserDefinedRule/tree/master/testing/cases/TP00_TopologyRules/RU03_UserDefinedRule

7. Images

   - TopologyRuleMustBeProperlyInsidePolygonsPoint image:
   https://github.com/jolicar/TopologyRuleMustBeProperlyInsidePolygonsPoint/blob/master/img/TP00RU01_img1.png
   - TopologyRuleContainsPointPolygon image:
   https://github.com/jolicar/TopologyRuleContainsPointPolygon/blob/master/img/TP00RU00_img1.png
   - TopologyRuleContainsOnePointPolygon image:
   https://github.com/jolicar/TopologyRuleContainsOnePointPolygon/blob/master/img/TP00RU02_img1.png
   - TopologyRuleMustCoverEachOtherPolygon image:
   https://github.com/jolicar/TopologyRuleMustCoverEachOtherPolygon/blob/master/img/TP00RU04_img1.png

*NOTE: All red features are incorrect and all green features are correct.*

So it's all.

I would like to express again my gratitude to Google, OSGeo, gvSIG and all
the free software community.

Thanks.

José Olivas Carriquí.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/soc/attachments/20200827/b33fe0b0/attachment.html>