Ol\u00e1 pessoal!<\/p>\n
Aqui na SIGMA sempre estamos desenvolvendo ferramentas \u00fateis para n\u00f3s e que talvez tamb\u00e9m sejam \u00fateis para outras pessoas.<\/p>\n
Nossa ideia principal, \u00e9 contribuir um pouco com esse enorme ecossistema Python\/Django existente. Como j\u00e1 disseram, estamos sobre os ombros de gigantes.<\/p>\n
Bem, desenvolvemos o Django Topology<\/a> com o objetivo de simplificar a valida\u00e7\u00e3o de dados geom\u00e9tricos\/geogr\u00e1ficos que encontramos em nosso dia a dia.<\/p>\n \u00c9 muito comum, por exemplo, ter de validar a entrada de um pol\u00edgono e precisamos garantir que ele esteja dentro de outro pol\u00edgono. Ou garantir que este pol\u00edgono espec\u00edfico n\u00e3o esteja sobrepondo outro pol\u00edgono de uma mesma classe.<\/p>\n Para isso desenvolvemos o Django Topology<\/a>. Atrav\u00e9s dele voc\u00ea consegue configurar suas valida\u00e7\u00f5es dentro do banco de dados e execut\u00e1-las de forma simples.<\/p>\n O fluxo \u00e9 simples e o pacote j\u00e1 conta com tr\u00eas valida\u00e7\u00f5es:<\/p>\n O pacote \u00e9 facilmente extens\u00edvel e voc\u00ea desenvolver suas pr\u00f3prias valida\u00e7\u00f5es topol\u00f3gicas.<\/p>\n Um exemplo simples:<\/p>\n At\u00e9 aqui, definimos nossa regra topol\u00f3gica, de que A (qualquer inst\u00e2ncia do modelo Item) deve<\/strong> estar contida em B (Container).<\/p>\n Veja como realizar a valida\u00e7\u00e3o:<\/p>\n No exemplo acima, calculamos os erros diretamente pela regra topol\u00f3gica (TopologyRule) e n\u00e3o foi encontrado nenhum erro.<\/p>\n Os erros gerados pelo TopologyRule n\u00e3o s\u00e3o persistidos<\/strong> no banco de dados, ficando a cargo do desenvolvedor a determinar o melhor momento para tal. As vezes nem ser\u00e1 necess\u00e1rio, como por exemplo, em uma valida\u00e7\u00e3o de formul\u00e1rio Django.<\/p>\n Tamb\u00e9m desenvolvemos um an\u00e1logo ao TopologyChecker<\/strong> do QGIS e ele tem o mesmo nome. Sua fun\u00e7\u00e3o \u00e9 executar todas<\/strong> as valida\u00e7\u00f5es associadas a um determinado modelo, de uma vez, e persisti-las (ou n\u00e3o).<\/p>\n Veja como us\u00e1-lo:<\/p>\n O TopologyChecker<\/strong> retorna um dicion\u00e1rio, usando como chave o nome da valida\u00e7\u00e3o executada e uma lista associada, com N erros detectados. No caso acima, o topologychecker encontrou 4 erros:<\/p>\n Estamos usando o Django Topology<\/a> em produ\u00e7\u00e3o no Geoadmin<\/a> um produto que trabalha intensivamente com dados geogr\u00e1ficos.<\/p>\n Voc\u00ea pode extender o mesmo com suas pr\u00f3prias valida\u00e7\u00f5es. Basta criar um m\u00e9todo com a seguinte assinatura:<\/p>\n Com este m\u00e9todo pronto, voc\u00ea s\u00f3 precisa criar uma Rule, apontando o atributo method para o caminmho qualificado da sua fun\u00e7\u00e3o:<\/p>\n Quer ajudar? Estamos a\u00ed, confere o reposit\u00f3rio e bora l\u00e1.<\/p>\n","protected":false},"excerpt":{"rendered":" Ol\u00e1 pessoal! Aqui na SIGMA sempre estamos desenvolvendo ferramentas \u00fateis para n\u00f3s e que talvez tamb\u00e9m sejam \u00fateis para outras pessoas. Nossa ideia principal, \u00e9 contribuir um pouco com esse enorme ecossistema Python\/Django existente. Como j\u00e1 disseram, estamos sobre os ombros de gigantes. Bem, desenvolvemos o Django Topology com o objetivo de simplificar a valida\u00e7\u00e3o … <\/p>\n\n
rule = Rule(\n name='regra de valida\u00e7\u00e3o 1',\n description='A deve estar contido em B',\n message='deve estar contido',\n method='topology.rules.must_be_contained'\n )\n rule.save()\n topology_rule = TopologyRule(\n content_type_a=ContentType.objects.get(app_label='seuapp', model='item'),\n content_type_b=ContentType.objects.get(app_label='seuapp', model='container'),\n geom_field_b='geom',\n rule=rule\n )\n topology_rule.save()\n<\/code><\/pre>\n item_a = Item(geom=unit_polygon(Point(x=0.0, y=0.0, srid=4326)))\n item_a.save()\n container = Container(geom=unit_polygon(Point(x=0.0, y=0.0, srid=4326), size=3))\n container.save()\n\n errors = topology_rule.validate(item_a)\n len(errors)\n>>> 3\n<\/code><\/pre>\n # definindo as regras\n rule1 = Rule(\n name='A n\u00e3o deve sobrepor A',\n description='A n\u00e3o deve sobrepor A',\n message='sobrep\u00f5e',\n method='topology.rules.must_not_overlap'\n )\n rule1.save()\n rule2 = Rule(\n name='A n\u00e3o deve sobrepor B',\n description='A n\u00e3o deve sobrepor B',\n message='sobrep\u00f5e',\n method='topology.rules.must_not_overlap_with'\n )\n rule2.save()\n topology_rule1 = TopologyRule(\n content_type_a=ContentType.objects.get(app_label='seuapp', model='item'),\n rule=rule1\n )\n topology_rule1.save()\n topology_rule2 = TopologyRule(\n content_type_a=ContentType.objects.get(app_label='seuapp', model='item'),\n content_type_b=ContentType.objects.get(app_label='seuapp', model='container'),\n geom_field_b='geom',\n rule=rule2\n )\n topology_rule2.save()\n\n item1 = Item(geom=unit_polygon(Point(x=0.0, y=0.0, srid=4326)))\n item1.save()\n item2 = Item(geom=unit_polygon(Point(x=0.0, y=0.0, srid=4326)))\n item2.save()\n container = Container(geom=unit_polygon(Point(x=0.0, y=0.0, srid=4326), size=2))\n container.save()\n\n # at\u00e9 aqui, criamos nossas regras e os registros de item e container\n\n topo_checker = TopologyChecker()\n\n errors = topo_checker.validate_all(Item)\n<\/code><\/pre>\n\n
def minha_validacao(rule, feature, **kwargs):\n # sua validacao aqui\n # deve retornar uma lista de TopologyError (sem salvar no banco)\n if feature.geom.intersects(outra_geometria):\n return [TopologyError()]\n\n return []\n<\/code><\/pre>\nrule = Rule(\n name='name'\n method='foo.bar.minha_validacao\n)\n<\/code><\/pre>\n