octclip-1.0.8/000755 001750 001750 00000000000 12540021550 013153 5ustar00topotopo000000 000000 octclip-1.0.8/doc/000755 001750 001750 00000000000 12540021606 013722 5ustar00topotopo000000 000000 octclip-1.0.8/doc/octclip.pdf000644 001750 001750 00000622630 12540017162 016065 0ustar00topotopo000000 000000 %PDF-1.5 % 53 0 obj << /Length 2315 /Filter /FlateDecode >> stream xڕXKs8WHX0 0$LvsJr)Xf"Z=o߯ѠDr-WY u7h%ћ\]i$sdjHfV`eF(ECjSvu^,ubܯۦoj(n*E*L(For1I4lJE"LbNS c iHYj|t,}SvB&h+iLp4E'ҫAZGqOf2[-=UewҤ>3D<-u}6<)E"2HDBCƍΙ9xgxTdrj`U9g8#g/3uo-ۅTˣZ3Q-F C_Ks ӜWŵ2F*xa!Ro'qb%\2rX_oaY"Kp}5KQJ,t:@fйFÿz}Ig:IG]Y/!vb4:ߎ}A%QB7M`CK;*i!▖\w[;^ 嫲+{H0hx<_h AL~Iԭ#(g.H + [rRiI8*U8μg冲ތ+W] 0Սlm4ta('{Y|ihr`+ -{#avg\WIB:8! 6F&Eto:TUu|LCao4V41iTDmޏ9tokxet!d ԁK0x*yɝ|jǩƇ'#GT䔄Gi$]=֙ Fk^)lV[odU`%n?'<jdOSDQp4Hfy#b<*%glF~qj4fv>' _ 16i~?K3gc1`G=}8fFOֻ}`6K | x̑FyYyIvNxd$YfU2Fd ],#Y=WAQu?|0՛1A"I ?G׸ `sB)2E.Hz`<B6Up&׮!l<o*sFΤ TyOKIч+IPAKP^mC-tԝBQYO)$6$m $3zZ%2^s,! (_N@}}zuxxɣ m i?P5՛ mHr n4\dˑa^yw3eib+?_;ҿhX4d2υ2g>% ]by- "! m?Dݱ1s2O͋7H ǧ$ jܲʋQ4}Xw~`uWl\;Zԗ@OiƵ6^X =X5Htfn}'D~doT J$y񠃹kxbmذQ1UR'"PLʹ=|2.KIT뮼^HiË4p.l߸d>G<4?:A-Q+!s|v^P4Q V-W] Ly;~;n+\BSyFeOpO#m#a`P**+ygw&VJN>SflH ,P]=컮FϤʞqy3oяHK|jy3=NOy8ݴ?NӬDͿAd=8QW' endstream endobj 82 0 obj << /Length 2072 /Filter /FlateDecode >> stream xڭXM۸ϯ-TʂI>)I$;{H9[)ZhX I;>&ERwju7drHdFw7(+trw(mE.ue&.}!5RڥfkK ƨ3ݟPMoI!LgT&[Dy´̥7[e6m2.qҮ=te]eiS}QNP›IM ٨}.4lXn܉.8h%[#s!ND )4ΘgV5^dƟ/TEԺZR2p^\-:o2Nۋ<'Fv*^mDs|.̸C 'v8 Ǫ=/@=]cw9p*'%[(i(#"2&O`kKjT+ldMK.uhq+#{WNJǧm{t=Zc=TK xsor84D vrl0^ ʭV3C#CoaBEao'pE~ZГ. }ods j +aƠaFn'~]pK@= t)=!YS+gBTE>E2uhGS6rJdb +w~`#\ wf䪨5t žH 2®8IQa$ leͭ{„BP_oQ剴9;.RHlp_H3y lT,'h*#P5M8 tήҞa ԳgH}u5u>(ɸi40ˑ[9c|b`_00g$e葁 y6rq&$h5mL$`Nw0g!I]'{Q`+N,5T\[(PVI)2 @rj+@ *TqU;1A ; Pt(%jhN'e 1mv:'V\ jX{a2m4K;4|{O%NC|\P\x(?7OPNBQL`we"uXV,hH1\Vg`u "(bsqZ=y> xQՑ;е?=$Jc &pKsU9*+l@ W &Y~׌ S\tm}fظ}&~ !@L fn`\thw6x.I|Wu[7gCEF"\7> stream xڕVKs6WԁfB/dsJǩӤTmN0 Sl(RÇOfڿŃ(y\b `wo$*#]0>_-_rQ,ZF )"1eY*k$1,Ao􋏫4p&6$)^Vw"fRۮX3 J$'{$s`meܶ]ipc+j|aS3&c3IԴXJnǭnŜ0U8KoS,b!St`)2]_>3__=)::ly7R(X]S0}P)M0KCTof?CDoR,wumv9 9CXf؊N`tͭL{`g)~<2:z<Jy0tծ!\d/4rhdon6B`/]U94Q+ah1'q,Iztɉs3?D1WK )@*u\;S۹DU3 W>Tw+պ)G]p4t)rgP{8(v0pz vD%Y"n\&3.`3*4eR(۪) ueգ-x>Y JAqXF9ҩ o`pZ-R:kvX\WuO@9LĶ-갘eisvV+%F Hau'u| jX{/3f[Iz]Cz }Wx&?}Gg3h51qq eO _딶+>\*P.^Wǘ)Na{~-$h^ݏMpBķOȎNxsoAԎM_'ېVYs.> o-.8UNsDTb.*ɷZ(ojm ^+)M:?⥉d M@u.~Vǚ /&m*ӭV[;N~ƝTq6-J' 4v+B/06Ծ ӊl?U endstream endobj 117 0 obj << /Length1 1917 /Length2 12548 /Length3 0 /Length 13739 /Filter /FlateDecode >> stream xڍT-\Hq"kqkA[)ݭCn==d.ks턊LIQ$i qbdebɋjXXؙXXN֠4@`[߿"@@8%PqXXXXl,, u]y&-H%fk6pzZ+//7ß,@6/MU[0JX89132ml̅h`' 212@h{4&D*/+x1XM@Ǘg)*-PA +XX)w?&&6v@;b0[rLNnN @K>IQ_&{>G##(rS1[~`˹3p  301L!`{g1/&6sL,hneoO;[; o898=o 08A`/f_;,/cLm!|̚*jST `dd9Y]G \i-//.kw-4b,?STG~?~ :;l.@7TZO "s( v*L,_v? ):Z,,{.E@/-% &l'tGdy''eMAnuzI 0u@rq0x nVo`#oREqA/݁K?`6|a|)k|Q7巟ÿ^B9@Zv/_eF6! 8//rzA/`iY_< ý8_ N/͝,@:vNJx9x\_l/5/8;8\^/@&s&AAw"o]wv4Sh=:'Ve;܈$~A_ْ^"}Ekc=evĦwM&)S]/3"/ {JCnK:cT݋uo`:(mU+8; :[L -(Dy75vw n3yӍ.l}(p Q惞o#E>iĭ7?&-S@G k!Svy&jC#A ,ǤWtAC Q/'<2h&?@TC+j}uq+ +lx咷.J ȭs]O ׀MzCgIսQMIC\*2uFsI6ɮ $1GlN'ޟ#?p6je<`+p$.7a~oHGpm8{"u`NC@ӍBw?LYNn*h)g.IAmhӡR./.FE/lyy7XdfBJU%7B )X); < huzc{+ d!>ePBU>k>y񒤲 gBlcjK 锝TҁGaWL+j}鞷EBP=.D.hϔsN wM, YK,ZD& ]oaF_+52qњyf-6Q Mb\C}~1~6TQ>fs2~ĎT13x^v O@grܡTeC& +2~Rh(w{e(S2"pov]n-&f2ui9 Ü|I*:bk)J"X\-|?ܳ%t l V2U}-h_C } z32{QpƐp @`֑Nz}r6A} q@Q~k 7ǢpbvCL=,>&h;sh*I,@y,cQQ_i'9gi$۽UwE@E\W-&""DYDoR 쾵iISxm* _PFLj؎1Ty?,)Gf:]I=zPsuFʑ*i {f鄘Lz?R-Ț)VonhfAYQ*e-QjVָBx'?w=8 v;c[כ^os47{9&ީ>F WǡkEVș]I0G{5}l8J)zׁ[I9Ձ#!$W󒮾 N znQBJqA1jFMp0J#Wn٥ ԠӖrb!BбSsٌͯV$:]eR߶ ߡtVA_>pI%duLI4R(k7v_6yCx Z6mLX}Z񴍸?}„UIz5-u $eVR="I1`eߚ?[ji9<;.HTe= ;3çO'R FfxώٽƝtEHv!E148\i̜.UBtWgd}kAv}s!-o@-:"w%S6gh㖊4 HA |>*Q0)(]վA2m[Ӫ"<otݛrx2M{2|N8֧9]B۹濟ZY ْʚ \חc]#pbTFYە F{Ja4QI k}~C\8)oUJw[F+gStdwW)Akvl$- _Dƅߧ)Bs$c>m&Kek6Ni3J [G8 Fʭ>x "6Zg4-&ϾǩzugO/1Щ Us>9𫅪B `-]r{ՀQ^9-EaI8dյBL)(<,-[ZrmJcI_e{z.GH]~'Tn3\>bH38+?XY՞P"4jJf(2–GOuĞԱ8.Y"KSf ӹ~(K"gAA9q'iѷ ט~WyNk ZF/[׬ZM{0$7Auí)|.|[#u-8\+]P}F0sh2m+m^RX}5Ή6"iv,v]f:ԍ00㳰POV5wegt%?Mo@͐zeȼi0:x:>v0bW=X&i1$bq;%ޛ:t9O{W*S| 2rD~HGDB;63!#S66NF ׇFȇw]oKϦ39B l'mG[A Bm U4+ 늹=?:n7d.z,s79;;Ww[r$//vvߝz^*D|̵oFo.teaXHI# HWFvW)Vk(Y7<~28{"L7VݞJ_P2nQ| ܺH ]Q@s6T1p?uΛQC )OoY͙Cl !̐ifZqV^H7,=h6G-n6Rl&IC~p8^{/ ~PzNDj*T<=GrYڞHw=K&JHP訬r]2pfP uq(!AU({0X MКg&hN]Q c,0"yϯTe-Pʀs[E h}Hco/\m-Y}€EuNVydgʰ(E֙4)+[qeɘXi ήgg.b'!i;ZH^(]w9gklmC|^\k9 f}^I\͜TW3|Ms+ >,ܔ@$M}Ϩ@[,Gp7SBj[D㫓~)Jg=ٛ9M:ue+mꀔ귇eړDž YT.յYq-(v]ܘc1X¿B:~ʞ: U̍nEEILNcZ$_d41 dY[+`q=m?J Ϥ>ZT]S3p_ L'Qŗk%@ {F$Z\$U3^e&[r+Ğx44.[!16m9}9tLZ _z))/ezG/Wǂvnz%}Hw=ԣ34P-demtqBB/^CR\eZR_O'gp9!(c"I2o3@ŊB N]=}dI26Yb[ E=R~ހvaNzU_ 9BlX3ULu+];s_lzƽmWhhAo8dϲW$fC* J=L~wDILy F+gl&ok71.73hx7,ͧFUċo"6?;TU- sq(v6r_LdqSgۅJ[ >{J5Iz^L;^RDhʃA'jYGZ% R+*I>,D9 c]Jo0Y?4Eoig|FZy%&A!yl5=ATgGΆ!vuq8|Y֏jc7dt~UzG!zc(: a,n1Hw:-cNK{o9J]9Z`êxvUa4?o9s2^`87߃قWvԵs#x_sT |o 'ᔬO4X5;Rq&q߃kzyH)vկbEz&e1-xVzL@,4v9e!*fCz$"vg$}}1ߩouv,IXz-%Z_1%\BjL*%^ꃯ˯1Y )2vLcY-BefY?eKBĦƨus[c5.ykG-%(S퇹0lU` _;s.T@:6\yL{@榩U-R/NjܬZUHࢡY)js|Z2t?Z#;DuqWnKX.+1ْ> goqmeBPi 1@T:J^gDjFXGOWqiz|ը$hOISsFi23V7a%e42w.ab N+ָeT4`rڶ1i,h!k}oB!U/N)PTw]D7dsK NoEs5Wί7 ntv5]2:*35/YOLVApc'at9e+G{.8bxů2>ЎCm4UYω<*9󦹩\"W׃ޢ*ܱ8x/ b *K}NYoC2'^k诤2W}_/  bc91-&uM%"1A`S'ʩߤIv#F9\nczj pefe2~>}G<{xI&0k(V^:2X(Vx?|Y&M,}r8ɞ !|scNM>e[Vx[%p+3U?iզG кLPB;t r{%ޢ hhaB܅3nJV-6]Q˔\:N.mFN֨m7w2O d N20]hS]\4(y:8 p$)_@^1>L[WmM{cOzZ Z(&& n Bo[w9..=֗/~K;< QǪ|$f҉.q,n%lѹ i049^az+W{hpV]p/?Ƹ-cB+f. GƆ?/5?l'٥Jĵw*s ɋ>:Iqv#̤>Eu Y`4ْ<@S03?s25  ۜ_b?P"‘$ ;4FwĞ#ۂuW$C;m^zv8Gvs3qXQpW|spZę}uLb'C#uW[N˝A7Rd ǫ^Xd2]Lb+Hުo]a-nIP70w<6 W Dݳ!&eCڼ.6mGH[ثx-l.!| e}q5H-V1>lhH.'s]8lX U)Z5;ۏ$]ZR/k֟B3"]O;l;hv+4O.8sӖ[4G3C"vY{; @wja>5s0M~!p]Wasr*5*abAZ̡i?|)m='zJ_ga2WSJ*V[5 bI?% o~JP~m_"l gp f{]ѴF-wvC#dߌÔ^2BGI+ qۧ(2zD.*'bV?KטSgőbOb欬?ےߺ8E,Yhi^(|Lyi?`-լHΖނSGӢ{_>JSBXB\o7.45) %Ƀ3 :5U[ ]ԞvBԫ7t=6n 0Y^c]MzxSlm<_WN‡H1_d$_ Ԯ3i!DI kPȁC.;/Xbpx@~*824юх׊R5;ښzsqdm[DUc",pSz)e3 >\M)&oڷl&oFmSq [6uHUE꿈 pӆW5QE"*E?J-Hr҆2OVc~c^lH),ctyw1=3 Jm +?!vLtc!cmo#Nq|}ܙ!^lWY)#dd/|HŘ=֢ALP3ofc;5nڪuXJ:>WZ<:眊XSÍhԕT^e6e9~tl֢mjw\1IϺ&F!y exi LulYS\ AJaڎ`]~coN{qFa&c!e*3V*h9:-gBnrN:TjVk>@PxV|J^ZGp 4z UZ󡂟#z`عmHѩ[T>Uz۵TMFi %b. 39Q?#:]@EMmLg~lwE]QxT,Ukv"iUwJ<ߓŘ.?姃馷z&OHL.˫8zLqH"VMz:Yٙ:O Ms?cJ "//_^HdjHNyRbbu$Wh䌊6$yѽխoŀ۸Fp;Φm'aie6ߘ!<;qC`t3/kJAdEz6{ &m5/h =#4И-1L9Mհ4H:mteJ%3Oʊ'Zd_ec ]6F3'xA|f[BB/xx ز{;|Ԃ4w ̘i:5ǝ⏎_ϋntd3RwڵfK(aeu᜹{ZU'DkQ*/HܭzsDn0n=3*=D } N H=36!Q E"ر4C^4C<\ 5K=vlH3Mb7u}(?bzg0o߶ȳjAgj[{8ԜVȦ( CYBpu"rGԵ;>x7|l9K);W䕽foh >ո2znQ9i 2t?zC6U7NXp-l]2h'Sl%ArekHѿnEPmTᑺ@ٰxbЙ꫏eRk]bfßw)1t9d=V0kvm|l2x]TBByx \9uw#( ABȳB\fϖѩR}o90*K¬2g (1 JMҵF۪GMCwmFk@ȅx#ٖNB=!n?E~:f/+|-%;i}\U9OoS 3`-oH]6a%p,G]k\@>S-G䋽qȄC% iD&7?R 0|Ar͖KMM /0pgR1{|}UsFMv㉛6Dgx6%l P ;B?lV!}^MW **ʥmڴиOHW8^P]e g? 7WtB]:"wL7'D7ksO9ŏblqjFrݥ`E0!0Ǜ- 5R@He:fї}=ondf<IqB#z[zXv`,֗)r h&![G)pbD~k6d Ubq Mb _PMi܈/n2R"ۭC^LA:hH 9 7YWIT~hܪ{+5mN@-w-=l:֗v`>hDo,dà&y7(bM5905U*VKgUkC!)Lj' 7stԺpTuu]>^aa`eРE c;]ۼ$]4pہz7 [F RAW%K7x9N07cO9 e{Z!&v'.{q)z34 lEH4C tIZn4*nw-23A "q-&$AvŶt1¬uS,SA><51؆ݺlg^kOey{Np2 w2(G6 3ˀ#T;;^&j#]̱ ]оίxUXNzaT@*չ::Gˑ.?ٜJL[mhna=qI=ř)֪vHcm} zOQS~?҄5GNP#FF-.{0iE!JZ)M*^O)]g-z-K r'GG,7A; .ylrj`oQjkJ!~r.4r28k>adVLU?é-ȇʪᢰCڙ>_y:iD!9], ؝<%s el,\ql+|n4ec:kI9bbA讛r1L~dQ@N=,fL4{YpyÌtAy'=fpacʦg {]"9tl,b i endstream endobj 119 0 obj << /Length1 1448 /Length2 6897 /Length3 0 /Length 7874 /Filter /FlateDecode >> stream xڍw4]6тDFeFE] 3 w;E'z zD I>}^ksvgƬ#AZAW>^8@ASH  @ll0W8/1(D vEh;M$ DA ?$/C$JvA5$BtBl\k pv9BQ0k0 v:wzHk!8$\]ā@^ /e+ t.P;U0@ S/@Gq"\n@oS|` Bs{e{m|J54To<#$ Ą"?haWaݦe8N?ci!Ѭ8&Hd?Sῢo$jG v2@=H ghpT]1CD2 цZPm ץK,k&o=7R a0~!a{>|I@=SE ].tq~$y rDV#1߈ODDq( Bo6K}7@PkDgrt<_F&پr̡.^rVe<[BȽ|Mq,vs^xKN_Z fǨ?l1nt}Ռ١Ɩ&JG~ѫYW:?6EgJXt' ,x-*s>+dS'dn^p ,??^,we5a:&gFѧ(N-,ȆbQ,X1'Y{oOJuV}eӐԊO{OӾ;xOH"PռƁD{V L_nM, Z0U}>Gډ*J{WEP"rt8Ho5:!ֹ{DC%ڗ3Fzu9$3 goM:iEMΚvkM8@uРV45rS@k|U/S*:;# zr=/Ea,a&QP[ Q-z{'?_짷OvRe20){`ȶVRqU,G&?|ׅ2;΅(UG$'Ho ۷4Iy_SJi}WRE"}&:g{ѠQ(m߁Ҿl-~ҙ [#CqEǹ5,ɉ&簃#qA"iۤP5H"Ԓq*H{ lJ|,@H;QrѨ:pe=` ʐO鑔Ҹr[]`#F-vR-uNj%cOlZFYIore utl7aE݅܊4(rT'*OyF\MǍh{bUt*'SP$Ҫ âF sC-KEDQld>ߚq Ȕd=QӥoqQL^ E8uEpoઽYZD [F5:%3N LwB>lN/^5Y@>?(-+u ˜!ieaQ>(nadb&n~X\!Y66O,%Wχ^drz <_86X?ר뙨aB"?]-;}LD;Z41s93EZ2&(|M=MwkpBBum .ّc)F=U|!xsy2;oBr/Ec2R(]x0 ET#h"J, Fլ=wM`\'DsAƮ8 ^:r!J,<`b_ta Ӧ!S'Bn% ^3Z: 1kyrvIOVKtᶘC'ƷbӨ)5moalW'͎g[%I^ߍ"XYS];*lӁlMc{ yZte>>KRzJ%6Ke!1׋5C@noG%d cM)ڪzOxGmG^KS9E׸ne1#(>)M1aFclkqtGj>S?ۜc9}dJw8Čթslc8m2G,=ih<,k‰PMB5QFC=y qn=X lM&=am;pbō'Rzǥc8`p+e"a/SV}7Y'AlOgQf3}WN,gӥډOwlݡ{^w΄3w 5,#ɡ|docjT@ jwֶٌ_-{ЈQ {E͇@/,?^lUme7-ݳ.i<.R_R)*y3sK#&<4Cԩh=(ҌQ~w|n)6+ZeqgGvKN֫oK_}V=US;3ͯO9V x.Q< L\?!BuwJu9x"/8ڷҥG6 awpاzuq75x#>ty܍Է鬀1ZT.s{ƏuDd"9>8$NŨb4.f[c$f^|>ը>om햴C #.FJLod)p53áB xM9EqD'WO+*HɅ&U5aoW7UvX}I@YߊOVdG=U͵T1џ>58'՗mA_1j'+*%HTnGWcQitdx3g<|[za4Ve. &-ci%z[K0dqu7P(?_QQىq;-c!6ƥk%vt|PK-3~*oLHYvȏ.:e _^{NM' tDj|X.o庥p>6TMJ>=`h3]Bd 3l. _32<8,Nܽ"w1O%?],Ȼ%w8oIXaBzI$pdjMwOɛJ %}{Yz4(M0(&=Ϫ>:GXu'dzYeD]I~5qxFP,LS;k)<,E M4~QbC5YHHM+4Ť@{ޗy(E͍> ǯ SviQneU!EzCBS7. 8q$.H'l#[UV.(;tDpn,U*휟GI$JZ#>0kSCD9-{FG-g3o&z:GG dֺP?91p!eK|73x8TwٻSghtmF ri uVK'psw`p475U^/KuG1{D*cw-Bɤȳ_J#e}ɽ+9v6b3' &'OHEשUS=Qm~0 .qܺlk7"Q +$<0{22CM|fzԪ,KdT.BZa61ŶkŋȻvϘԩ*B*}sFWlJbZ01)'stil bxLQe 2⬰8LTEZ4If]Lx= '^1D,/>q*׈=ۇ> L1((|^<8uyZŴp+~Żi|':t"sl\>ZCX994 K9#H{q|[L9(*qgR8ÃNB<c=7]*Cv2+j2c=qs,uGv7ojpY8My/TXŀcq̈́OLGZyyl [Lr9 dJ{8%df4mqB>fUAbX]:_+OS6\8|o"+I]z57n-ca^[fcG(-pJ醥WGWECrҥ \ eGrHrp.^.4I 75/`9]0) .D,kU~9Ei19 nz}:/#~6nLnu`szMT~N(|ǮԘlOai_CYZApMƑ84@4D&z|,x40X3"ɾШ~^Py3] PhBuz}3!ٮ (}DBOG%5t-,^ Pft,C!11]+'2Wl4y!yƓl4p~-e){F+}=ۼՂo/:=:x1=5cV^s(T\Q3GKԳD;_(vH&s(QӓUQē(N>MS e08+g~Yb1.wDZa/PIFԁٶx)dM/o䲕P␁ ;;N:JP?c@3J$ eM5U/ʤI[% kL0ev8fƏ='ER2-j~V &qa.E`J+ɉmgisd\eA!o8Z,|f4rIgMEMx;l3 8QpMNNC* ۉ/\ HZ2ʜY!fM?4hK`ZqG]ʻ#K^F=['L#] W+7(}1s9E͓Wdw@.ysazNԤ:wI57\]vS19` Cr6K\~;O\Q!*|᷼U=;W3@Vm<`ȅL0$@a@V^t4u*/b<}y PĨy$=)wkz;cU""IX\3Zizi.~xNY6-,avFnGMdIqShÂ:٨Ht`خ?K{8fOc@@v&"Ɠ]tDӔR Rm\!_MOӍf쥍v^yF?,duФ+xnO56>(0=#k҅cb=J*[8% endstream endobj 121 0 obj << /Length1 1614 /Length2 9221 /Length3 0 /Length 10275 /Filter /FlateDecode >> stream xڍTk6 ( Ҡt (5  3H# RJtwt+ "~xy9k}ߚ{~F]y[ DGI ||||x,,P$ E%EQtw6%򎩅4a~A@O?D@ x8 E w@G;/..G8@ -|w" PRK9 .@/ٍj/ "7+ b 4@ Oox,C۟ `P0vkt\ ?ɚMw'g Aa&/ mA07]<@6w?jTj uAAaNs7ge"GO  u#<>C;(w#.@#8;D]/ҝ = @ `# \ 8qAA w_x>n tu` #6{(wfݟNPO3;~~-- Lhr翽 OG@'* {< _u+Tn޻Af_2`kI8Lq^ ?K?A`!0(wuGޭn!K5Z[zՑ%M Յ"jO}A]+?%;ݽF vq?n7 #l/ »;$|'-x!m@ޅ!\~߲'F?HT OF $ ww8 ޥB w rw#CwxBxsdcUH{ya)̃sSKdjAVN~KmK3G> 5^B< *; 6qӿN'}hrMR% ]t颈[qem X|٪:f=XɋTD5B?/Ԥ7[G~5>~Ȗ<"U5x += $tmQaHe^Z%!Jㅼ9פ>6dr]%dvqy,Gr~1d9~jQIkdV o?Zt ں vp6%T9R64,ԐFU{VҠ8dyz,ΐBl%:>JrOupZp?x0J5>}~ͳ!~,ɯ/ FQaTNL;.o3QqnܙA^{7,ȟ?hD&4#rFqMPB4ipD5/5j5QsIY%|Y򱐌_p(yQPq1g4Zre&,К?Hk/Nժ_uYJQ^iȯ~?3 *LޞVޮ൝$sɻNrSl'ʢX6B+"*C3^W5ZN$N%VJ|e3Xi5pE{vRM3"^+g3HM^ӣSM+#9AV<8;}ugJ]‹9EP_LPG'ڟ6Q9o]?/*.= 'ֱ;cqrSI3Ԡ#娇*;AQS̩/?L|?;p~5R1k[W0Rб8ث=s[a+5hq cb`!T=ԶqQn8z_Glx%29/Pg|$[@P[g /n RwBv[ aTcu)wdӞԶG <t$YLX+K1c_Σb1WݝMt4m؜ 8kHN=!h8 U^v(#wsLWY^!\۷) G@, NhՂ IY-t*-]Z J6ES;`})Ś)TFFRW۟Qվfl-q+ nF joq2hVE:+SUtA~>$G1?\ߎg5u>/z،QSTpOIjIfbD s DcW 4v0=ܲEdpr&L >gfZEk)1G@ {@/k6˯x~ӳĭG̋ g&f;Xn /glC\:&sKkޢ 4hm<#y~EGۭ_gӭ(mB {mpȧ oFõewޟyX V 8,erKJkeǝ ;/%I"jܓMOUJߢ͚j -p_b8AgY"(xb~6K"K3"qO1Dî )ڼ.Z;R0d`h(psE^ӎAٮM Yp ZKȲӅhM׾1i [x}D kRb^4t!"U% d'LtnC1_>uh+PAlNo-˛Z(}t|5sS泶'F7\$icx/F&f0 1ROcB.-,_2r̥=}_&PH W٧rYa7T#p7Z9d_Sa/M n&ԪdRԇLPyk`V!t{ ':2f..&oFkaobۡ>pCӼ8O9zz|V'^F`=.w>,VަZC~2qXxws*H+JYMV9Ӧ¤yھ}I"zbYx7B.\nSjpAe8|9O0{]+Aߣ9gLz'V&/jy\j Fp/z?0KZIU 5:<k& ;ۈ/`TT_*CUo dDaa˯7ɮf {[oPu91SS2:5/#|p3Ưc6t3ayUV\Jl1WO/ZDKw-##ˋy[KDW|=N\ԧ2}m0s؊ءox߈)6VLy&WL ͚ۤ3vsu-X2+tx2P#H/lPh)ʥj UY\6]jͫreW %CW8U 7, Jn|Zj%}7\hO>QJ [0Vڵ\˰3CrHK6$^:) H#˼58VDh&z:ػY62n^=J/nuMd§,$^1oD?᫠upvc M e^͒B~^*hzi@t)W'g wdf[DMʢ0CNJ(DwBԕ. b]Hy}+‚b<3A#%r5b }{-RX 35|!j%+yvkm7nvDd6NG~jж]}Tnʻh΃|F8+VkY dXϰeL:*].őOУ*a8`aro70osm}jV0֕q^7}ΚJ_vқws]P~c34>%GenL:0 ~U"j]${ zSBg@6xg}WӬ}GtDNulR?^\%ۻㄼ9%lJN%f2yWx>yhi 1:eDD]bKJG|^'Ũ5ڼ hbm"+ ɻH¦Giɇ:G2XN [ *GisgcMSh#f1柮j\営NqcOAGtؔLKfv<0f I``n }m$]QM֣vn~:3l&-;SرaOqf,霰i8[tt'WHJC(|ӮȌܼ`-]XVu۔PPĀ!4'ܚzcd!gʌ$ayX\|fo)ֽq~ldiO>{gTihV3Ou3Q Նfcq({{E23jvIR'?M̌MrLto~-i"TZ֤zH&0Y9wWXm:u;0I\iPxmiPUZYx"\GR˜iv>$_{JB?i5,>b[=?U:yW~+s2Vq<]dHx&Sݥg~,ADcPy"b[xѨ?ݻ3a^ #(Wκ&<<>YC9Bλ=m|rV cq#N|Ӓv출oq3\P DppJǫ#[Bw5o-Iy^1+hByp R/LH^.,6[cEz~t,|W^?M-6d8,JZ _E8\S؝3K\ z#Zc~ɋw4#kXı(dҾ/ZJV F;#i>.azi[xN741ƫ+iOŭmGe7yM\_:9`(Nl"q47u4޿\Q'Kfw'Jc0)G]L>HMZH}x {,F|Sv#q:mP圈(y l$J<~vhuyrnU7?gRzKG/y`,I g R@%*3qtIPDA?;HxvXo=%ܼjTW'C uҖ% 9:\%깳 e5+RDO-!R[cD$dS>V|4if/> PSOv!h !^(ťQ5=̈?sV\B7 L~s!6&1ˆ@# \ %d}T<" ,R 4B$3sS Kv߼S뾡+ֳճX"Ml\mLW (--iF7%Kq:~BSW%Bp.X'5;Yzu#>hG]22o *dH(DN2̝j:{dφn5Q3ms/\qxvpO`[ E|>!g2c,v^/ohUfk,byhv4-rCȃ*rʘ됪DQcc5)A ؝ڝP$e"}v49`QjcUǩ nF趽7M( LI7, noބ:V5/"\LRl/ | ne=Zl<_>Vؖ2tf- *;chΤ#Иebdo_;·M^wfT֓r^j+qqXJ ]_u:c[:J~Xm&8껇 @%c15EۊHa]w8 A)8si܅ i:&onnr*=0yZ4 5/؟#V GYm4*PH,fe=0u5W@2&:Z(/Xf$*:5"FW{OIW3_Q 9D@),˨eM>2i;WdӖ;5(NiOs!:L9@O8]~g8Vu$ڸ֤ ѳJrPp?$#1 RocRŠ%%07ƨN Im*Mfj.*v:mPtW_;M՜ A7v2G{vΦI+xMkRMĚ7qLkv  =D. 랔|&o?61*Q/i&cL4tjz~N" L; @!;7qV8yTs!`.Vd_"Rkñr> @V\ 7˓{f#;ѫ-*I&y7yidgx)`oܵ. M*aOL*3BĜ] WTn߷kM|Q2)_HuB6r;[^en)*Wo-:n2YqeУ5DPa [CK!,8J(/:G+IⲐQ/J!ŊL׉{Â1C*9Qy"8 *ID8#fiGMZ_vQ O[7Sx*|qɗ f+n+D)IF+RڎʳpⓩA yڰ:J_|/r)/Qp:, 0ys+Qݽ2<TSZ.}"B>:&RX1[ &K9nHShz36%ΫKgDxV9] hF!nI,yxG#{A{Q+N,Ňg7+E T[IQ N4C_>T& KنĖ*$Cy)X,4ǩF/Vzo~ˠ|Ԣ$aB,FĠAcM5hx !z?1q}ໝ,&ooNK*9>f+\S~1 x,l_:lo_Vb,Ih?tP+XQ䒪W&鳯LJz.&67\-`Zkmji+@&b˼U1"èv_rBo Rb"~nPpgѣ(K)ӖwE MMvf͇%훰 j\+m*9R Mƀ >G> C N_OtYߣ89Ri&^*#޹Nf+-r/l_3%E$Bꥶ۹E = L 1oe>(,E7uEhlAxii/.c:x6iĬ[ۻнt#ŗ[ښiC_}|=R8Z*]_s>sW.۬ĵ]o`YI>1tD:0bHAuXq,YEܳoMR\ ijF?T?BcL%6DPk gc(RkRμH{u5E?Ni g*KJrgj6GPr?Ջdp -@]z|Gzb|]qHrۇIbm8E"ެYGFKu J퉀uo;xYd޽SJUOLT7xq\P=YNhn6RݝpՕfeJ^FV<1x6)dqôȕLr"O,3~Ր;|R|6[;2CѵVRws4s_Ks Y.:KlPDu, Zs~a`mg=J KTi (p=}mR2MWK"aOqMr@C{+-sy 8q4qJ L @'CItiqDHf5E:@in񀴘$Sapz +˳QV۰#F-;-9usNQ.* fS^)PdָV%Ĵ|AO`{cp.cVv|- endstream endobj 123 0 obj << /Length1 2501 /Length2 21417 /Length3 0 /Length 22861 /Filter /FlateDecode >> stream xڌPغ-kkpwƂ ݂. :3NrWWTAe %U3{  #3/@L^̊@AfbBleo$7vd\m,lN^.^ff+33;čݬ{;3 (|PXxxvL.@[PFScBP[8213:3;Yܭ\,*@g a-(jVU]܍h p3:@rE?r3 #˿+ƦvVvs+ @QBÅ`lgoflecl2rc2s6urpqft"ӯ0)3ڹ8#O h '?hgn`negf 3W&u;+GWL@"2 t=L-~Wtd%u`052 x;.N@_?XXfV. 1 Z@=?efog2IjJh:QQ{7;3d\F?e+mgnZИb?߱A\1WwA66ƶV61tAj9@3+Wv1; h,a4Sr1-2+;կkZҁG * wvf+'dx΢o]@.P{s{'_0Lb7I70}q~#6o`@d#P>O7Sq3~#PA7eP8L(oʠ/ElZm@DuYkF8~^sr_(鿈.%~gaift:FBZW^VPE ;[ڙo ad¿!/G_z{W?ƒL,vd` $#!3 ? @l hh#s\@=YŀPb;װ~lY#拾AqqA6P kk ̔4N 'gs r8a@N\,,Ԟ Arp) ?{t']dNѹԀ?/@aaޔ/ĺ&;ΨŎf S#25[/>P/x5†7'(<<ƩL ̏c|!'`PyqS"ѕY)޽[{Opn,s$C'&380. ph(7Shco2qtl:묟fVXqqup!oІ'(Ed缋 {= 蓗3WYD5tU /`EN.i0t"UĬj1Bwf$a.zanL3 0myT20p|?0UGno:a2tD&P=ghP~ G<ffn.aSϾu ?֧Ql߂9L~&Z}0MWj 2_ n:|QēX.~c]Zkgr R/'TB%#_d8ad._48lL^=BtWH_?T۝S%E fMNDHlbP4FڋK) {d} pcuZӦxO .g%H2öWO6q$s[iWkԟ"_#WEj ӧ{kPdmlRUB:ل,MLGFJgU2vmp5qCg/ٓv}eiVUY$sr`պYi[4$CLQg0kb.TЕ>䒄0VR ˠT1B/t׈ɌɸQvysrV#jwJ'\E1 "KYJp$Ƹ_FT+&#"Ng0؞6Iٔ>vV5Dc4E |4hbUpsWa5bHDA)e2AMxCjiDb]]+T!)ݸ< ^-\.bC>xfc ͱ9֔&pG0 e`ꔱіnEU8yV(akh綎DL!#U*2*f[ѷrswZd J?Jܫ<lCmcQّh2YBҸ_:43`̮̂mPƳQul$sW\lE^,\gR'¼`7Q\:.w\4MI# hنMIuwD"l'NY]\NHj'([r< SPgq4Y$% 7L-BR8 ,=׎Eh6DjŃAyϵ|KDID9w7HtaYFSOL9yJYdZD_ꜙ O#-K<0]u+7G${yUy91(#m=+ip#;o5UD UDm~y|7̙Z{q ߿ɺ tg!w(HR t{VYFjʰtAE+ 6fS{cN8[." rHvIQBІXKu~YX1|FDOeEW9Uq6?h3 /`Uq4n@T[ bx}@,97ڌ/Uy{,XG|m@91n^2c\davԸ*];AKpBuL&I~q0 T9Q3p@yAC \Cӵ4j)T4U{C0A2d\nZ{x*WbߴCU1S°>~* jyXW9LβTa'OӘ -Y23GMU2 *6Ap'0 .e~ 3c9 aSpq|*wcrM7eRbڷK`,ĶWQC_Pޖ)etk)=0S"@oKʸBӳub#˔$:)dLu &s_-Rɒ$Ԋ=*sy ib-MۺFhĀ9 >gQRop# kF/6erk`KQ,9RCTq^[Nu\'Td§0`FkS_85|%[2^2bp#4jy_&٩}νR60߼Q2Qnu /x>p%`Ӿ^c{PgP_%a({_Riu=zxaj 'qA_]R Krp}3y&I[>2mi'3b6s5mT+Ε˶I4m71ыfD*+wG 4ƥ͖c<_]TpxdqCPdKȷ-u7!<=Zs}-n7$j'DWuoюk{)=+`yYgl7r*?&Ɯ]دM5X?ex22>E+Gԭ|o4cCV~;^1\]K9l4_o{O;=(gа;vΟShltJ E 6q;0MP?A j):NW~8 5 =E9z:|ĕšňXZT.tGϕqGV~7v!-VXb4qG9}MFɕ߻q.cނT), .o0~&V睢^B"\ٗyGWmM&I!wӭFOM/%J7ѯ{B`cTw]frt{XΘ咯L%]PzPtʽBK\߱ҳi5-[#6'23>Z(_Ŝ"{Eq^ R|#IZeoFr%^  R}UzAHRӜo=/)Tl&|dٮUyKMPO(]d`sN34V;q=5 lewd>@rx;.^ ݪ$RZACRjzz]HDx^ {O VUcr]s&ݼIB2fq*Q =bBq1;Dmhh`W9[BQ aGGt0zOV|]_x0{NiD=Ԑ[g '"Zif_:=RyL36Eދm sᅂA(A4CӼfdMU˘}H M\1[>;K/g nZUB֯"lg1窈qe2cU\b/ f䧄P .mB0Jld>3i1|#@_k8ސ%Kd,;H,܊fRHH$Up7V#gRJ\UD'ۚ 5hE&Gӿ`Wnۅ4 :>GmV>BfhuHl0m5˩%duWUYAPAEk䝢}"g)YF0\^%,bXlh *]fn#z.Q)Q2)fb?|KS'%Z1ۯ,{=ؔ6w金-u({}^_xb|Mtf,7yh|LERӦ P(0 HoXj/% bwlM9q6)Xp9p cjMDQ#=ZdB F>!j/fnU{QyW> `@syX -Teιag#|m[\D~) f!Y+K? xkjpJx%b_%j$V .>8>sj(˦Ozũ' 61O!"Na胷2~3TJ$/'p? z$áUbgзlxPt1Iޝ2e߃^&5"UOwԂڄ3'a|08φdͽ8iwyʨ z\~W^L9w^›SalR.'r)>׽Zr7 i=9Qh;>`u_nQZʕڱH9ʻi2QoNB^oyX3Va;>-Ï4ߌfh2[a^.f|\,ecH4ؔ0a?ZtpOS8:t!48fp!ayU U]} {kD$5xZlmn!W튌"23quw!=['juNJ3 re42SY;pqS,C\cC'RfeJ4|^E^C4c`ڴJ | ;OQFD#%20FvJc #V/?yزuB[u\OpMx5@2(wF+SĨ]K}MHDpo)!u)&0 kIU k[ gMbVl%b7wyP vCR 6&̴|kuXf_):rP 'FDJ'>} ,QZ1X-)P$_=8%uu0RZB.ސds3_<; ` bI<N6<0BF$-)ݼ0umbDU`FnGD5f]Dfq9=ja ̥H:ΠJ4[ͭ>:\9TuuH3F҃i„8{w&W&Ȓ?ѧ>Gݗ/E}'FE{wKт32o\Ӫǵdt:Uޝ%tk0#į(''ul^[ 6f/=TsyY9K[6Y3@9NNTǵ~[lEWX U=MT M~Rz}UgW||L$`,kmsn Unϊ;Yo\I \2VUw8F ~/UYΦjH:$#ư{\QҐyΡjzTQڌ TC>{U(qT =,1ܭ~^t$;d5뼁 6.-.ؾdISmҶ.#e̐rlu-',;S ?ģLK={mO[XmѾw|OyO&l[W*$3 &YL=yTmgO)%~= V]5 `" Twp5t/kZ>(b-CZO`>"r]É6|SV)ŃWPdYRA'lfao[Rq mdBpbrrp:MDwk6fnM0ַCXUAK#UmaKkq, f[{2p9Ax!fRgs)1PNϤ28=ϛYd`:ՓO{ShϨBj2O=ba+z|z{:h4xCK=2Z:P L+=Fe 5J_\BAJP$L]I֚t/DX@7V/O 㠠* Y{WIz܌;us(tNp}S:/'u<E홒@H?ɼq;#R5-ǺrqEx,e`K Y^c-6? sB ksif*u3eCT,M:~PZ\cd%ȩp`#/D3E%OZ3 ъhz*asƂQw.Mž|ac!0Ҭ3GXR6۬N ɒ'g`gH |0V-M[/lN1AAXJ2]\ ! .ԕ; E含V qăwMB:̉㼞d_z{ >3[>RqA!}vfx[Rt1{g;9S\$~1q'IYзr0[:W=LDiU%`WDQG cT ÊKP:st7 S{>g4s@>,# 6dX Y}ASDNIzg!J~czrOe.C% (kB'Y?.Z%p|z/ox~D&3@Jv4SLb>K6א<0XS+2^6erb;$S8g?n0჏9e͖YM:?(qg#(_:{vrfgAܯe$bq=O KhݨNۍ9LF+Ix*)*[i\%7R-"BiSd^َx.## yZD7fr?؁)ꎣtLTdm?}h oJ\*x(;XRIhЁ@3!I%XIǥ Վϥg`s(?$?hUd>-PC'"qRۡvJWbW*,V[81<-5RBjHx ~vDϚ FhY1UQR(H_v7$e=”LMRqİSvDOj\1(#s8~&6>{B{OaRMZ^wc[NYßӹ@SnC2kP;}5ЇwO0ĺdz#;CF L}[} g?5eN24}ą~Vwx8cGeHk-V͵T⬵kg\ !k'g[&%Ĵ_^ #LGf pdQ3AEh=P UMKF+{7;M7{fqSCe eu~ /Iil:i=xd2_DmĶXOC8P`>H-Fh~fq@rs0 !0zxB CO!-13^Dzrs0]^d J.i&_I'rhv \h5SU)GuX,yONbɈz)>eI%vKآ2odX])#+{> (lX'`䏢=98|^LLֲ~N\t ˆEpOaUx }I0@hD \,78@VY|Ns𐺬0RSŽeY L*'1Ph@O%-V/aͳPח4V 50)01 |vų1.G>L Q`TG ~!e{{zV|f㷢&2H~Ѭ"!b¶XM8,̓$p$F˖gu9]w67ƣ?Ɏٟ \9̆56/(FNjBKmsD\-56~6nn +& KWJ1TܤLg0py`~;ܥײro>a46"Rd!í\UbQ;-90U Ԛc{VYݗy>׃dGq|*^{%F99\K[yz. /'l6(ӳ\߅$i]!ʮ|t^W=!,2IqGpD!3 b/vpz̊c]z> hY8Pɿ:,FEϏWä'D#@o3bzkxuqgs\.ɴ*ˌjgAIK?xx? bYϧ@styOQTn/-|dDI UWZb J>ټL):}4;6dkW/ܚ?FGݼRy,륄uvGxj|f)Kg-Z~@_KC>s`n?FZcUEW ?| FU;v_WI®DtCkf|u)K;[[[BmG} !#1.!&?u;`ዠ2d*$j+Q73 //2GI*l@Nc;ǔ{|6s9Zj܌:s^㞤4ndި$d=n{;5nt>1㡏΁3ڱt.-gPW;L#($jW=+:>%(n}/E@WOQ4@CY"[wUQw&e|HMSV;Lqm$zB{zL*J$EfK`@D+&W8}>_x4>|9:ta BM@׳M^OD\Uq %wHhT ;ʶ|6G*IxT:; ѩ6%&+4;"j޾gH}_V62C𹹒v|F3F 'ocI qWdX-P Е4╹Ȋ^.z5ITUJDnatq[lPV#<(@,otL⑘hR#|V8 c+%qg6NF 3 p"IMgFW'Uj;-&lr7  ܥ8Y!) %(׮%oI{J}&qQ݁&/ݑ;_ do/_оjbjX_ EܪЈ*e e* _vDDɜ7?vNDɋMU3,rݥZmg2li5i`hTَ Dԑ*Y1G|! Ծ$),'AHl3>E[( <\hՄEzFB滑6W}^CMsa~H9;<?l?aQD>3ᬍyB K3:3 bpvž^Ltr},j9а Cg}% ͒=! `ڬrA ۊ5~)%A;sa[LL.+oJ@z'Tl1 Uq| hVg{)[B#h9[H[D$2*ˡB.SN] ] _O&lnϜz)vM>R6ҜΠY6V.vxMdc/!n/#̚oСG&>7Yi `ϾmE+QOqP[Y@B<"wV*ۚ;>6p`bطwDG` r <-cUԮr7xSzAP6?eӈ#ƴ ++H)^A;6L&]u'Wm, -> _ŧtS>6ꢤ͏ZB)C1lj[*2һL˷ w1IoG-% ! >ƌPK\ULW#d7OXa?)'غaV",q l]T=Y+xOпN٬! 5*v IcblF-> ŮO%[Z$XD| ¹Nͅtn0 sIA /-%¹z+YtI.<''}Ay{O~ swz֖Gfi^dZj,f ?%nN(oe Yz" f 3ju&lE ͆A =6vso#ڵ.sivGDA2 p`ӌ2X6k;xp`+HBī/=.} Ha vgEpn}%١WIE$}-VQ^xXb/i. 8+ 8gf\Qz0*^BXl2$I  'bؖ4z:b.QRҭ*"\"2'[7K{wr 筺xpܟɴV*fjwyͭ}7%7QIᶼ|c.ݕFewqK!:tօ^>c+2w-^hMo9*j䫋Tn3yբIM0o]6v1POо)u`7S7~tw󝌄5DM8Ð݇̐vGY<BpYZHWwݹߝeafIoJM8aIN#qph-#(ENM mhȹK7,bʡ γ\JS li~ J0$0_?̹: ܴ;}zy*_6e>-iw/tmgɢJvy@HiBSX<3ڡ ̻=tF^u,F+Ajr..=? 2)!x + Bys<=tk&VY[^MaFo>k$ Dc!ຆOϨ-R;3"3҈(x@#s~CJE)Hy{)j1$uB}!U/k[e>d=XkyQR}~1_`;m't=;_(L `;zqOn&[akUҸ&ۺ#tW١/7}'t+3o8jIw6M. &v1ސcmtY~G\ 5:r7pġg|`JRfH!?"DK;G`B6SphJ;[/{7Nq_QЇ8x&? 7 I݆ }\yYŧl8t9"vqRswmI]od㇛:ׄہsreozotPAgQɌ1 @>{xBÎ>> o0GfHw"?/\{ۂҵ?(LִXY"Eԭ\\## #7 dȝa%V&Bn3p ӓ3TG<.ؓg@}cbd?o#7Qͺ:9 8:ƿ2Ķ}2ͦvң/XƖͩzD.؀bFIEA~ZPʊ u@&!h ri|ACT;.sElK+T F0C{DTLѺq~{~TܟuӠit'T@eV%dj[ʵ^sTd!k( g_|][JP:P8uKguS҇ǃw^h):{eƤXw8ٜ:V5 IJ1T&ҭCO {EcS:ܽ^v Y~B_!ɶ42᳍JepU&/Ǩrtq3SmzaH~Ί{*_Xz n)H,}04!_42UiW1W%J4ԹiHs/ѐn` fs~Dq)-y$MU&Mx$9hhS ?-*YԬ#-7kYZh+G6zi&UywdܨΠӒh2k{Yoߊcv#NׄsÅ{N&3"g'lAK+=3ns9rJukΟEh!#709HhF|"Ή As՗D"6^E kFS7Gs^hIg~28[ɊLRoe.& 9] ppJ]kyWdKxTiX1ƼlE Z +d3C%84H%pndt#HW8%BmFf͈n!|nW @#&GnZ:ZrIP8* 隰-o]п>J8;ttĝvI?,t J EqZeC:` ^WZZOGMܑ }Y9 ?}YMk%MI92Ngld#$( ?miXx9t}y6gLyB&)_LFZl⯻?lgcƦ{Z9plYj_ |̰ w#v*3vF >`qʹ-kS2Jc嶋46X@5V 5ܡ|;qt:1"}\A7ЪrЪE KL NK[`TlK#Dzns]ZE ~ @?aG$*V>mGe5|?x X6I [V;4[z3W%7gMd=q<,a;L~.,/)jeջq)QtJL$ ;"C0><>'/r]/ vfM`s (BP&VfhpSY\91)44=NMD˥ctK5un4aӇ8:oA`ycu#,arDN2D:'8ܕ3۩us.jl.O0q{V^sWHNj[P0XrԬLg3˿:D"=P%M8 Ψ4 7X8mr|[KIºE+N3C=k#Ȝ#.7lM4_QJuuu+!Џa?"T9;Y2]Zb( '#<ί͑1l % ͦMa^4}Omz)%QDcNWy[ͿӦ+Һ䣀ũ #Kvߡ}e;97ekYtBLMTMUR~T_>6FzqΌdEoK觲l*x%Z= rF50v 8UX_hZp3=V=Eum%!H5oA$U @/ RH$Ux;/Q\F"X $gsK d-__@|3F_ƕ1K@w@szQNVk -FrOP Q/$!I9 ڰRܘX'lӑW{V~ʷ'KPm VҤ4E1&pfާ^?$E:M m G7R^{^י2$;(hP3kC Sl0<u~{x}\"(H6Q_"gfMEJyl2ae|C/wC!XnX9bP!Sg@ψj53- V[[UlWM\oB Վ:уJk^?bQ)l ҕxm;?ZjӬe8}k^xjvsbq|$?'x)T|8\$.^(R~ FtS*Ct^;5 _W/3aNVNkR'`a|d?/82Ӈg.Zp-,lC+.Um5y8q1ą71fԓz*_qȱti=j]T.! X)2JSq Mucd9cd)Pm[E3.(@ՂBWO$A*qfjEH?;M'P NgNҼ-4nNJ .Cߨ#MO/"96UX'^ڐ7b XX>ɇyR,nt[_vB淡AօJ@=4\hI%i91[S]q}3ޝUt3Gbצ͔y*̧{kȽ gI+Ьܜ%R,0onנ_T vI-=7z&PҎm6 y-;g^#4߿hE!W;7wn wy3CoBup(|r'zvn.#^=触/a- FC{O>0u6$KC4 ءdf՟ab$GG /pL ~3ko:"iN&:)0iP[ˋ(7e@cIV'{0D+O"yoRIQ Usswoɂ[ǭO#Sڗض`T.k4Vvr~_?n*b߀@`wqPU3&a|i>ARRD'#;V7O+sZgq@jԹpa*k.f!py޻uNխ=o` Z]GL nMLN[j@2g;?պPY>ojͶM l3< 8[@.;T!if!?~6 4"&VNg-#={%iF3V`kCT|SR/FA/O_$Gԭ߮D/1@^wk{I;6 οCz<ڠwJح=KrՏ v$6/^߯Mp+m`g`XU@S= P77r1˧4*uܣfٱ_Oax;/Ͼ!5=CO98*ڜo:RJo?evY[fwz~y ,iJ10=H5#A+y7nq-XۘTA S<o Yl]lEHO $"%8Ϣ‡Ni0:Ĕ?ÐbPA؍ NqJѵu'Ͷ2ÎE$%nmKhI痳a΍"߯t!k@Yw>P+U+u ҷ~]Tf(`܊ 5nS}3/2}H4RV|alt9T%jsac^EK7cS&Epj[AX$ۏ988B(zXQE?L;?\by~Upza5:וxu?K}V)!D_Lx!׈kX5ڛ9o%k X[(I%:"oeg*\S]SaYRb#3zЫ׼[lY]kdl vKǻ*%YQ}"Sfup̥%EngN['@^n]V}:\^HL?XY+4@+n0aaE6*)F*J<헼W #LꇕB"*S qN# O<)62JX&S $=HŠMj7ZojOiwⶃHd7XN볮@s5@ن :q:\N])8~ rQ(脃rqd#8fIJoĜz]uDA'n.g͐%d-uޘG{gc)c,VI|Lz,hMQP0哥2{\Hx`8;`<_J5xMs@iuE5 G<{ M!:f.,zvB3$׋ca/1ŭ^,&l&ƌ׼~岖_krw%*$cR nC /LhQ2lI&Jf 16;|BAXhE84d"we 'N|IzP b_/9S01)Rl˜8!eÙ*VLϦ޽?v[afSgj`A-9h͔">oS%,b=Fp-݄5L5 %3Y(!'G#y}ݩ.7Ur9}AC -%ٲK\"NA#e5'wxЎ. ݳd\A྄;ELqWC:J $(N$ceنI4 |}t]3H)]!Qv|&~`!@9"0B{=f_d')h.xv- Vo$y'xmOU,+jXbҜ R"HZ 6&׽FYVkyIVuckj4nwMnV]G.6ud7o35\fy)F?gΧZBN@j^ẑC}~˥&u7P~ UWgհl&?#$.!O U:–ןAM"%>֪*=v T sr~c S4> &y\{+8FI.Y$"?i7,I)bNT׻SÑAI s^F- gߛů;ٜFu$+[H7J j >:pJRX>5o'/]-xӧuʫ Cb:doLoo8k&婏:vx -RR !qc=XdrnAYC;-߉W GTPx5"Ʌ6LQSw;{3ڤSg\f{ endstream endobj 125 0 obj << /Length1 1920 /Length2 11687 /Length3 0 /Length 12889 /Filter /FlateDecode >> stream xڍP-= 68%h͑{r꽢jZvjhT5XM` +@BIFMhA`9H8M PNS]lo<Nvv8; $M\A%V=J#a@Wp df(@vLlf R YA llnnn&vάN" 7 t:(RƊJд9k[@L(a 2.`sz8@CN3pr?9=@`KPVdC&`?Ml&& [Sß&Ps6s9@YAHd# vv@0$AN@3{6`{76CJ,7;;;/?Y^`YPM\ ߆Fs` Qg@0@}vhq|_6uiqE qc{ r|; *ʁ- = ΥlmZ wgf7~p?w! G[oA.&v [==t kf ALs A w*bfWk1d 0PVp :Yf6 ?M@R`3{?&`dm$Nnnt́0l|N(/;M/`lM7)F|6߈⃞ƙ8&fmf2vJW<&s{vv&c;#_'wqW7lEP=AaKBWo uvW-k8j#aoPZo%P3tK6C366_ҡ@}ArߐwyP'jB3'ȟkڡ| h8go&d]q[#NƲ=.sN1T݊ J]Om9E*~c ?ykˌ:7UM/+r3gSaf;cv$I4{5mIْhLd 3][I^'e崾iTE22>DcHkpC 8/*{)@Ek s!! 7tC>,>$BXO|v!2KXʶxzY*?s OQK~esRk$Y;D: St};@$_I<^AZ6EkVv)85k`}bz\[{ !rf'߇[r~H z_&/ Ib`r8>9"E GƏW4dBnt9ʒMY2 w'X35>&(]R2, }i]VT;d}*]xbF*Q@»YT-0 _!婀4NgcA)τoN2n.{HKd) ѡxbEu[eH1Wiܬ$.yDjt|w',?TۇjxRЅ:e\ϓClGۤ/E \}ߔϊfO-GAjO# ~DE}ExڢurG;V@̲^ZLJ4 {wgͧޠZT'ӀyY.ޫ sw$Je[X1i̊ϛ@|6 _(b-'YMzV镼`rO"b˞E>0g=/%3 *V _;r`R,[B~3W,q;wWܶV#sNu4t߰FƳ$-"Is<>xS{2CH270rSl\!J32z!m^=eH:jskwͬ,Tz]k(%T՞+bM~w0,1 FNlN{cժ4 =93f#myWn̍ĕUM"CXqx׍ჶ_%)X{ɦx*R(ܱZV$dF w3$iL-J(K?ƫ8 A$fs~GUqWۏOCc@'KJ9DGo8E;cjĵH.|NGA\v)A#> C Pr?1 ;({~I>宖 [=&hDnsl^W:m4<%=n@3 ɗ{8Nu^ SbL MqXW`/}v#nȗ̴Kd5I+cWq()}-UxswB@DN0 ʼnSS|eti#QRtGO>R.K&7{  f'b$4C()p឵`U8{۳O h (ܭ ̅l`*hKŢ(yFPT5gK`PqvO\h61->r'^:EjJ%5B`Zq*]~`P7 0}bt=MQQ='j{ \X!^,8PwXnCJ}jsI9;> \[d؍4NS|1Sd3T8RL_Wk`ݼ3Fv`py x0?%𱎡(=CR/EMG9rN.Zr$(1>5M=qRxv !NoLه(,~!GhdxiT!-=ca7|1CHX'cCoCn۬.\,n;f4!|-JǂC2]ČҮ/ ]F_DdEy"gt`~phSnf(rnGu$OSQw=lOzW[~fO$T_rmp8jE H{MrJtHB6v磪&7C(2"g\$(bhe[2"փkcD6N+5O~-Xfyu둆PW[D4Ww}Sª>A+F+C36WxphZxBNv5^k_$k?ӳT?9 Fł \Xdž0|IJ]TX."mM \K [-`VFLF7}w!H9OALY,5?Ƣk.{MgМS.$b<<1Bޏ|_jCm> GD7PuMyQ6fw|ʼW569" 4Kv% R_oQ5d>W[&~%oDYձb®!n Mhy0jS78M /VcvG7fN EIGND2e@ȁk7q)!^!FXßgdD6tNzzk6lj)mV[0|&@5ۭZ2JPseqbVZ H+Bnȿ!<$W/CymɾnB!Ё2=9/vKsNCZY`a&,3.=#='SZ#^0 IŔKD%sdm+OCfL{~mA #wUJd!7dž)//ڴQK 5;.L~ 8E/u-6 3C>2,]|+rb vA{ET26B긔)Xeq3<1}R6 )%fHjRA{>~7.eH3l[z炘"}.͗umc$u](dZ)L95;_^X7:A.RGgOɬ'49&;U7-^hzO\QMN٤ߥ?GD1ERIg.4ܫs[׌"VvͭsrHSqp\ITj kժ/"X2:Ip2COVJi{#\`h;)aC#fhޫ}GUc◞^)l`)LZZ˴F|Z"iYʾuc_nl s,KF$RyD}]jMCMcui]?ʠM\ x6@ú=uIa d[Kk:PӷB՛STX}v hTqBUlupßᄕF}tl܋s2) #̓"u+w|ZOY9@|.1Ad7%®GVnz{i&@&vYΞ迣lHB g1~L O;*,f.RVrA1Ʊ)wfUFӰ^c@zPφ}òbV,2P=s5n J bg7F[LwO3j8L9??M dHCb&ꌈ{?iГiKa="6f>*%'$pVsA=s c4S ϋ"NBkYY D_Vc=^rxGB@8pBd}/ Px7}Q\YM.xFfDN>yBjZtEJ=K,(D@kb V .f|kȗT5Z5kfM3_`S 6[#Ӭ~0#_/?4˩!;L0Q'6wdl!>:z)PZ M(nQLuto5ULG0.[!bw䝶dR'3R5Qs*yӞ(:'79jDemN ӣBK:}p(vS\ӾS{j}uW$2aS+*_VGQ%$QrNI Kpz{\fنCn1ժa5gh 10}z.꯴D!访GW EZ|M+\%|IąC^%Ŕ) ԡӁ\H,/.`5&ҟ?7*TMthvI ᫨ nՕ'Wq)%7YG96hI]۳Ʌ h0xE}hg~fA Y0ܔ` }/&]>L9OR cJkx˒/W2õn?<]eێZ yXZ#V3*|9_偖+?OtCkk%gYCX#"effP/4aN,8Ǹwiәo1JL`Vv˛mIuht; NߒŹ^M=wX+|./[~E+6l] ar驮Ysp T [y_{(}|m~B%4^1:v KlEl RH4ZF)OʵXA, o=zY,&7}>A:[_O'$Ćzc? r4x;\af-q;zUAС2=#5u],ײ?Q黟[¨UemFh{,e'}غ`w,FqDc@LiB {$wz5 s!ӵOٓt0nM78[\ʳSBvM,,pIg8颛U/0s*,j-5/Nb}뽰PrL+eb]+ˢƛې-\ża?)UB~"u}0nŽhrQ>֣(_Djee J&ǎ/ٓxx?.7T[w|tU_kAB)WeeLkZt@f'a6ė5vY~ ǣȿk+׍xD6H&^NEП8 k沒#C RѪ]|z^^:њz+шb,2a\WVbJ-zl7扟[9Ay80u9bqj{.r)~:>g6Α1)PI Jة3vָ8)o5ϸ!s؈<)= 9bͪN~]Z,Cf8Aw\VMt#L$fVB%Zc ;>' ~~ז/HN$?ٴ:QPWS^ԓ]~=C\ѪfV`7>qBIp>o'A 5)50Rs#m1i>247J,tVh2Iy< -!=ײ4lU$K]D=&ڝJt),!mMl/ָX46 3*q;3А_,{},|ӫw,ArQtLbKVQQAأnyEޞm(>_U6pDqGwD!߷pݰnvū_7\=#fyWzDv8}W\^M=+R/ l s. Y I50?:W$(׹ba/~zw|8_7ykz*pckU>xs[K|\ZeYc"Y(гPdĤ[u.$4k-"AD?t$pSYW q9(HKU<O2Gh9k[t;?pr*翥2  rZt+h)򶀩o($%ZJ_ѧMIPh2o(y6Hyv1kl!(_.13\{&J91:XLX:y陱ؠWm W*>J2DwAM\/ŐuNo]n4QUv*v^oeY~ d{֜P. )LļMX GBOUa&HR[ e4k4[>Mp/KMd nǴ 1CI"|/e7_ 4;d*eTG$|52SmP`y%;`> ɑ'mt(A -r*5 Fex(5Y4ʊEêqqǯ5q05+KI=Bas +ݘ{ˉKŶEUY9|Tjƒ̤/ۧ04ckM2j{/%!r@ku3JI{a hFT,餋O*huB$ѮFYB;ni>c*҄Ĩ#Un*ׂG '¿"!V^ ;]oDV}A-aFb4,һrDZpl􅝶jmddIEn )J:LICKY|ED(Ci'׍VdVm,4A=v*jA$kEqOB0 .E׆A:JϺXK?#:!D3pnUht$ZM))i:a/DHFqa/{zUUz:'xs_kќ"wlRt7F˳oYI>[E>EdrHW"2?+:XggClJjz>e# 6Kov~hz'R#?Xޯ9< QSY{pL>)TGrm9gX]׊Jmņ7eN=>hޖWXQKҞ{Cb3f8"P o(#LpC +v[=n[*(!?d7:Po^ u@p#JcYMk$phEG5i"2eǢI[Ʈbx䷙`|/Nxh7 uwCD6p%11ψ2g2sKst9Qp]SZXs4DG|VS?$RO)gHZ_,_+e~?*천ģ;/G"mEzF7FpH@vTo_Ld|\cuìR``T6ຕ߆:y d>t_S2!c|ܼ1H*b 7f5tkUS=ȐPrz=76G<"R67Q) T~/,U4Eu(sd7WeiHu:- jȂ$)¸>bzhR3\== b=M?uw7%=:v+A/9\݆H3Aj MU'ھZՙ@=U5Etw{n e#t|8QD#&֠ju#' !Bɻ92Qtg=ܯ3zxX:۾^0&h# /O``K\^H^Zy{#/~0[!Fʉ5 E1$aëIj L~^] WYfI/7ofjfjb&ٙיU9oc/'JrDSl4nw_e|iIDmL=?Wyy3;%$i$A΍$F"$>Pޱ,"0>k=#\E X lE#RDJiv/2Gry FVS؃әKĬBu\[Hu]AmY4@sY| ՙj5rUn@ZitAm@UA؍G3r:9%WI[C9)CaN=p솃Xb"ӖbOH}GVMMZ%uो?]Օ/bZWC oЫl=u%Dz#sZ8eGPu{__"8F]Ȋ ܹ-'cͻ駱\㥷$+Hd%f vQ9K$l0Ov_7 s6uz8fGc>!DV+vQ2D`PJ>` EtŰF]^I؋XƱk'=jy){@N(ݾIBl3YbN'7{\~ }]5,qWJQui'zU:X-U0VxAQFyT__g[Px-ܲi/\Γe5e]g$uhBjJ=)6X3j3=.| /j 2ځm?G|;%4W`lθ? &"7G9vuz?~ endstream endobj 127 0 obj << /Length1 1656 /Length2 9681 /Length3 0 /Length 10749 /Filter /FlateDecode >> stream xڍP-JpҸw@#ݸlGkMTk{y4WmC^70Qx(VOD¬)`K&ɍ]5㋌g]hܮ^csVa@ My,%+3)"#'4v3|dߣ"o wV+49\ HaG'iſǟ.2‘$et OAom;Ѓ ytI ٻG<{'.Q'#FIbs;v,?Y2Ge\k9^@[?,ΗSc:_?¹A\K`]uZ$Yf)?nY5c5g/E4g{!v[t@9iM %YMI/}$h j͔_k;',Yl#4+'V1[P;܏:W\߯=l׹H<>: 'fK͝qjwO$GUk$~0تtΤY7Kn>h2iOsEoyO"%*P6X)[#:ƿM efQENgԐET~p[뚪́%O)شn|j8QezƖ'@ ^o&:ݸgZn˷f(W3+n>t>Y-e"}HwF0(OEޑ2C7ÑwB_qߋ6#DY`|BB=_͓ɢ_s)]IYZEEdJ!`N0{{'&m;`{ɠKm t|B!6^y}%D#wx_ao߯F0%VJ(Tzⲟk2jŃb"I[_ix&]'s0UGdlRW83iGmRr|Wm|)f4& &bfpo3c Ъ,̃{wJA-8zgJBdgƹl7W#\-l^+NGC%D )rg@fqC YvQbia M:)#KK s8[&=Q2b'E_ےK:496ﵭAO'!Iߑpkn"Bq lVLî.}$#gǎzT=:^oFMkPguEy3Uh 2fk-1^I6-&שP~^hަ}32R^pQ?}V P˴D6Myᢩh#WGbd+ UUlЯlq!uŌi1ZgY"SjVw漋OtrLԠ]wNQBQ:eÑK !o؄TS 4V.=3tf ({"{sE{ [iSqҳqbXo ПPߋ AO(4YA:gȐ$AY†;]vV] gf0]mn<ViP#dSaR+ּU}m47r׈ +!8ҳ[n+l6 xc׵Zq9|LO9_ {%\_HO*RprX+(yrSl'[jrL=ʼ~}ک?0VBW1jl!vb፭ iSwly$~U-/Z28~#Cr*NWzAɋ+!(o'2xxL8ti}1-Ce@\@povX`[k;z/Յqh9qܸGDHsWKLf7ngfhO2V,Hj:b8jGjdD 1E5~|"NKEǩnP ᛍϣ;tla7TX~R~T7"l1/#fi~'0F#clu80>[1 }#`77Il+ /Z{?6]JHྫྷ;x?n4v,|{12L@`"&YNc87#,h:~XĦ,5bPDk=/NG\Bw%*9`31L@SH6j}e֘[n2W#"l)5ntQ0~6XqVj NCU77ӯl-aee\@cy\e~L~_1>խgB,䎖.L?QK$gנk/J2y.Әr91T*,r0B`C;1F5 IVpPkY]V~S9 6( 5Cc[ScJEڌiFf.FbzV'Ӥ~#ݯx]TdQ^l CmJ5WKeqSp&dTl-+,Jnz9RTSxSn9+kk>> لLmmBhYqEZH vD$]ן imh-hPS>ѹOڥxe汆Tz2 /I<x[<#R*s$+Qq>l}Z͛}tORojJU IϬNvG@bzKF5rf3T p|K̒Ix RQ ҂J߯|Qx5݆uJ"--"#TYgnVe$r$0ٳ)i="Gca7<㺜PBRSldT­$x.Cj!5pB?(A@e}(`^]0Q]F*o~*CgYm8 Cqˈ\,׈q=.٦cŴih$}j7ҿ(b1m`6b)",>a+|}$:r-~x쮛6lu`ڣ?E*,Wo^j6?-M e~Bmg Y-WeQtnuR5t72Ld a=iH u` )4!At-_'x! 7*d5Bx8Ǵ.;CwrPϬBی͜5${-'K~Y3MxCR'tߞY{904훓nsy>vR̩J*gڻz P~+jg.2R p&7{;6_`lC/W,~qP%R& 79"/ ߿ިJ))iZaUCl^>F[Љ89qAs +{mD}-XGvѴIe# gtDDF8nd@t{avL?Y}|{07vc̼I=oYůMֆg4ݚ:l 9\Kԁj*ZsũuQ!+hDIܮFӲ[ReSD \Z4K:%m?*ͨɛc6̘n@ G}UA~H0oʰO+eΚ' {$b%d(l?1P +sg3{Lp4}0v.3si_a޻a8OX^]\gP4%hsSJCӶ5tR)wéIl2hvkb6uGO?w*}eW`E8x>ʉB_j[9ʕAU)h*dW6-!t8&+p6̧3*\9M[A" Zk7=!(^if-hQ6~Iz; e [c3V#Ip'IPQ Q.AUA8>f }ocj+V;-is ۔Q\Qe<5?ӂUl[O|-6 >gsqCփ۫oa{^v~?isf5У|@hZ2Qs &YV#0'8b]_H5zsU198*4O4MI2xMO y$9i"mͻc$ EhTq ,85vo$)3(=rV.4&}-h+]ٷ<߻Lp]̷ύ3?y9p4JAkDOIBqZ*H2ϑ-\Y|v -|ÎSkH3V6#`OV̞6xq@JV啲 qؔ`Ritr]#Nd=B ,g@1`d퉲Z1P/}0"-xe !D]ęZGRTJM}|&-3f'ăP?,{I)_S6sJdGSe֍gWcXљ_']whJiXFn7~"j9cGg)b㵻Z%K̈́n;IIƫ4pLL!~*񅱝 }Qźxm5 ~2g0Ufg PG3Ƙ.v,%]A8_Wd|7uznoX\8)0P5Z Y?*h)2څ@a1_v |]ڑKsNw@פ_wZKiQK'^^Sy4kq@ۀU"^)/3{kzU&p Ewl"Rv2Iճ#q>&h>P83%cꢙ}QgdjG;` L[&J*meM/u, BWG~=Rƥ,o?n, c[$0jωb' n1^,?zQwr渝GҢ-8;bE,{ kB;$k4{E%8>zB½])DXE˘0Zb}l}lbX2|a|`R-`(g渊"Kh֐K4Gmp}33*'lj3WbZ+o5ꠌs( Lio#W;@wG}ol^0\Z_/BoóE+wHkj)z@q|Sjk6HuG Ԇ* wPh2Ü+\m2g(Z$6yD|kv3M#//#DO.lZ~^" *,q"((W&&.]^2eLHJXU)yů7aŴULcH u^AΉB[De+ǧoAH_-g*]K=uβRr;H>p%qˍ^$q<)c׏[dxAlTxN}LqN>P2Ǐ[Zc:-3M'O|HTCSntϊibe{>4>UJaѢN0fi4ĺ=^ }=_|[aF8,E%}UDF_{GԮ(uKf#ϪƐSYBw[H8?kKY< /ԡKzvaʟcp h̠4y`lPԗfPh0>L+&za[diC”_2kgs1SkzZeeԔS=Q3цg~.bFSڹڃ0\4C D Cl!!CA%0/wJd1g6?)?䯈ܩZN;eU@+|K2ȃ,Ϡ!.cxm/\p&)aO{A+X)pfH,dsbRHX/Fڼ!ЂΊ "4g9yavm-yE (?B=&mz^c{͉ ( 2h(dDrW@ VL~ւI}rLL{57="1KqhʫUsnlh,H3ŧ[NJD7@ [|o , b(]_*USX*fw.jZ[\l[,Kb{]w+Dw$?50HLk;R.m|ShU:j]ia8F-i:X"нN~1w͎L0P&B|Qao)+ra'PY_vƗLUv7n[#FgiL7 ?MW7vW c6"U endstream endobj 129 0 obj << /Length1 1391 /Length2 6286 /Length3 0 /Length 7237 /Filter /FlateDecode >> stream xڍwTl?JH0atww0ƀ l8lt7HtAJKI4 H|S}s]q_slh¯waH~!4@EX$PJnAxB0Ы $S!1fzp@ $@Կ i*haOvuvAbnIIIv(CP0!]  7  %DzH =gyn>0xBGr wH.P? B@ <1^0G` 01п+=@04 pAH92y1 o 18da:O0PWL`*pww I+?U(t-{0 stU "s b@ PBR y.= B`L~pH !yCH$?HP0qH!NdP!-[po44125]Up_DC?eW HIӥ%Z n?c1& P | i_Qw>^nn\uC 6YW=#ZHf`nn"S8B`?TZ07( bzPB@0[v<>VA0K+``3b$¬#Aq` 8$)*H? q5 ,oj`{!L2?˄?l 8Wÿ6*7žf7:'#L ]A|WJ|EYDӥN[aT{˟vk/IiJvG|Tqy+nv6{#/I2bS7o+Eά׉^TN'ۄg/rțc!@#u"}V5v2/InHժpٴRg==ܓ[&873o=+]A˜&廦o|}LNZ+.~]3Ž9@4`Q{M zm&шW=UƼ@}wD(,M{Ph}}&z}^Q$+!tI`b>ްT` zz$%, { Z*lb5__i}}Y&_H$#aJ9ЪrgdVSe` (h Qz` CNk5%;>|:5idpy=&zD V>5fƤ(sJWj9~mcIyC,1z"F;Z(ИaăTvөݠ{Rl=VߨѶnHDE!\]Nΐ|<N0IP3c hP=wyfdfU@~ʗ9]N$ $Cj{PJ 6agྎŬ⼼-ӧyɍ ;iհ9[-$xHu@ M|Bs?|[pc/,`Cv(nšr2#[x}z'lI?7D:'oSYy L42 m~RzG% bd3]/ř s4b%oLtID w9ըA4B^ aEc82lw6>d9\/zoSݪ#wi-j,g)v$1)T+s k6OfZP) :ƽu1Arvl ]v$UG \]`X$ dԵpKZU7tqNve.l)g\^|]I7ϭcZ!ysuWNڑ[b|l>%Fo>SILLQk K[w:4qrIc=ppB;k`F x2͘O"e%$}cEͬ*&N|>äKCW#hшv*YK)T43Z{[$CWb}kb2.l(7 {vgpؾmk@ )\tsL}>eR]plf\aO'̛F1uP/;2ېƳ8rf\*^ s{<⤖"vn;΀}Ht`\;jǰTY5*8^ly1;|RؔcD:S_uRkSO&FoJaUk=B*k~!НG$,pW_zͱSoS/Jj댁msw .#L3,ʻ:ɵ5 ƙ/G|5Xbn'{9 n*2hw!dU~>JØ,yYT֖{|\pS#--Y^Wr>9e+լ] B IVC^[0iBv =hIu1IB 2}rFn3LflG3 a@RНQ0~wՊE/ޜ.~o tO^vj;1<~b[cMbkKtf;p _9_1Dtxx3~x7kjVkq9i:9Ycy+ϰ'NXʿفef>OZN`R[{_$*1rZY+1I1.vsaxLכ%+"%iKxzic>yYWRp%Ch}jLe; =}1P Ekex.&Ffګ>\Σl<,,9Dcs(XQV CLPءOw7?-j "YR>Ɉϕ5FF?,7Bj3U֮Nw,Cu jA  |*oS,cEӆ&e_o#mFԍU<*Mw  óɈ#4Rzk5kGk"I9{z K5k Qw^]s pMy֟ˬLߙgqfh1_;\sRc_b@Z~;_1cMd㋙R|ߞ(4^<+a^;aĬEyk٧֜6۲S٧R)gtb8f!dpќI^_Is 7\|9e!>[E0pRq;4o_n5oKf-H Z؜E{' Pࠃh^9rUx(}݇zR^`,V7%-Aɾ5fWkJykn02AHh^(u~ىfB~ɘҀMW^WcY"#d [cpU\I e fPsB?(#yo8G0ګnUBŬ5wsͬjG&^_0f$x}*j~l39S8󚑎oȀ(J>&J[MWqx7/{"sT+ssd<ǏqS=~pQpzɡr3!Nsxʹ[rAs#޵^poA{dӊ&jCЫhs r%KL~\xz;8]J\[9ʹೳ]'.bvoeS{2rY3jf?<^Hoh:Js/W6M^gN 5U:"'iez >$۽ SkA@;=̲=C7' 4eIEx7z<%W#ՇQIΥ]VBя#ס\)n\Ղzȿ-sJp,ۊ2B7t@a+uɰcRX h|" +S I^b/>:;753IbvMÔ^*U)]͹&}fPyp=7B^uA~]sBh./q5 2CL#P(5&t([*WHe\U^:ϕ-oVy7LH*B盔t dž+ۃGÓ[cOkxq9Ǿ/vu N&k>g]y!7* QTpW|@#d->`&şZ(F5Ju_-9K4I߇ VHۮ ?VRߺ,e44?$r+mw}XGa-xU2O*(℀k흁WDT /[[U߮6%'u9.|_(޻{"_arDaΚ%-d?Fb1weUĞ!>`=9T7\,nql\mMr|xpׇ<K Sn?$V)x$4RH.P-U\&xx~Fsêܠ_<@+gs/=DӆoY:ivUO "p ٍTWj7=RUh)5ZDvLTOٴԲﴮF\S,lE*Z}Q&} +r@>e-c- ա (tSZ~<<ؓUdll؞BRms8lgX4Q贇K=KwL_db~tzuSa+S ($=R}w3먥k*,ӍG=븺`TM mpq8g*T}0rM##*qeXwNgt_0":uoijCn 4) 9>3Xˮ=C4 匈7y]~Jcג&-)v_j `~3],e,GL_XfFpi{.$z^F9e9_? OY7r> stream xڍVTS۶E@JMDғAzK !@$B  R+HҥH.E* w}8c=Wk5fl&vkQX(Xf`* E`19,_%j8ԡXBā)9 eա(PA;ʿ@~"++-;c0( hźÑaP/c_DH_Q4MQ@Mp?]! ݘ(h]P 08rcf:@#o8ꏳa_WB_P 􆢂(7+ 4bP/G/"x߅C*&@(aX_Q_ׯA/Y墆F"(/W}  z(ܟ+?o QX$ >@x +y7 F{]-Cp ÁX<   :(0?y "x '{e ႴmUU~7o*:IPgc(*\@?o_5}!g.C4p KaC7v?meV(W?,hPj#W V,׿/᫉#0?T[7F"~}P"0?lxU< _<xH  K]bR@( GIq ] X|^('~ ;Ax${`~ ^h_ߪ0vo+UDVFV2DpS&cjTYvO\g7 &'!I#++mTuqs+X$Ԣ˗'CmpЩXU65bRJHEݝ1<,$XN2A@Q .$!@fx!vAxss1VV^V[N}84]揸¹1;XOZaKA$WJ=DVnPb*Ӟ ߮&\];ܦMp׼n9}&v1ӒTl.56)\\\Z{iע@T\&Toº\Aȫym9pIEʮSrda]{»C5ff߫blz^N^uT ʝR:(INN6ITDّ괕`6Ќ"Mp@)6,sʊU9i;l}k6;҄q|AB@3/pcJ핒+Ϥ:'NmhVfZ"{'I>@ywоSwa`Bvjk'A]ؾP԰8?bx$dg*&ek@]3ӯ?n!wX]XI/s>8֚#@>0<#*XoҀkUa$× F߹V W?uN a79H{Z6$G#Sv:|IR{[Gj덊ď4N=*6%l ߋ^ iP:w6Oڛ(b2{7*QSHDŽ~rFkngMv< CJ[:yq [> Y[PF0osgmgjG۸ D;''Bټ.j)Z*p! /IYԌjګn]Oi:v.`WſS<F)ǓE5kX#)IM(»Gz{8ENh=O囧:̸r9&I]oa,ǾL=T\N%qLK Sh"YBG_^Ē#CU3[L_Ǫڑ?rt##nJPz,M!A; n| ejlN" %XLmi'#rKKHK-\nﵦ!-`xFm5]l6y0R,d&5^rB| n,lp^s:{'UR}s(f&&, tu8SOa0=-1};C^̽my.P8Lmx$Y.?gҮIZ[=M3xw|vlJßFGsՈqgǒm^{;'\hpy6*-Q7E]iQ3hc(ػU_NTʼn$t{GFdTC,u,\/3eGfN5z7b@.(O$ e'{_ZT{ejZ؃ XUh:ϏXa] : tPBhR( 葲2+Ke0s.pBۈY]R%'^"K| V ~k [sb֞Xg%ȃ+u%X9`clSSΔ3)n/6xDG{*{{F_GdYR8 RN'Kug-6̭oNSSh'3Q%NHv'F[z.zp1G],b뺦;j~@ <䐾Ы'w,d ژٯ"ƺAﾞXMH=jWyxғu*޺ PR+f@Ż;չ?nT'tCHs(ާV4_l/S8LhOM0%?dW?*`#2Ӷoj_՚(v㬙SuWi !T}@ ,QdVyӛT{Tu%/{ :h7/!Z "#۩@rF,K6vcBD*[tUaIXKZ JXf5|~o H4˄"'1h&W{2B_ݽH[,Qj8j7]I Wͺ Hp%εiOomv,ߌĥmq?@m h{-f|Q-Sq}W^eF^u7Cz獊R WW7pzPcP:Jӥ6m4߁UN#R+ WdkRLq䣴ˀӫt'S|WߚE !SN|\cG^a:T!x"T)`I-(:W3Z߀ GeM.{A5ǐf3-Lz-wDѭh/u܍ =< S(ƨ|f ^iO;,R ^bsJ!m"l p88W0Ղ3@X8 'Tp (yRzQlwȽbăPR_gӄظ3OeF2-[PfI &[Ճ0Cebe-~A/31\#$,J%HD`Z7¯kZ.ùTtט$gJF'R=] :Z>ĭ MC Keq!)WRk6&$ʭoX A6"ϴ$zOO &Deicd,wjIP "jR5?.Z^+**B%hyKꗼRk%v@y ˼ E%^Ҫ^zp<1|uK tZCϾ c屝uJOKmL~[i!Qˑbgr\E5wQp5M^}8T׶0UQ9EM9R`/?>Yk_%(XDyr?b(Yq{|F=1|gw*>rRכb ?tD %_0#))Uly1M}\-z+0% $X6(!W$cd,[i8be} Lu1Wsڷ˙#Xe=k kh`d4M> stream xڍPi. !.[pwOtpw]K4ssjf껻"SVc11IX;2Yb <VVvfVV6D**usG0/)"&ƚ_z1{LL @.> 7++ mf5J-<h@^^n?"V {s#k-fcdrtf|,,...V6tsG3*d 2Q.@ gäTu3sj6&. lnvxsp6rdJ 뿌2`h@fG s? ll ̭M&`@IRՑ``ml`f'q ୾T`don`B?¼~ Swc6.=[Q-HF?o"d G'+++7/\Xf S- pwyy[9 AֈDLo7wh 'ݷ2cgsY>|֔gDEm\L\&6NVQ Â_k_dN;Y :RyXad5z{?.Gˀo>N`Z?9?yur|} ߦAke v@!;H,l`Dž`/VY]o 4Rb! qR~FdHWuF$qme[Z'Qs=\pKJ~n+)#~b"&u=g;OM?KfNYl;'\;>)׺屠]*.9H9Ìy8G\ 7/4SZ04rlKz0l-9Y"£H@\Vs<'Ƨ0 "_5 g7w3܁V&;'LVB'KhC:򚷊15&T}m3q']=l}1qso.m=3}ءM ja[`9:!6a̱QrO樿l#+W.}ZѶ<6>uLĬ=6a k}{Jzqn~Ţhز҉ Vk)0\b_u>g-KmaY3uͷ 5B^|֎ؖ]*w|Cd*٧T%k US$~Q)4XZYKϥnx# Kޟ X \b!^F&Cvfޏ1w2-PO7󚉚 ^gK4ܞmB?%qp8)(#(t6D.m)c\8uPGm!!Nڧ'`n2o8Gk Fہ> %#ls\գuN[թ~m$R ԇĹ oTLˍum[a*P&PF6Nvŧbހ~KLBIv\~2$pl#I*a @ %vgF0~lK鎲ZJ*q; ]#: }q>Hj%܈I(= ZHZn! i$y׋hG_< i>,@fB%81ޡdxSNqٸP>LyNY8-ĊncT>2t`)Z^>^BlaP4s7OS|bo?g)*I紛-8t$@׏(e#m>Er1E(Ҝb>G\'0^8QKNK|%;eOqքMIU;aʵ=|:ǼoA7i /j Q~D_[vn*_k b0ϧq[j%6`Msx^r V_iD2+' &׸X=[@5.As{`w:+rr@µR_l>0-Nz4B ;"mK*N&T=V𐐢Hv u'ʤM ms+jTD!N?';SĞѿQc1׼LEV~\dIlƩ"}SJhJ-CyJZ;7ʸ1lM=<E<)>*ڼ|faEPE%m|:I:벛6z6ޟ T70SC[8nߕr6T/ 2;(DsTN; ?8}>3:"{igY])5v=XnUn[W`S1tH<^;hc{2;RHsvT1VF=~ Вwᅹ 5a+59m%@!Q?P ¥LOY qMg3qp ` sa)z.RT:iYVj`SC&} &DIt)#׺E s 01LB]}sTœyOQ"97=95DF9]$5oh/vR:~jO LL55x<ys琾iLHj/h3jנACӓ8 Fi>H ; ;Oɉ_ܱhi3'zKRҢöX$ %ņSe02b -%uҖ1'3ޜrzZ_ g.U8c`׌p<+<@)Q8dR?ڥ)cPCg<LXh 7VcBmyb.2!d8.Ρ3$2ϙ'V_2QP[+[A͗.224L"ZJ33+ &NRccV'vR1#kY9O`h.jf6zIu˴WG_ۯK28%aCd.>؈+Ww#3ڝlmDbKI|Zr#~Z;ymddETGZ۰Ŀևʄ ]j^ m sΜW }1ֆ:6WRrjT˞;0_ogrQßZXR!8n]6qYtE?`D5tV߶\!b+CBv e0V~X,,YE gh, HSDp+ ܊pr=H9`{~ @R^}K3IBLvәa+&'[)t0u8wtF j Es_B8$)+_%EJV\rW(LZ]^H99;U!#)/,J6zvd3:cjVvJ'W}YEWL1&־YТeuHދ2 VC:Oz}:h⟔Z'VVҟSq d1!G'tԾ$GpaUv.O4/KBãZҰfNBYq,06&]z2F +J`収Nbц 2PDWZ`L|Whi /?_{[2ZBz&MLC27ռlb7qKTs*U)a#0D zZ=2Qt ZMqkz?erƹ#Lg9~oתmm>Zx^ё?"D5yk ri~a},>^^z$eXn}M:9 yΟ~a9=@Tfzg]9|#Ui+&WU:,R2MCvR'Xf}kx*y%i[zb1,ӧv 9Q/r*?[{.}AM+vne8MF85,Q>H+o]au%=;E߯ea硽t|'K. `Gh ^9͸ ,^K\ GS y~xrL (|b2zwn"кb#VdI`6iՎ/E+5Wuz'J%W*MޒLTjsMa͈n{{"ݚcQȧ1Nb=:فeROM1%gIKL[-pt/?&}b NMT1TYj-a,9H0F)RQ^a7o! v| XM/ N~ův p q{nԸ\!,VQ b8Rg Į0!od,agoHw2P ߂Z%*z;n.;ƥe5/f=ݝ|so?ݤeaԚ!s|U5 j{>]%(/Rڛ Ut{yK|U ߮G#RR5o5Y|2T1[.l]U"A㰦l/k[G_<G[a4"Cs[Xs !*ؼ 3")/f9m,(*ܤmcXAOy`*A ]!:s=QlU#P֒nToOԌ~ِ;o򓹈=uJgYJwԸj;Ou>gދ^#$Xhy}$ RLG^%/-PH2O|Vuiϧ`Mj 2^ թNym#gm'Qq6lb"WCgU% Վ d|8Ҹu" vhnBH YppXŽcsyk%T]/6@@t_ 7"1;hW2f]&J5h둺"B78(XEqp(~!-t9؏-),u{d zTg;--L\d3krz+fT;D=Tlmrd ڠd?}UG=K55h:Is>~,p0@XB"PVvM]1US`Xy'V4OTw1"*W%>Z$N,LE7:f/QcwZrVYðrQ+QVd9`o]ߍυ^^}yCgqiѫO跟kEZoZi~ [J*rT<^9#3]SЋ<ԗ:awV]nrx`h+dEͻ[iTЗ5Jᐌ 2RiK+3>O=NNns8OKyDmFrැ6M(U@M!7=ºRBOT´E뀌/“c>)"M=[L8urbݎfk JÅxAn%ŵ(3B+AOɵ lYkN{ hl>lW&!QmKG1e@/ʭ{ Yã &r⌫p!ϥRGyW*T6pWv|>Ys8:ilQuɌ}oEm\)jA>psWtU5& jE:ZœۜPRyxU-O'plP:"KrN -K|%>" G\\ 텈$˳djN9;Q0[|֍{ ȅf{`a\Wm 9巶çݼD7{G0RzgE(FJFb8*2?h]3-Ci,pqo_Kk08I@;Dr Ǽ[p lڒuD};gK *)?=ߎL%ʱ}0-W*,g~| t^O~=tY3ܮi]SC~n|*sv\`cN8?g(;LIOiHƯ\Fhdis̺lݮLo$ gkPHsyy0 \a*n0 &+Dĕe2>'+mP{s)@f_ਠR% ?&X6=@0$Ơ h`vUpdp댂R:u_|f=mZVV"2]X#cgM>,nJ݂N.D=.޼|34XChTq%=23)MxcV\gӔMP^Ǭڂ(wKO>TٙJTw'HO&׺dOFLۇ<ۺANa"]3S~cSz2P<,pfKO2ITfZ̳wWj#O2=&=vycf&:Hud^hB.,E."^#i9Kݜ&U[6簎uL}4 &zoUQ5c׆.5&C SZw܈G$LPLN^?+J9bخv,}Dkyo< %Sye7qхYtjV$)!z4cU/3eM·_fvdȡ훍f$4rPLf]`@(r5TsW|pNj\\kp,zȡX? w&f0f|ܛFHl&"lݿY_Nh)ˊq@*+MNA -*×;$1)1yla,ONrg+#ښ_UA_xS Ȏq/=_ /Ro1#NÖRsb( rܠx &FC HpCEzŸoQ3p[#؏vJמGr82`-?S{T1#ЌAqQَs~Ȧ%_[|7lِf 8 94S`RW줚9'ƆӾmOJ` rk\?C$h6Yq;3qiee,U|mDekhF/t1]eӑ$6FyznXAugڂ +iBxV癪s['m<'tDA/ʲ̓ч~*Tȑ cEjЀմwko{TB+*@8Ljv*r|"[?#H9.6$W&&n}V+2x$.pܤ;\N HH.z-wdEž>>\q_j $TZHuX,V*+Q$; ]@GnY+:䊠|f<ɐtgl晠,ɾɣ\KUүň9B'%;Meeu Y-7䎗_;hsrּG֙9IaӃW˧l-+S#By4h`3lre:ÎC}o:ԣ61- ;-U]c6TF+B@${5C| @NNc'6OA"!"]LF*$fOMqƛfU)k6ebW(Vl%PpsrMۙk<-%/+0't%b]d;>-kQVCҪIޙU.EDYD@O*'>^ LAWk'(f njق"_jI_xئZ7:33_'kd;t|>!_!Y\JwA "Ғ KRj'Hh,FtX5V뛶6Q]^!sXJH{J=ᗡIyՆP!UIEEu& Mz\I c2H3J #/vnl$C9CmN/\ޚ#1g1%kLy,N׎G bHEu8=/QYj9+Y$۫i@rdR5\I!;H8 Sxl3n؛Sb:wŰfG.?P6=mQEW%o^Br&E2ϖ,e=s5r*>:IHIS 6IYgSr|"5c;lj~YkKj8ӣ B;mdVOԩ/}%3Hs䗖>͌A_j#pO)L_0a rm¦H%UW]ctW^ps|*~#HpeJF\{ֳKyh ΣBsUΫAS/=ܘJ_:/rFXɩ\ifGqX ُMcgz~2Y!L&`g.oi?Te_ YlHh.ZwU.sϜ<Є1uW0ĊvO{i|s̭}| f?=\?e1ԓɘssk\ĭ.Gs#T| ۀ9⭣ntRx[{gw.]3BH332/.lΞ1ksThɆވ O*"fs뙶l&Xvc/ %{ǎmsUFOI\P#i/n)@ * r`Rxu mV=Ds{ubsOAQ#%㹤k'2N=> J{~VՔ:ȍ^qu2KSkxR=gE[)"zFOō'XŁND3ue U&$. `y M\u5'vghpcnHyGab4F=g'=Gߥ=#Ҝ۳PfKHضKd[+YQa,/ʰ!bif&p=ba$S%BbtVDoR u # 4x_!XmA .E\%ƾ!ךwl5ې_Cǣ=]J+o{`JDH]r_#y/dFVI m VeEj87߳Ǹ-B)Ӿe]Пd:JBu ڨF( iL;fuLf8[tDY6gۦ(<E߾R#ÿ:=hmS⦼}a+g[#aJ]~X?eus(U|ZǏ$.RH߭]Qu*Eh5b{S=THc:'`I$I&gU5#*pVyG3T≤9i&D )X ԅ|-# =ҚQ#!E_&:rG L É0&/u4~vZ*yb_{,ŏQGFе좶9X+AjagC^ N ll\O |t&#*khjw;tZ-'41Yf6f}хPкH. XpTHl(;]6 \ݯgr_o 2K;=ߋ3Qg{F "؏R0 m3n,}.̵=t2skS4q0(Wg!)- (?}Rp@A/OK_MbHge/+!$5Mc|$w.=Yp$dxہ3#z}m@нkY;F.ktRZz|iJZ/[ƒ,EЇhY[DZj[BC)~,@=ZYq#iCmaXYU:*%jB17T$nEH2F鰸"֘i;}+(|D:jYxd*8> stream xڍPX.hpww4w%\ݝw;s)H> %\x&&V&&8 UK_R8 u?N@#ˇ@ `aab01qމ ffi g(D<,-\>20sss:Y\,Ml*&@ Ag`d`d.@Mpt(Nn@SlGPtKbon|l,Mvv@'Gn@h_t] ?G K?LLm<-f6@ C#g#7#K#?$F:g'KggK?*d#%ۙ\'f4uO?%:0Y:e![ft311qrU=*vw}4~y;.N@_*13L-M\@sK;fᏗw0}43Nzejog(%Y^ςxӳrYؙLΏGld/LJۙ"qK&ק`P;GT7.;sD4pSK5_]]>z_cT׸M-]mW+b1v6DKg KgKZ/fcillB331cL?G?~ 37cX9FNNFpOch  v..|fNp''3Q_(7b0J #nQo`T0>>;X?r(>Қ}/ M??3HcUXx:X|l->dY~fo>6?3ss|ѰG)?8~x}ML]?~0u|x{~0W癸:9}?7G[@ ʢ oU]pc0;$Ł7jzg$d-{^=q;U7IJm/> 3mpXSgB>o>ୠ]2\H%=C9d_fcԢu)g-BР]y ϡL&I=a-f}ZڨPeq%!C9N^.)\\h+$AK]Ga8fɨTku_dMDO-m0p"UĬn3Bwewl߫Yr,p$"fGOlht#~)q9QpMZj WMMtl\`6|MC.U^o]Dcoh9b\f0ZPbbI& 1DZD? Kgq~"J%Vc֡QHJRހum_U2TÄdxIB޸7( 90LNkzD88=]G4k08͖w5ékFNA=ޕ) GV43}LɓMW nFҚ@sQrSy+~ZҶ$/ڔվbhe*Q`$o< ׇz)]je< ^D Y8hJ{5:|ɆM}y~$@'.n&cRׇHv{VZkK0].~[8+({:~%?1fh >C{l}㬚#~}Ȥ)ZGP lj16o?~(7@.r#.Ş=C׍қcT l]쓜ݡS%Sc+R_HckBAc;7e, j4'zש4JO-A[r 6;I+OGfֱʠҳ;{mq׸ Z!%K ML@'H H`y4л;F@Vxhk oh&RRZxb,~o.Z1#(eWѳ%a@\z5S7Moѭ5t/jR]jڅYRT}-Qle5vd[j{]m<6YaQ.\RRSi10biwDEr A7}{:iEخloE_e}^c_&UTsH.SAD)^#z<&&ׂoǂWȜ'F+hzJAtɻG;r.mu<>6)j5>D&놱 ;I/(ZqB|l8O.A7Dzh9:,Eᔩqy_c"'q%٣]d'%߂Ohnt6_2ձ}:l6)a{.д/HǛbڄu7"=g>k&nBxsKk`Kt{hcJM课.!bD̤ssZ(g*K`Ag?<1* 2hL2S/ ,c 6[is&ᐸv|TZ)K3V7ǽlUٺK1ap`)ke"HQrGC <0[hTI &_izc=}io׿fH %?jA MrDG .ESӨlit%j.{L9!WB|+;+1T~Q,LM#)x7\$6KڋP`#qb$Mo#Bs?UE[xIXs1W=UzS)H&3-V)q\Fl]S7o82LioӎÔ8_KyRM<`h9*fp *g{mh/+5 K]۲n(:s ci9qw=&p}zyk z?wvZn#8E>"\NOܰ u8Fy#~rTrl ruZ;t8|Be/LZ0 !pj=Oq E*؍:h! #cz˛3P&t*A3GΉPt ::L<ДsM_8B&IU!IlQ$DxBtn$k!F-X' Vp?…-t+E8 x^EVuK'jcd84]|TǖxRG +Ȑ Vi, 0Ⱦi1Lue>;" O?( _Tw8=$"[~ l\n}Sh~'"Kۈ9\an@p{ĉ睗)kRPwZ#Ҥ:jlKa)T;;8wl`| @ $lVwu۫[(e%Fh‘01hMܓsvՋmsog/}=3  SĤ3YašbYː e˴}E,<L d(Ϭw\O͗5 7u x U%&z\¡US7bcHl8e("f&üĨw'-V*c)4ilp,zv^%3f*x`oB0wK?g57Uh.4S{7%Jd٧2e#(˲Jf㰯c(%|^O?N[Ȅt,eWeJ+P93f}AžSdS7'\(xM)A% ¬D)EW 郘py cl>{"LqH׺1ѐb6:-(mV'2Tq%өa}/Aj5[m&.T7cDPJ'Զm '?:,7@3G.7tuOv3~>m)Hxݮ fb5߹u>>jg+i&$ e=`X+-=7F<KNZrJZH+Ztp.q6cT%6[oMXZO.)?F.:GTHDKI=1*- Z$eu!^ %`wF$: IZb:9N31U0BX}@lprsw%z\)O4ΜMu3S YeZ}Zr@.c^l'-5gh%ty|˲g솽A%G.ב.h<%Z CS"!* MC MI<3}] q;4˷E Z>8!Uj-*@߲pD mډ3c^7:yjcy䋸CrfiH ^u.c[( rFg͟>+[%dZgPm*{FP?[ o$}3lWW?K7Gmv^$Ql_~WPgMuYV!t DV.Q'9m@1|½#b |b+#(v*ٝg9Z Z6MȬiK-w􆯨_'H }J8`MQbݫx9?*c.( !t'\g71XfրY_l16kWBq{]iAFNfߣ!W-l^̙gCJԋ5Z2dW|kd6z(W`CĞP^a}NFْ-IX03ѣ#7iFH,?rjڑs51AKPO+Jޱ+r HJZ<9xI| aT!&z;S4vuJLMKH;zܥ:E6ߝX/O? &#:Tku#Fߓ}' zM mb+W~_ 6鉣qMټ]vފ ZnIrHuC 0a- Y<ʑ@1oOa;(1Đ)(&w4ڕ:|<Y"(@k.b(U//92ɕ,qګRڦ2 kRz𧚝g"֦h)Wob,k?56@Vt!g5U bn50ϡt狐<]+ZWN9<)q}rAh-CFc6Tyb5?sj{nZZR25@Guvd}bIoyN7(>-Z3~)>^yG( $\5dCszvY_#+Kד،szD^j_mC%-JUMR|X.h]\1ǧfF]K]Fgj-?wl$0Y;[s{7o{>%XÐG˗_[E^} 9-kHc^a!u ҫQh8+VgtYp2 ~nMBD~ch>^4+sNo8 iW4$\5 8MԓC [qZ9!'@q NV|Uϲ/bͯ%N.^Ƅvaǥ ťvv[Z9 ,ay67c*'o@Rk:C!X#KuލJhmSZ;i`SCi讹W">VrYvچN+cb LBDBDwP|M`ΰKeW&gzw`BiKDGn@D5>=*җD'Z&wL9^]9f-) .ƢD.d(uN/U%{JٛcU wm|;GtWQ!!VJC^-b8%'+D&hBIpnER¥r@ J"oqSEF*aDpv̝cT7;ZI$غ>?s"C`r RaFr>Χ).1Ll.=irZZKoy w}h<@UO|`wO2Bxb3Us ^꠭zuye;ȅnL|i45x? Pkrj#srr#\tyz f!$wx_19A:.c7֛EDK Uo,f϶j!U$[x| '$-Gzbi5LJu؟Z07J64wO\v=L wjS-,(6(U&LkryP"+%sAv3z3ſ䪻V Cڂ EE .ni5ɱM1%O O:8!5=q6{2PhB09/_Z)Fύ5|V7Mrwj]b{ N2!c a@}U+|V %燠]6 :a{Xo05zaZY=ghx^0n6\V!E,3mQ:>rpQ&S;j"/J#\C,W_X:ٓ4]v[iwd*i )Z:6},:OEf"iHr|P]b i'_Zu9>!. $lwy1͚zݕXcBwܼFy8?vhp}F4{\^1,7 c}>7 4ik\d&;M)vȣYLJBܦ+$ϼ){#J~y3Yk۸ʾƗ21U[@β덦vSw(o{~M#YW<~6i@B5WmҮ,JXLQ]`wZFJ'rzJ(8P``()Y!/lsceE'Q*p]m RQ"č*(kT7bxCUpDJd"*Dz[ /# TCn\ƏD硵d,dFZ&r_m\Qqu|YͪKd,S`moλ EĴn0{ܝ<+Ch܇dpg^ר9t47E.|l(墽E^c/~V :=[? ˁzFX/%hqe6sX? 99[~ly!=*.AVx@9ܠ>9Z.P|I#y]Iiҭfm3nbNeavT&,ݻeHL-tIy<N4]*WN*Dmi')(ڝ0Yu:TV׵d5uu6Jw1!^S`D&VړHuh6XYs;? p^yN&gKjҺJbN0FLTw~oճѬmq3ř9yZ, "iX4Q@t`Bh_&⹘QHЏ?'ߡ`%+f:JgY,jn9as DlNZ'@}pUFx*kcg{*OA){]p u S VSc;RF>Qnu*yZYa޹fJxdS"UVo)U(/לw-'7FYL/.4rza5cv`h,^c/ppM 4S×Y ߠp@H-!7y43 y"?u_ewN4"GCk:@;} 81#bEDKˁ-⺬k~"\7]@2,q~9ZĐWd{xɒ[k^DC܎,0usؖ PKpYlo{I[dǷk>_xbHA^ͺw|S\YT͋{CP=11:` e -ƽ z㪍tJtJ )1hꎍ9^=ZWռnnn/3+)RW+_aXֻGk&q]tˊxXhdP9ш3_E噒 woHx| `+$e8W@0L /qx_SxS4FcΎ4ԖqO~ 1eLyﺪuP6wW6ZΣBۨs<3`@'3/ hTp2Dc>_L _[(:B5CU+ aye~Z cD(sΉ;`'耻e^%l|zaуm1&dFnr^ F#Ē ]*twrB06z7) sc%A~\-Un{~Swq/^$|I}7Ub-Tϯ{ޙ7#R‘c}e;%AjrYiEX#W#F~VFEDm(yrrq5wS.%߃s\ΰn]`FQ@x^KP^F_1-TH8Z}jB/BVCNҎ(:,|ޅ~ 0憈%(m[Ɛ~rC+R5qgZ^vδ0ZxՆsh;@UHCzNJ.܆sЉ9x]Y8K[>qki{]ΤElTYPMe6xrů!k-9cϡ-E-mʛj-QSTS$d(1o4ɣ(O"AiW #}F==h466#`Jq}+;鄾C˟ jY%. zRcQIjTja&a*j&MY퀗-t|u >ӛ&'{̾Ɛ6BF+ƕ(wGleyO&z5~e}hjG>vBC|l2fgZNi·bJuFw^qFMֶd8>[$%2d NcYЈ,2Ifœf{\EJWYr#pIX5ޗPȇ>nL.IJK}U+87QʤjiȳʒsYOlrڰ3h BmxAGDĶ l"Ife>un}M( "O)U⮔ޞN<>m#cTrŃ-^̦fiNI٫ Exisa)NFߴ;z;d4-mssJ-:{kԷwkDRCƌFH U~thV5T;p'x"RHU%/^ci{sOZB=KAmg*$=XxLE#A~f+yGY`XZm+b)9""OꙻDA51i6.I^M{rԸaF"jL7Ȩ{c7˅k&e}G*S24@*&M)Wt'¬57^ltVd^d>P)ܰᬡ ZuW&}kbkF#{Y/+s\aE Gaŕؘo@{CuyXODqG[ endstream endobj 137 0 obj << /Length1 1405 /Length2 6229 /Length3 0 /Length 7197 /Filter /FlateDecode >> stream xڍx4\ڶ Z%zމ c 15zo!D/AtQ# JH $os{[֞u繮=6'=DAB@%E@"NNNi@@x@hMu=O8$ IȀ$e@(7!P{B{HEĩt9:1u@x iiI%W Fth'+" #!0()x:n2B`WQW C;(kdg4!"N {@"PO=0Aul$W?ѿ !08#A _@0ă08:dc&3 sCP0l^ EQDSy@!}s.7 ak {O7aS1Eā 8 *`mt8`ƀ/" @{xBA;# A35=`>+ ~ _w#p>TVFE@HJ j!-{Ka.o?! L!?;Ry?~+ a']$F C.^-4%#т 1!_vJ7!N//aDÈ y0b4ϺjD%`/1+q?J{o2H4&1 ua0 33 9_v8@w2&#4ڡP(h""N[jWL@8k~ƴCLȩw|>zB34 Xjʇߏ{,H ̘udCfVVܩ.#${Eo_uK\lxǖl VY&ZW؏a gq}׭G^ diJDRScMIλׂR?UHOb/qZy(chegJ-Go={l7rM е8 er(scdԊ piYx ]׺3Ȳ3KqDm6'$DRC)KYF_MP1pRh9zlVe8c7ɱL3dљӿܢ%~ŒOM]=MO 2*5x٥!{_Qz~=LЄbDg +KR&B)xej7OB[ҥ'o&ׯ2~&PXF2={h$XNgeCw?Ml=(pmB!><&{:h LY&w:ӷ|4.NqF4dKU͉*K41V`V7'߉AVgb!n6~T+(ɸ#Ektq͂TIIQ'BE!6 iv8R4\h1-Q3 ᔄK2QB_ⵯ~Ζ;jn^Jqd+Ee" C+u[[5mHt"mizmOH s=Vfҽ\iYpVkA:FN,v_Kk&$*րҒ^p&/Yd]kC\ ·;_cdTi]AV]?_gDDO:h+?D;GBIoR:7l^ȡ*sၜHb515jpC1DYv z$NXgi/T LlpbW G#iIÎj߻pI/ҹr TYb^͡hzɧ)HaiTX>ox#I5Prfs40\"I U'w7הG^\G8p.=yh aJG0HsoЎsїJ) \`x l>RIwlxg-g _qp}:>'nڸ{lxsL>IW&ViC: e?_z`)eK(Q,y!M j':#* f23Ho\U@nƙ$zXN_XmszŴou+rO>+ c١ YN^exF_4H'lp {<$:zdKg|gv!HmLueP[:&e­r4T9CK%l3$GK >sl\wLP3ĞS7`[3k,aׄnƸ]G#j_2JM:Y7M csu4K޶k89n?M{YR{VMCA| #IDiڸ|^aނ'2,Eϼ՞ʁ _\WxN؈s.v]_bō}!g^V~j /}BދQRqKZ$9Sf|Υ&4'r@D q.>~AuPvҫ4:6ٯ+pPmFsje=ܕbRnz? ~:}bTo }_527h=VZ&nxJ?ߪӉwՏk^Zau# bB]X.X5A0ɾP ϐƪ>3X7%e@@wIN|H_f*{GW97nd$܏~Ԟ<y ̷)711\k}J\.D(7vo{+qV.\U>hY yq}wҲs* >'+ SioR)Gϑm2ks[A!{c%c5#moCǥx<> iл';:f1N^__P$֜ԻB^V>7l11l:H`G` Y%0M=TdRUzj.(rzTUDݮxμӒ07>CwEۼE1CQ(ZLwǸUb0;joCSjʿ/gyx؏#$)qjw-dumu-0;`IpSei^y'+8imXhb/5s-?~:qa֤#/;iQg|UXU "l_M.r2}7 q2v7 <0ʑZƒ)M)XNG.JDBe8T2,qAFmS<yarFQ`Q(o=[J@Mjh^Q~-#p[i:Hl͐K2#Civ$g9 Ooڒ;t7=QT^EbpuX~,KTq>蹁[cw'7zY%/x=HT#IwϙucxP`a7i-?LteAsCjzn`1jQ\XxGiTr_z&o5uDqNKj~>m[۳7yK;Jz%p.JZQuɂ6-3M xxى\|6 CܗE,5Kျ+řg],S {u iҚ滅|]wQwMHvav]xz3K{|앳u#%XB^‚^yčN; sm;Ky)Ϗ\}EϑkX1$kmĝI4;ORhFJ{,ЯfSqИn91N\8\\8vjip!/Up3F>9tc>M5̎[-v;t$սK}J EJ7b-uv?|ףu+ Ɲg_h-Mn wg\ *D\yG'NjW׊}>|_H^aȒ' B8l)WWz<>P[9BOwf7|qBc\¶(Z!t{iO7P!KIլnu ju hH} ݍg-kEo,OEnI-]vpA/ڑ3OzX:Q &ɴsOj* Mg֫3=7`=_1mRVste]{(y,ۗ}8K4I)骥&(iwؐT=S Gf nGSm˜r/C{NN 5 5ZjnG-O;nޝH P zwjua!Y(kz".Ec=I'AۍG^'Aڋy3ˢ sGee)X"ȳnZ WfM!)J2XՒU(`3)jA✚Zo<Ky*EUlG.ZW6o=N I'zQɣ|>P~y||0NNXA*$M}'(x*EœK^o*NQg0oa6 ҳTM|E}Y A޳^d{})$8?3$NqXd6Z_MQR]Y2]Š֧T|8K 5S~r7Qq\uMݱҗ4*73I kt>8FHN!Z[b1ПOfv%{PsHhdu{2 w&OЭP <+@VÈAO xd桉 TXp+>VlQ)Tf윃 ?^?TK! < ꗒzWrˎKͯ@<,^>h3D8jo(M!"*V%%C\/\J*:G-j^35-{1(w^D͑Ggad1HW?#ȶ>sm{"Ek+y˹{/ǖؑx?YnT'_ٲ H+ & Ȥ׎js{Scč,'*&W~S%xѲ5H}]`-kǫ4%t =CuM7Xw6pcK ܮ;u>1ȏKf꭬ȫWB_S7Y+t i /,rCTߑ:PzE듈CF`E |D\u^\Y^ָy`h؊fF'֩;w).B3gf,jT-gD36Fͱ=[m%&"\S&ߣn;+I^)q/bg;e^e44AmG֍]dN(E72KC2,֕r-*W*8uO\>xneJE8'˛cW)szrM.GjcͲq~p5ڃó>bDzkd28ǯT|fe< i=R0gO|fǿգi=-}.aB[UE'!Qڡ,{j;NH2%Qj¡5\Zf^D~LZ/F KvwNsoXNrBAՋ.FJy"nwFo_$n*n\^~Ч);8l'YgIl?X @оwscV&{VH `cg6xg[]6Cm8@p8qe|2?}kwx'V;@mfvG.q"b/S,xH l9d«Jv:&O,5h9B7u}[ٷ[vц/N$z?|/z,GBT~ c÷.hն֡f"rTԂ! CfeLDZAsSɺ ۟_}J.i=vUYr]|JݖۑLn<=}-$ZQMS|Jb F 5 _SH'.w X24 :n3wszf&XʛrZ7}w7PN!\?X -[E:y0 ׸ȅ=Wv#7+7)oGKL@ZCT*^u V!Ց9?lE^0J}8S ؉un>/i#q#/M*8> Uū pW:H@Ո>|9`5'%֎rgqI$.fXX$㕯o?G mܹe-OLl:#i/eڞK'bHGuزX],XԖRae\^ ||{*?B endstream endobj 139 0 obj << /Length1 1397 /Length2 6309 /Length3 0 /Length 7271 /Filter /FlateDecode >> stream xڍvT6)%2Ftw( 6`6`#FJww t*R*"-glu_w}p(AQv05#ʺ 8#1c\`a23;B/; a* B<\`qXJ,-@ Qr' PHGu;:apiee0w= Ѕ``\F{ eaʉzyy!4xK@8`h' 0@ H0q(.p{@Ba\r@CCw޿!(+#p@_M H/"Cc9~Z=q{2)M}RREnUYu1ZšuhsɐÚK w_7ۥQ27)oɓso,dL3)OqTmF{P—%_LD<q&>1'Iړ )>0kѧ`QO6NАM\DbRΌI4_iAJxtV6NtWEqRj1#Ypeaiy}oK/iQ.#0]\Uc5NV\0$K5kln5(~!䅞!w{sCfІ_WCUr9/Ƹ(H"Zxef6B9$jjOi#x(._F9. Qж33jξax zS\J>9&{mU PZryH3ʋ7lgw9+&tFyHdV#K+ҥeKWGۉ*ЌcL#(hn­Pw]Yo <"Z4z"c*AŧH)-f^|S40\ Ԍjd[A\$ FȬZzԍLK?hg0g2on<S&Iw ފ dz;),_\£~2a*I[~At.*T6Ϝ$TNP H6N|{YJ,;,Udb)ׅ+c8f2I7 迸ʣKO?E(VZ%D~[+a =4$ԯ1z@rk(gJ`' 뜷v_}PX^nQ+A E05[S2)RrJ|:N2T.9*K5O 9z[rm\>Gz_5gXDQղ>]);.Ve6RZ|Dr@e3tOV ;+6$M{~yJ{t"׳xc>s|c]y39pvmvźp= Lh ",UjlI-9-ȴ}峯%-4 "#cRwL^Mq6FxIMw##RI$yp}ݕV3lj`D̠zb(u0%yN:x13 >(㳩GEyUֆEݯzw **_%ѽy:n5\~o b^=Zh]"+|0/fe3=<롉] U[KIX˛ e 訹xc(}Q{2?,jr(}툸b2"K^O"Vq""S| lrOv#V ģ)k}TcፁU!B"w{7 cLr<5 +Ix^WO?l~ ='29*}Ԯ00<+dUsg6]0P KYdk;q9u cV?#v;vE}@fɘԠ{/)Mxxa?dW D x^,ԟH*'!\]}J %? /Q_+,Cg_v(93X.N6pOrH=)]9ޘ{Xv;SG?k@L˸v/hI9܄EBr|A>Iٴˆz{Ip*<ʄe)˃Zc2 W-Ud#%и6)|Q 5۪{?z-@_7t}N9 xnkm]35繱[7q xU|8Ƽ4V`E{QU~Q1̗@=)ZV% E;7dI6$.&0=ZmWJ>&8u0!j$G ɷQtB̅UO'u̳+eE)59$g.FZۈt<,_^lj}_+Z*pyߏڵ71"O!bOE{M:22?!ǷP}EN20,633Q0$M nscC7h}}UA< –ɏ^KN|W~iB4!EI(RWzVw\0J2sE˳o6rh;iJF0uBlse"}Ѡ/\)NrsZiC^n̙=yiP0nƤ̸N\ǚo@g.6 390 XiAqG;pK'L/>a5O6W[F}| ~Bnhqq@7IX>8)$e ĠUO.C6dR ׍a}RߺRJ_g_|K ':6s}QǷvyTrl>ƚOpnTZDU|Q+ة/S%%O9Ħz-M\Df=]a !lb^fQWoTF}rÇݞgzFݲLޟ;:JY9u\ٓ7U`mĮx2Gnǘ-TH"0SD&gkY\{ϾjGOrz\%usdi)BM"\[N T!ߧ I&g$j:Op*|ߦqT}84͑qW=#O$sS_eUe7Z 5;9.;wa J>mg>dU[i{NE42ޑ% V6DgÊ,o47@% s-U&9o(8PE 74j>VyCB%=hle-PZxȰmoK=?zѼH?!09x?k*M7syE0e9}#~v#>g߭l-fa!6+>n$wmq M=o2=ŽzD\TR$/YbOm,|}GMvcVuW=fㅴ\Y&Q.%,HVӣ{<뾺&!Bh@?#|I2YJ}nC_(NYẤCzB0M2g`uU/ V$Jz+5|r:p$[iI%CfXCX i Y#*dr' ¶ʴYEӦ*z^#CX:DR0L-Ĺ[h f[CCmX|UZApxs VV^v!Krчž) ׋\q>{ՎkY0a~,SB1ASys 'Gw%&>w7M絶PU/'VI:<9^xTVbC >9E_7u cb?~(<&F]y\MW5Nc]-ءm$ڹeJZ7y5kgm7Ikj\X3o5P,1g (F2}Y2׈teM^gGIt` cwlƫ1ﾬk[fh+5޾.kQejdS]\32ymy/EpnAңaFb3<;r#aV?R|.HmE7[=Z+Sʳwz<8|xW3PҾ'PS !~M= J∜2gg>)ri~+}a@%.~"*ȹpx3"ot33֮Qz\ûȍ:QwQO2p»cny˙̼t-gRf氆Xɲx°>5&J"g#xyzXe {|1+9J#qB~D!ɑ fـ!G>h e]Y6Bd]fʍihE 4efɝ-ڦ'pnlXͤ>znN;ROY.pЛuu*oœtIlH IKC$A \}r+*qM&]lB6/_= ƒh ;FIЭQau­2#%ОyS|BMGre$^QWnۏ|E:{{Vo/VGuBrf_qW4y#9as-{8"1dQ 8aUɕ`1K+*jT"dejH%iK;_a CuH1EE*6&ډM>.{Iu![&:;s4yF|tOa=f$6|I7.3d] SnٍHaiW<5giP[uxGs } w^#~_csmωӰTi[Xyѝ0$ZNһUW뫞33c^{Qyy_'Qܦ,Fu T}$?Ha endstream endobj 141 0 obj << /Length1 1374 /Length2 6070 /Length3 0 /Length 7017 /Filter /FlateDecode >> stream xڍuT-Az{k IPHBM:A" C.t)"{s㽑1o5k=NVCA~ dj&V@HLpr"Ns8@!e@ `q1uG!:@1,dDe/ /A!pt# ]TqP:p;B!@.+,-qЎ@o h ^pa}3!' 7A9`!h8pE@H  ́&z@w8X@ED_(A"@+hpOOB_@+xA{=# Goz(a( j;e $L Gb1_#p(}ܬ {@~y !pm!?1G8(=pI_a@w;Gp~E{w+bpG0wh iO-N^0?+|ODĔTUQ>@A1PPFB(""-!j#P@?_{- g(j@$D_]_"yNioNXQ8 jcZ}8 Ym,g#N̂"B ?q3D`N$'nj$Az@u?08]NqH( g@ prݷΐ0o%(,t@UDT( 8:h4z8n;C3(\&o|mIꉖrM=wһ9Vy{ pedɐMGn|3,FϢ`~~#. 8,Hlt!b"BSlj b-tQ3aUcX9b[P$Pf×cՖ8SEpBw=b{]Ւ 4~:y)} ɹ:<.U#iIl /" =]3`kXC{X mc:@Ws7\BDZ6)gs:k< ߕm E - Ɋ}j$dr|;[UaʂAerbT|jk#c-ᦑ\L!S3ε ķ|4SGɻ{1BVFlbgY %&6"t ;/]՝EŽJ*:RzW[[b5"q255p3]W8u=oAUO-]v~tM ^@X:+O4u?"/ȕU'Q57D]A*T%mQ<Ĺ~KzA@oZN8%Xv{C*:%(Ko WK@,ukLuKޛ!K#s 3T/;='|\H,M R3DP7V;8uhc[O{W^\*vbZ)r:9&f,HJsnsH>(l)GV٩*-Wb8DX$.5Hj8RP$t[Uh"ab0D+sccnA]|Au?B SqsDܪVҎbv'H2(3k)qw8^yIwe%f_m:($䄾-ArU ~H~m"{)"Zjs:֗8Fjb%0 V5{Q|^ E9cnŮa ϗVu:n uۇ<lIi}Qח^7E;/ùCصJN[ QmXZ+mfJ8S(7tg'6hi2?^tU1d<(o[!)!ˉ/ۭ6v?/PURsOǜrG L9w(Z#4J5^tYӭ$nH޺43szcEhWLQ@j+W(0|dS;Ԁ7= =% X\K^t+.yza[GvSoMng5OQU/msqn+ʹz1 " "@ߗ=/^9΄ai%05螓, z$e>01ѓsL:O.*9|T[z#1GɦvckβPb Zh/79> YXZ0> ayÕUzT1",vpW-I˟SkGSUGZgTUy{t3!}QhKw/vbJgeyO؞kH~dY$#pVBTJ#mV77ea361'pYjoS #${hV#UhN3QƇ_C3T;C9KnoЩ0 9^V$PVt7(@ǒ4DoNjؾ6^kԥ {@sɠMaԛ'q&O=˾JՊd>2,c1峑#wJ2$k;NUh")qۼE1Ϫ"^TevZz^-,}pywq@ȕnmx(SzEBE/û\ȄD^rzk2F=lDj-$Ϸ?n« ;Gzy_5g[bsY8֢; (504QD谴HͫAn)H:F+WPHiCF,BQ3W>G.0&#S.4ĶMJ0YUu]ˑRͩDž5AP. bRP4P/;TT\5Ĵs5;u16>yl|17_|GZ%FyRϾɌ?PdP|MxG8/m tnu]b6oge& os[_Y\T2m( oQF?x^j#)~ 6bP(blD"qI6wG @Z N96bSҬh䪇̭Ԁ&gPT|I4\9@^/͘hآ]ѓSM5\e3y&$t=n^lBnY찏OTXfX>X.xʧ|`Vv>H]8V^ \݌Lq]`FžHI؊P8ez+8[Ku|8D\fv4T1_x00JP}Nt~.-O3lV QkW-NSmIyF dTW/^kdO ,g+ aԄƲkZj]??wu\hRWcn7kF?Z9*خ w9د$K(H$7"WЋ~i8q|׹3$ l(O|\O}^C#ہb7UȯH;eT}| KI0SHUqnί|in+V빑dNjI(:dbۭ@"rZ}6Jwחf4 }L4Fߒl0AUFJd^K'=Mms(0}wǺPpKhfe*$kr?+'Ntv+Z}5Io}&˥ߢ.e/ҦdwINc(j7 X R*#%˥`\npjPd&٬qb,Ll!:]}p?c "y.%v;I'7cU[eS"7na&6^-ENefxk}C [/wFlo>'rb.Tjz`ql9-ƬP2Lhʌ@WauۉGuOe}j1=N4r򈶂5Uhm"H;i\Aӝ~sk{өbKS ->do%$؉1|#<+[صZνB k8 ^;%y?* :k<3P%l*efy0sQT8%x P 4c5-fQ;RKlfBVe@c*9Z.m#s} Q"k:K*wdTinOivaXl L?wS3C_se&;>#y iژ@z]mFKt< l*(o1fY?U)l{00el Bf-hY]^ o]nnSEuxއA hEe(ݏT"ٓy3i:/E]BcuM|(-jnzw~ Bq[7[ =uRv?YGeٳc﬽Tv+c]4ļ{2c`z.ܞIhv$IJlQ1N*[(T,x2~F|`tq%w)J/1b%V[}2ܯp(qAtOظD*G A&S%ZbMq FA hS4(VeGS\D֒ +,w ٛwUC[SsC3W@\0yE10'ϯaEoGw*iu{bal(Wo{L -e̝;( ̙uUAVg]OGoߖ!l ґ<+wMb#J1ECuoAJIHḪ#/9sPʨQ\ww[!{MˎO S>}z \~h-[V H~SUn?QS?w=jl\}ZA_nu<,}5Ŏw7AS65 ˆIսbMJA{OXҽoeJ]Sy7yq7LٛHJfO_yVLq;|if*nOefXZ?5g!i+>4X 2'zĨup}v  Gԗgڦ =gw{a `~ f| ƻ͖JmӳʶDxPfǞ ]3{<rݙMVL1M> stream xڍPҀ #50www` 0 .!Kp 4h 48e9{ykuzBM󝸅H򎝅M %`cdac@C@#\\t!2) Pf` 8c"-,G+2 ?zs;??/q{ PBÁvMGs0?K YC N,@{WG+fb \A?JAƂLвtx]@W`rFh+T@+e {s,]o?; 47ww:x`;@UF a,0ڹ:݁`;٫2kjve^YBqE#?) u߽X>\[G%2,ܜXn ym^EȬ@7 y[@ k ~>NN2@~`K+|_BfgX!3_ ˿]l`'pt#fUf*%$=>88\]G ;;X:Ju=@0w-itC6n6/.cFɸGymڹn)Pv|k ktA`7_A굣߱sq%ʀ=Aj`_]\y;]0^llG:d涯kkƕv0wc8y@Y7u*-@63x`pXEV*XKVRzT/X!?`^s/^#CK ư_cXZZ _E_,^eM_?:}yVkjNyQpk:.خWȿux _S\\^?G 'y~\0ئ6ZZy%4zgAԜx層5zlƫQZ,6}ǰ\8~+r:XX4j{\M20;mOg 6V|>Ak8dAB D njjv=9J|+w3ѻP ^O'GsRI!V4LluJ>^7s̖;;ߊװj[I\<]CiFa,.U#r>Yț\GX {If03R'c-"L5 Yqs X0DAP916v&ˁ–. 9 ȳ@BR_!Y~p^k kS?'c.\n(Έ V>]I1aNCy]̇6tL*4B9w1kl9ԴI:f\'NXs~L>M} y]3dR7cl"V^7*^[]~ETw >UF 3 zu^^SV]28b]_PAu }jXY ||C3,$íyS$ @tC:ƶS#FX\nY.bxL\l"6zꑽi=wbFhט7HzڂE,=@r^ nt^vu+/ɢo3V~ya#lҶ05bh\x 7vv%-1#=)ͅVUFҰ.I}^c u>>[p@L`=֫-Ra`Q <ԉJMDM=˒qsk:'stTߕЙQx&3Nqx r}_ "hVFupWi'V, -u[ FwFpmW0f{9p:0WhIO{kzu4; éB/:ؕTT$Zy7JdVS?448L;S >˖VZ;xSAg lz>ou_[U6藈2GɄ6"Q("@TR)ϨZ7 %PҘ>^g_3?2 xxbE50]8_AA a2]rǯ^=#lN?4 X< |{$h3t;MSVXq|˔~=}!= 5K]"ĭV~w'gҰ1%9rקRѲ{rPW`BH%7)"ԣyQ~NQnAyg i}dN~h;g9O"0W)툵 ⪣v倪B{x$HP? {-ŷ#R1[Y,, ˌ(無լ|M}VI  TBF$8-1ѬtV ܸ 1>'ȶR$7yk]ͳw뭼*WFӨP+>k4H_]~;ӵ 57m$'?X[iėRROwVOk^%[%'Ӆ{[bG%䔿{ *.P XnjHn@Owܪpݮy::ZO`1؁ԒE(j–HLJqy<p$lBT AjV#( şyi4h~-۔ |"?ˬwFV'I6욢}EzÊ@a N{  őfpZdViJhNg%;]" %R+lbkƦR@.\u. Fa5m.nj,v uU\ӛKso~o^5y5KGCnya^}wZL<-s\\(rZhY6%_OZ DA,h@v7,<А{7T1L *-keC?<2ݤqEeHP&%}Cw 8|sʗh-p`%mNgKr{lwTՉk狅ZZZ~!HNϡf$p3Y3ulg-8&PEn5+o9(UDz\HE/O|͖ϝ@4H# ѩfdeAPA)c<|M~ˈqMǶeX  hձۻ+d9_[ʈ )i*`HLqAoRm=jqNE%Mxe%Ќ[+?]'Y  %r[o&;pK@Em,E漣[w뵮;Pt2`YZ_fEDRBzqWcr#7S("z\$=S#6m缦x'32Mr6~O&j@â!Zk.ǻ/&;aXx1HES a1|L&Q~3] xyjd4&oP4 v+ۍ-|po^`M!ongPb ^.y8;;on;Jܮ.62ax1庙]̦QxeD)Y,̣Ke>OfBO)WGT@Ǥgffd239W--c1½DvU˜ud AA0fO֖eG86=DEON°; bF ¹ brf\FQk -βKԹΣ92o0ezbOcNkC"/.Tmd pa/Yty| G1iX0f5>nǰ{^-9X[T> )xHߎ>˿D+՝CDr5+MS:ax#m(܆䉨Z':X6Njq/o_>po~/O;UͧOښ\f#kyRD%5uޥŠ;s`-D.돈ڏ*.*< ٔc*ln2Z 7[ejBs:QR'BKM*uU{Ӫy9)`ZD/ Jq7$l `:bXsČ66^}oI1I%bKksw.Y\s>Ͻmm"Xgi^bbŴB=QoJ>WyL{oam? {^LM R1GְeX /OwFHz`U6`cNU-|fD\B c, O=$R lU$*o-߽2ւPd_iWl7DY}C:5?9;wT)#KA5 NI7QQiĹZ +.J\4l3!my]'XP9we lR}nU1:R,λ^7}R9&,*F9Nj\evpRWW=8o>8-Ba$|i:| Nw2)'^xe8;sAwS( ֹpZ2/C/YaM IlKAQVޕn<$喝+p't0Knrr'J/p O..~298vCqzSw.$DdHkݯx[Q, `Jxk~/x]i"tʊfÎW(̞۩W}j?Y,ss`I5?Z KS%>`/HQAu ox~*ڝ@i]ŹeYq23y2TAǺLE@6i?a) ({Dx$%y*i5F{s`f2/Ĥ­Mִ- nk`ҨT5=vb' K4Otv6UN`WM.-[%Ǝ(t`$o$玳T*MٗF~BDs <3ttqJ P'ΑIfxYC\>WZQ¬Q-S%&k̂k]ozz=yYj(baj/-7`ǯMRZyWj PZl}2WZT=RxP@ڡ E-bM'JVf=_=x@GB/6 ᷃3A*\x9IMgh`|'.Gԕ UӛԩI)>>2ۦg0B7_w$h]Z ̐Uj N;S~)77O%1fWh֛2؎bc0{ZPa-C'ɛxgi7S/İhn j˂z 8u"+ *D`==P(_O VElrr,ƅ20,_Dei]G {Rz+HwɭkXi2[YJqw`3"e&hdT ,27jThMq1!H-4RE29AiZZjsiXSsʑjTf%:p?sAu)Rf)CP|1 5D ǡr>`M˴w/HI\O7 kaF y IRodrr7sMBLhQZj+ 7SsE^3- /*#^,X}BmR#ѭみR:HE75Q#WmXfng,Ԅzۀ!eY!J@\̋00#TB0c<5E-ꬠ eyGDCWwm 3{>~Ol5b0KV?Hfv. CsT$aH"3\!hX4Z Ѧ؃d[icBO{GPCdȡ$KaӕGTۉe1]]Aqd{]ɯvKXL'^ ?gd|LͶRbCB%K]/;i*'t$G'%wmBk!b/_mʑpC࿦c \[tSͯۂ 58&,m},)fg&Ҡ7s 82\ĔVv CRͥ蓰֢֕;Z*Ӂ?B#;iB.Wا.<.Jh!pI+R9sC B i%MxQTG[' _xǑ~|}ߢ"e)F  &_f}?|-234tM>Cb'fJU '9ZHr˳ŝqG霘' FDr%)cM[ulM\~@fJ}oCB~ $f.)r)C]>DGpoH?qi> "N9xVlaf Zdb,EZ?Z]:rL!G2!z,h2C<;\KkF?'m}0t#2j3 NL~#:͑~xAKo= U#Qd }h6y/L>q#0YX)%IޛK*jYGlD-S>8Ua^obMֵ:NS,u75Vuz [וݪv/ G '4^ r2P T*АQoS7ʔ) U"}I+P3b1R9M<!۩)h+$]`cCvgXv-To4B{}& &ar8DȣhXgrYrNdvE:+1-Ĕys|qHlf`m }wz E8a;˅L=؊ 4ߌ,a fPDž*jW, ?@zG f`y@km޶W$ +ۛ=g} Y% ɟ:(^pZoa9+z!s0^Ө!8\Hh,Yȅ\-f="f䏏Ls$dvNfa.Qxmr,Nm f` C. 7䣖 _v3הID]^*.>`Z1[@`!-},ŦD$5"0ڒ<qwW‰xd:Bpmf. EbjZE}`Hlij;re>C[#i_!p,WlZ\p"d7O&=";4dJFw9<{2}tg3Wnr/soѭ+E[>CRSB16jI:dȴkHs=` 8ְ4[12'}ՈmhUN*80h֘9P~jScҞiqSlͪա36O Ykɯ'ދl79b:Y5@\xeC2RLYkDё]:/@jS9&f㧀Tg0EAo?ІUtbd' \UlXZz|YgV+-p%[O$~:ײh 7(8X]MR;1Dg_K%QKMxO`ʒ[5 Zec;#su=􋩊v"XdWdyۉq,P}CK3NĦ_aEc Q[LCnJG\]^OQj2(nσ7v*oW3?s/,eKO8bj%1p ೏|c.7jFF ;v\3DUPYc}F%}^Rp"$` uMdп|Ra\x>?vP6gߺ%l =UQܺM;IfGOW =^#kd<8ޥCiԒ@0Oԡb'tmCcBMVÊWvxA"+uu }Q6:|~,Fپ2N"8|Țuߖ7u6n 6٣9×5ی65sAIlLQլr`BFxBx E=91MU.m$-ܝR- ħ(z 8JaXX=g<">1񕹆]UP0,S&(^m/+Yh@{~Q"7MvF6CYt^;ўy]ye Snq46<~z&Ǜ1D"UOC+ h4 6YN`x:S4mWpOV}>OYt= :QShYIT9>@%TL5FʼnΩ U1pSR!:/xni#_|~ԭkT#` vLO?$45J&ZQ7ͱ[?I&%e-:2)2 eSh MpswFU [_'ȴCl[oRrr{PG" 盡NAIS%8&Uڗ(<,{43x1JR%(%3R%÷Иk%4nspHK33(>1cWP=crbe8.# %T+tmԧ9+ 8zڤ MVE_M*/x ubBy|`oB#dU`kI۞Z7v{ڻd$*Ogf.zk`=-.GJ`3ɲwz~JſG2QZeKrs"KMʾ7ƫ/0()~!̠҃N|GG(ʶC+'g2gL{f.D7|n,@ڬȒ;kO#* e$/F$B]euZ pjCu'e+kxmޓ*OH}p+kp ų9NBMDe$|GAvMf7iƒb׽LceBԈrUi$uIzt Sӧ)[ - z*^!v&jR,#,5wH(#kRyG\WBŻXgH;*57~ġ |%'>z;p/1Yp\'67s}$mksMݗd->}uVGo/02x[B{VSOp\I%lV \)^(J9xoQ?q;,lղ46# FagfDV0]XF/W5We6`ŽD?;`vNu@~9cx#d3$$AJZJAʘYg'?Y¼K O$ vG(3խ &B3c@qwG&}Of KBӠ{ӏ1XFt&Y~C4_rf Y-b˕ЏN*ܸDN7Y%Ӵ԰?$^1ZZFkMCH\Nyxmy-1P'sUjNRnC]Lʘ0h&%@zrj+,7&RN*ooUiө{t:i6$w ZG BFn`ZcoVĭ@߁rd0AEhCGz}$\{O, A^ί+u\y,"==!t٪V /BpEʦO¨ YDr*(J>$WꌾP r>z+"g3eH5鉂iĞ9h1Dki0*b\c95( mZqd oz`ۂb.3{-ƛxT٬BJ4~,Vl6_43=DU?3i)3U{S6 G ?]]|n0v`FfU 1Y,FY(m[hdRwߐsIU8^ETuQ=gƾ(GtEP4ek\"?wŦ;U:[ЩJF7q0=uH[ۉT,\APKx}X&Q<dbZ̝E^p]~Z˽U3 rLu9>`+ߚ7Lbmբ&߮¨Q Q|\q|mCL$]vX}zML'GAf$'W)F7Y[aג#{˺|&L,y>$&Ym137r (E9<ϢpMtN%`lk:OEg~Alhbh߫Nj"ޔ<!_Ph#iRŨJwšcuq|""i`ˏnݭ?9x~rN퇟S"o̺V_ v-o;nxZ+'ٳUcTȳSF+ ,L]>.p8D)NkXL5<q=M>m@dB%eU.uΉ/ 4NG,w2܊|}Q 0C 744.$N^|27ϣPo[gj N6L6Pװ GFA6ڳa1_2O%V!4CAh6x 1r M%.&LEB5% KiYYphOW7Iq;9rLU8^lFcIjowD//#LC٘OӃ~Y?$ K> O=TX/R~_}Yw=&}_y0"rZ긮?:w@]+f=ļMOz{!#vͲl&!J[=c}Pl]394:r*;.z∱ \'[M0GjI̵tcfn֙9j =K:vY^:6`Bhwu FG,=cJ m;_)x-:iaPm{ z5O\}JVbCExۮ  -w]"7jj-*~L3Ze,yB:r}S2[Ϗq"I@/Gge͢R$ϏWL[O#I{Y%."/,+T+< |[&pAQWh`H3ŸYDE zC8>d=f! D+ǧ BEmnM1 %mD,Z8ˍ{OO4*-D3ΟM ix,{$4pϖCv|:-ZX{2& ZC v`ܘ'fΞ n[=2}sj]0kεL6 ]:d@`z3Iu SDD^xp0QC1uJؙnlJw~obD!#9y)2kpL%uzB1q.0Vd*f endstream endobj 145 0 obj << /Length1 1974 /Length2 12809 /Length3 0 /Length 14028 /Filter /FlateDecode >> stream xڍP c\;-NE;]{qw(Zܝn=w2YwP((258}`f`Ȫ03XX((T@NV(Ԁ [?,DNoONo6)g+3+ _C['C @ ektsw;W1 /w5dlh5t2Ze46(NɎՕڑ r2(.@o9Ck(* (mM\ 7hlcte(K61= @ m mA6fS /&D01mhhhob24z3tC"@vN yk5w}@@㷾3}66E 4LUm@@OۼLLL\,=fl;/%ooO;[; 7h898=T/cfF@3 ܿ@wƏ7ݷ 3r#fWIo(mXXY쬜nFQ0]6֥P4%g6@cdyr7㿣H/=  +-mdm6@J:킐?9܀& 'cf?b{f*:~,LLG\ƖoHf15d,CCw8Ibagx2m !02:yLm~)'Q/ `qeEFQhh zeeG[Z忮\F[7~ke01r)~og  ߐ9όo2b?V2`7ۓ[vڽoR*s2t4-ֿyu;:Y%?[%?%? ׽6=&@719[c wUBv?NS쨧|HSp#8ԍ%J}-Hy\4 0?$TGKAEpKC"ޙ I!εWܭti4dnGqCLJ(H8NӢ!\LeMKyGxj|X)Waq%!FOž,.\8D6G5Ar£-#d[|ܻ_6cGiUL6Ch} 5mjLV'`d\Ӫ +̎f۟A܆NB14m ӮȠ~0SJ.<ç<]^tS{'nOʨtւ`edMh:'tJY^Rn`{ص)9  (û~iiZ7Y]oˈ ;1vL:82V{ML2) AUI@ZgX-S/aG x5=[⭜~K_Mb )RZ}W@ g)1L ѨصԸw.#>j#,p#'\Tid .:3v}֓延䏡żȺ &ڟ~p&`<(%4_JTNK"M?;ݡ̘$we,O`Kߐ˂$>J >66i<)vP}̜$:q%Wq*'FLOI į݅XA0z$f{,9lYMe:UKS4S.#D4ZKoČ}?XlBcǸ2#D=ݍeIfw7|F4)Y>9LoֲLwz݊U NGĞAv%*̂?JS.9%p#]}n}%#_Zhf.[m~ce8/.8ǀUO .Kj14qMBz`lؗj",uAv<+*Kth|k2v=j4hˬAǩ*O"6lZU]ZܢYs36cٸ lq7|62L:5LōD\ySm;a e,-=aMߛ=у[xQ~$;hH7C~ÅlSw #ԦIy2u92mP}2BI34"2'j82Tb?bwg8i&|~W pn`Ja-iH ft3uF3WB3:+(QܪbRhv#;CT!&f=rVeBj ⱟx#x]?䨿Rj$]C/` qmՉ除 I)QshP=a#Ɉr3x_y2,^ DoBjJI %M~(Sj8-f; B80d6D1 I'na ?sBi닀`hc^# l~W[cmrr=Uj{%2;.9*Ί<+Ͻ EFGƘ;*0'HB' 2Κ|Z^\]9m@߀6f [t#f&Y@mNAr"#YhM4 Wj{ek4 -><=ppΏ4 8,Q:t "IBEF/6GdV>T6ywI+؀&zg]8֯DT];%4I1o*ngfF&y6O2"'!);J|<=ƌu79l57_ ;Iī, z2f!fKĨٶosN/o*6Ʉ}yɵfN F=(&c8n9mhRkSswAӝu_K=鶌Y; x?eP1BmICg W˭ ]Ϧt@M_3YxXb"EK]>pRBvHp7tD'ow8^="0r;ƅTo(`~ӂ[NR]J?{ m".J3y*.̡Ҋo$x3!T/XЭa_*KC~At =iθ$REWqtYs Z^wuz|ԧ]A@.q=x|b}Xd:2RO"GVn{S褽R53T֜*iU 3_edvpޚ0}aӷB)J 0 [u#0q84OZ&1"AŝllwL v'/2gu uՈ w  ޛ&w%TcBd1{?*5TA:-irLZ[G-VTfHxU(wWU6Ȯ;`:Fv:[KkSAHXg_]$~5UPRTrT S²& L1g̲ [g^4 sXh<׊N竲cˊ=hGJvLhN-BK0 \ۜ qpX ;{>B2*_:^mSIAn [ 9JlB"tl-᠔LឳvxPv)~Oz!J]f&[WSp':ݵi$)C(y1m9Ncdv?l)jN%yv-7=Hp=MIm7sB% hu:mKky5ta#Ԟ"ނ=֬z zmhݨ,(H HmebPdiw bf)5V fx~Ac/}(D'u nkEswɉk$쟕W 1#ϱȈBaC<1sQQ[Lye) N~-N:*k-~X=,@cn2)sCKx25Vs tc_) YL[QD>0C4z, R:xK7Q)ANp\AuHXR1rv'p>VŊܫt{dow6`%Vqx ymP<0 ,1Mi(S4t;$BÂo-Ccȷ]?܇ggH>2W$ʢJ~MjB&2U220geUsYL$D{BI9H1%mX@L֒]˶vc86ivډx7BX}Jvyʖ.(zdJւat iQWpˋWp LЁckV1HHD8gĬ: d%zp5bL@rMo9-ժ;.ywN =O"&QHrIwv3RKС8YSQ >.7$l|($_ҫ>!rӇTT3=dRd+|ɨbdKT;2n./;]jVSou ! |H.҉\{dϫ5\3|0ޢ_X#䐣1DV *4D<^^r0,baҝ!3N6ƸL3h`c9|~i:6Yc@ob>Z)%  F.FݶX9fiN~C89F6.ɥal6#)>^Z/; ߳;j7CŇS)Kw `vqvR=fpHyu;qP)k)n#4'СlxRF| y6BK\ ?t5[=2ۄB~}uW9ǻ/Tq*\}œ$3c)!ςڃ|]nH{UxiUљѮJgg :vėCwuzHD*Q/@B"# e\VU&obJ ¨7hz/;]=4#܃I0ig9V553hW7Nl:C^P^+k]Qv0cۃK]e!1CO>)+2#Eٙh_t)XB6tKD%X+<,+JG8=闄~cc KMH[%!}?P>a[r 4ycIE3Hzb^![='^b&kɦZTgi7vF,F΋D5cڎ[|\zGh>ڡnDW<{׾Ȉ}L5!el݌/}s\U,@"m:80يOx]| 79.k0>G{[V_0 ǿTg( #Hi?gl9ʫlׄsESIm#)XX9" Uz76okUxLgVSPkȸȴSKZŽ7.v KdU9BP,S^\`LCmӶRctپGj uOBဴRGl%Z*9:TQӫa,5QJui#^9$A_EݮAM6/A|5 NDvn,s 7F3>njKU*cDw~#Zu=mk!PU b[ 8o{xR:RVB]S_OCS*NI>5P[5 &SOQzDIG4;ڥ^i8XdN^0>@]2W& $)6⧽8$K1(Q1XvX7tĦjvòG%x$1!QekwW0\j*a" rӕ;:V^cC vFhX\Ua9|O/Wyc [C\CЈ&t7xAt |g^ AeZRQ3ŗ:hOs3'n.m"7iilp3FNb@%s gϩT}{E)pV%Aޏu0~6/2 Sě#C냤X8gI{zLi{bB Iĉ}cg]HrsH'+M C5ߪLдV .P9xɂEBމIC/~D9qۻÁqFQkgWs4Htq{>(M]xr*NVc;r'ٹ˚GI]INkIs+#'\Z!l>ePN%}+9gPy&uB=9;6|_Y`/ld%>mBd:| q9X)C'ҧ|Mփ:z"G&[*0}Wk#$Bu RzJx u>yaWH=c/ 7`O TlYj^n☟GJ|p|DjbUE(7u$3:M-UOc.F_O ,ȼϣ/,@_H*@:bAƗQ-;:\Z^{r$"aD# 6d^6i}]r/ ]җ ,fmk;zRI}ӋPJ RM՚KvZZM3)\N*QK93Ljjd9=}+(JJ΅ޑl </K;6,LQsPULUm8TH%eRpuӗ%O g39!6t"0ׅ&](tm"n=M}kfudsrq +<aJ9KIR2i 5̧_B" "Z?VD|^'IMDNI@O/a; RN`~Xoa|`jbr;WЎz=?5WK&$S/+]6˞7Rj; ZܔIin>Cq/[DbdW2m ȂeۊG7ze^6:ˤ鈴K9Yc-Qy_՞=?u]`G) ?ʹxccS{2Q4s%ȅf$LkϻG@w( _Љ*ڱ`KTի#=O)W9F-,Zqv)Q}1/)mroVY@^Ѿ ~QBW9u2'<ىwG(W.Z gSѯ b8jʎ[~RF0^b-rLKpq;S?& bD|=6P\E' =Ui!L|7$dsZz"l chՖV65~Eګ@9KiOF[W૙D؍9! 㳠Ic@re ƕB˺m,S>p/j]&̦J8}Ç8KQ8:Lyz9u+9cP|rn ( >.`4IIG6ud24} [6s{jZ%?5+Z_, N3 /%~p(+W;'=6-*Qk|&4p.zԁdRJp񒁶A΋V #u*t5e%F<'> <^jTFioeX׵NPɮ m(jR[4Pz> G(O7D5~DP(x'۠_~u!ק p6 KG;n2-UCG'h]Uiyw\I@T%o+r qboWq/$LBK FHoCjJ;Vcu8.sveZ]D˧۶L$]`TFe^7=ow͐XNĥچ.У9j]P 4al.GZ6p,^M϶p%O*{Q4^3Ż=CłFk#Hd4'x҅=)թ11jv)p&0Wo- 2IϺbQ833:3N?ґLtk&,ʄVбޣ~$%t endstream endobj 147 0 obj << /Length1 1453 /Length2 2038 /Length3 0 /Length 2966 /Filter /FlateDecode >> stream xڍT XLmFRhڛ$4M:i3tάMI$Z%$-$!!$B*kFdT\9yyy~s>fL. ;bԌJX/(:BD_D* DX,A0@ 2Қ:ߚB4 =p b(,!Y0RC:!PH+r 8,MT*&r9 01)#p #O( D D2xR9$ )2 :qq^BL*p&C&H";I!5U!p@8`u82O8<#FR I3emv@,,, F?{D s}$n(ѨA<\""b?]>>, ŊNrH!<* QBLxp4ƒ!J@*Q jTE8R :yC6~b$,gC?GLv\i2<򏠝̨F74s`ɰѿVaCp.(f]p0 a~ἅOXP8}0q\Ye`pq( D#pʤ<0\ Хp=`." ="p-0QF"G$)'dCn? 1 YB-!ί+:@b1ILYX(*F.1Hb@&Otр #52$E$Ƞd9짉ӗ0-Yc ptWL,;H'|0,H\smXea;~ [&s 8m0FۆFhjE%97#w+嗎ټyϧ>qu:Q^\0=z]i-PvhӮ5+NdţHiZ:F!+ԌW 2x.;J1ܨ҃ ?E9}0&[>}aөU{>Eq_+seѺE)Sq_LQyaDwF-Οunjwkf巔,f~_ݓγ;M̜^έ,I^i͋_1+敌خ?v8Pvs*)N_v"sڪ{zR^!t˜5 N[BS^;߻PԀpl[H#vꪍ-ӨzוkNjJ(=^@kHJ0?}w˹c%L5Y]0+%PbNC//ZlXnGiBZs 4O>Cc.r5()|\-*c5G 輯MpZ\ȹ+_m)fUz[|ZsUKIa_?7\laE۩QjVeS Ν֜zj?\QWG5.0tXGU7|tjJlvҵ׮립/IS.!b#BٌAn E鄚3g ‹7 ³-fyAqwǿZXީzܥc{i^*ҡuߜGfXM[y6;7N&Ħf}ޣ:}wl]v)]5lM51qx4Oz;]<5D*!fh>Teh"ҾRʧڴ\s8f-QƖ-z}۵xiqk2r&f /.d!ʪ$'@1jQg3:n598Ԙ ,Bݎ J)eU,?Ϗۭ^xDF/*?WuIQcM}=zv _0Սy^D:}aV쎤s6^ Ym4<8WwG ̟Q\b)%peA&LͮSQP -7Ʋ^0qtՊ*O/;O3.acK"XcewkVOz.r{w6oۊKR4$֤=#eJr&i$G#{.ux > <,)ǂӳRu[3w|>Zyxԓ_7xmdt>YbynVd.F}`ZyQ:OҘ'B+ҕSFR}EQ;9)9smEQ E4n(&;{?i=9qu^[ endstream endobj 149 0 obj << /Length1 1723 /Length2 4505 /Length3 0 /Length 5574 /Filter /FlateDecode >> stream xڍv 4}~ [ YJYge 5cd3 }WHDd{# Kdd-}C?Μ3\}A~kʶ8KrE C AA#4m ^G hVP* mj"9N\1L.A*w /!ж.aQ*eO$# `e'D`]D>pH4BDB"'(,D{E@P~À 30H0G~ٯ$ 4%3\(<@>\uFa ~ _=HF 8'gء1(આx(  GG! 99P6G@D/Ceu* %@x|_uHXobE4~MlPD@ ^(ui/o:p=q΀ 7Eyn(wEy{v`0$6[h,d3& X@ڃϟdy ԺbtEGW|**ۀ4 .!)HKI2#пI@_\ɗ7_kȚEBH* E`g_ ib0nF81Ȓu%寋#/&_+E:׫ID@{  m>?/aX>0(?>^! Y.ym}:/ i#AP$OymQ @Xpx@e/ľ$dȐDalQ2Rd3$/COr#C@P$u}90 ?F> Apqȅ" #Sd*WE 5 9$su;\I_D77>x]PQHP? r( z|$>!!شNg2 @U~{M2=|Pw6|{uA"g);j+!\}͔W'AUbVZk{}°#|Jee/ygp"tXϥMy;EHLCB@ }0|Ҧe۷s:KzEgNJ,JE Q2.4.s`.TQw/JOѱi6nrgwJ3ukJhyܯ )4SrWvgcZRWX, rZ6/;]tqNOB"_t0k)~#8$9>H}=_rdFHgpբMlQ_42>+,* SY!s#%%#N{*kw ?wǟIٰl\uGдUPHK-O iOW^<OM1` c䢊JB(ܻWHia7 j̵3ӚIEڥo<Ԫ ]C%vֹsŹd/=n+r=b.Y\ 8_VQ27]*̳eerc&hLEgQ Xa(Ӎ3_F|q|&谸4T M]`]%5͓;bxgaAzltu c2RzAeTU;sֵ@ eeeiݠ--wjz#=Y-< 9cc8$E(ǁ\Lϕ-) 晬VD>߷ǐJ`)_C%SdVj#*;Uq{[&}ŝv֬VR~1!w _:E)K38sZu7.)`+Z?,:C_cƐVZmNbK*3PATHJy5ma7F)e6eKtvEe.^FɍK`qaidx)Vէ j.w=ek$^qѻ8L')/M/&z<3ʲ;vyQ;XM;h+{S|Y1END-~T8Q]i.d|ʷJ(ȉgޢ~Қy,i H楎A'"i"hƥ0Aһ c`k/iB|$i.3Qo10G/ ʃe4VWkN`s{7ѥnD3zsyteb،OT&@J6;݇hGoQ[ɞwxjg)EؘvFչ8†Յ;?8ElrsvK\>7XLˢXy[^Gɲ%7O0i|k^^fI7f{o?BԩҪ zjԡpWKRo3:;tM1-dt׹1>}#M] KX>ch]q3I#eRa4p:yT|]RR<,V[lpTCf~z_8y}Xojމ8G؞hG([Iϫ>֠k˨^'MI7K񔖫R.^Ny?f} k<{ob?ӱF; D7Ǩ%eѯ: JoPaTc;>5pI#$W'PN˩~ u+!%Wg[UDHL̑XLSpj<ᆂ۸~n6F'߯ˢ,U5ǒpJEr(XlsrzO臄/BLj/\!{>.=9'HBԉuzNΤy&bm{Gas7aKܘ#^Ld3q>hR$Gdމg7q4#pBT`EVb ]k úԍ~;IvzCAFhzIPꕍDêO͏=ie`p{%ś'Ľ_⏧;0YzpxA}A"`msVsB~|3_:maGS#̞! O[FRN!gq#7Uj 5KS7;"6u ;^S5Xb4#}mfxά'6u12R׹G1yGw#WP^}=.mjB+%%*\vэ2^hY;2n~5]zp4^dsܩT0=AN#{lNnڀw WL4/QTgCK1\(p/"{!cL'p? K 9QspƇukNJ.%@*9?H?%sRbi6U=~u.{}u(5*<1ymbنƍ#WB,W'ocV'=Mڪ;3>?,(NkG3Մ9~JuJ: .HvڇGwAZ;JH>J}^T#?{1CqT5PŊ oN i!OOe5mU SX}A'CK+]2ITGP\a@g~i/vyܡdeyVD\KQЃ aNu9)$ P2nuwJ(Qab,s#ϮMs>2L#;4owEQNBcgD4Jw *B FiL?DE^\H߰&_k2l~0%}p1QA׊> stream x[sH_ao!  lăcgmpsZ`̭*nZGKQE]ԅ/*RT"BB)\,zPB%Uhiu1IB_h%_aׅA/b [ K#GAX]pź'zPDX$ ,3~^S g ]G̔R>X:m|0lj@`HxS0-1GHDybokH&kT{ et3 N!5`r} 'yfy̨]APՃZb cA,6`-Rt)RDk$`Uxe4:.N":d@z !P!&ëCJ lmQLuȋD}SbGR.!'qUڀ$F=ӤD3z2@Kj[ |ʑ3Di`5LZ9;aQ=MaӬ9'R)񏝟^|n͗;Zdz`4X?_/Mȑfk&]~Xk[99/&}gno:#7N`|2Oɱ bxt2qyϯQ3|2o-ʹ}QEh8OTG\4ErpT&y3Ewf6b-r0J+SBSP: Gm*֔ +D-=El nglL98d:)?];(B deh ,04gXkܰ(Y]kk蘣ܿq7"]]}R~B߹\l~*|#ܧREH_۰ .ndٷ[XQf}ܷaeBJjJB`Ԇ //TKF TG &\|]3'.)02UuL*u&SifDmDջB _Ze4ϔ705TѮ vwi?hvN $x(&D!*]gĩ\TPXX !/O6r$6|D@oq3a Sp||-O@ӥELȔ5 ׸G}p0<9EUq3,Aq$HѡZUIHY9|ES : {nt&_Y9:PH1ݗ*C S9-VA#%ȓ4{?=wiu;t u][ 6u( EIċEj#IErwN29XKJ!yU6"'pfhNP5r B;z&;8EEȃ/?aOʭ}j]&m^^] "Q4;\9C`hRM< :<*? ^wVUe~% - Rڹ3k+]ddr[e~/ƺshT$'|ZH,kig{O8YOď;BSѓA/(HNv9ȜW!3"%0pk+R=[[$B 0m_Za:2x 27b"8:8 }/dʹX l#lK2dW5L[wLCHULn!VҀ|ZҶ[t"*y5,pfL1 ($N<ۦKR1e8EY&lSɴ") r>vsE&G[s ߶]޹@mcĥ5˯[>ִO]CE{|rN F[y4Q+#Ʉ 3 %?q%ߒ-VAn:ݖyɭ !NL"}ʇ|kO:f1(HVϑ<$ćfyf^`l|GR74!>lfU]nOKZpc"#킧8QNo aعK^>7|Me=2BTR `9a!4㪎>.xiדym]s!X/n\+wc늑Fuszt-EEmv j>.yH|`A&`Mسһx9<;J~F'!K%.#~ʲ82oY|@B=lf|2Qx{GoƃtVXϟ:uO $옾t OnߩhzvW`4<ީTTo$Xl0Z?U1|^Wՠ:NX}~er9N쏋f\ Qu^I57EuLjZͪk5gӦ_&eR}#='~nz3VaV$f $w;RY`!kDփ^KUJSW2KdTY~fz;0/Wj*~|7ƻnf#K.TBٟ_X_Vu<Cg a:EFy۟Ph2F{~> i3?޼j' +[kMWE0(1lDa]==rVr2odM9 j31꿛dUf<}vqcƊK1ގl]lAOg BǗm5h)fCk 9\qeװϻcۆ_=g66d)Nљ.X(1"iGUo_¡[ћhzľ*Q['=>#D(zV_AG+"<շC%H6~g/ZO}t ݋zWy|_=) [oO'[.bاX/9{wxv/ޥU_!%-v+᛭{6Qԝ}:ϪQ⫗O1y=^4?o87#dpzLW9>zzL򓣃a-];YC9s:SFhwMLC,Y8%k++JzNVmkzs~pzL^1Z3/r>8;IRܺi3tbUd,U>n> stream xڍTj-Lwݭt7 0CIwHH7RRҠt#H+%ҍss_5k~z~^F: mikgK(U@ #mbCDu`pSuv<y"܂"@ O@ r9;ݱe]| v0xXn+@;;Zmg+_%X`0..///N;+; hn`k/5#/fX;_vmg +;<7h+]Nlܜ;W!d d @uN7r;A d =9 M st@QU~NֲΎ`';֯ n`+puN^N/.\NW!pֿ6[0 x`WʎWyoo3 N|A`77bXm!NXV6aA@_e7r)7C  3l ? ,M@+Ww (9B>%_NkeU*@5vsw7Z-̺V qk8C~)n |rp=vk坬e/5\N0x `B\L /K_$R AB@?H^'ܭ p^PkQ V ~!8r‰epl|.? ? WFo#䃓qɸ& rc8nx M[y_߫g [a}l%fNʋc{B|q[?[-z*kmNȺەtpʦ<˥~[zd{fǝ߽yv}Aj:R;~~zm]=4 o+">nk <ǾӍ5 .c,̝'GqPc<%:Ɵ%z=Y"A_ /Vtx{((ȩ/Ʀ|e=#[-+]_r",:X]qP\` 8+Fl0ACX##]f|fto9UkBѨ>eO1ܯ>BUiڭaSkȵu=B1ɳ[.ao6hcZyܐIuWR>@|S"}9Jl> 4tP.垎B׿.~`UȪ x&w&™V)T*Ei9"VtkΪݢYɛ7O2Lwpӵ@Ť{CW3|Bzbj9ogV:G;`@К$Ϙ<.S;Sa@X>$ӁǟSEL?%P8L ^UiŸPBZ)W}՛>Ӡdsmet¦oAQ-FInr鶾5k4i?E1W2}IDFTVSݻI%lrw*^WE5V)núN}kJOdžocVTliQYfEFieML;߼yQz]dbsǂPE\6B=VN'N?6򊘱:B &(Du`X{hۛk -9ZYM> !m|)<N4m(xB4 [ z{F>P/,oSv"nBga%;itG97Qe]t" L]̰>[ru:ѣ;§|rN,b^x\G'0`p'J,jHM{iCI窑ǻuz~]׷^7:6{Ho?A[w e loci?KD =lGS+3$/$KXu/ yqߓɕR&}ƴbĩo]\}&+^[!1 2R.3[F7$W\ߥ$m1i!6{`^fzc=*w$ޢXj&qk]ϰ}$~$_}W}JI06kAgLc`S3a@-})`uCT<*Z:, kt|֘qQj&2Hݯۃ˴9ep;DCg8u'ËsW%'.WQ'`4_iK,/:8(ʾHc^1Ýo1:F#(n2&/ޖ_n*5d=KJP).t4pbi]OB@~,0yRfSy,V%G}Qiԧ@&fp c⋍B1=ePʛxO)(`LFXaT_%lbNpNj}~׶nY"_= (.6徚 .W,(g 4vHuj> ?-?]}f"ryd^7L+<8n錒 ϥ裬 C7DVZ_+d9{lW}!Tz^uwWN<:ιf*u<]Ǒ!c[+1a?xQ֑j:w';x WgVPr+RYB˲4G?&D<:O YkOdsCGʫ:2<(6k.O"^VG%X 9n>{ `/gPW>2ڭ7x)҂wP_/zu2yR=-ےZ2YUU0dCuQԳғ~)s(9" gq7N]eQ)Ӎd๘%#gג+|p6.B~bS|5OϽn4-I!3y !Jޟ=y*cLGV<; ")y  &mj~FcƜ \ʙRFdBur|E8v/k-_"ϡV}df(;|Sz& 3yn <|>* tB!xeU?H7x]{s|7*{oEu2H,/`~HF ,~Ov W "o17jM90l^&8v1\'5hKsdLs?؉_}PBWL {`9PJyX!܅aG,Lbo1/".M2inWA]ê]v*7&L/G9x2FQGh1SN)o^Y7h&#k߷O%OqBcʞh|'"8 <{5sDdJb!\q0._6"|bōO]g%]5kSAaˤY JN4-Y4rgL LD Dwھ>2qtT >:{'dDmA6PN̍Fq;cʖ񶤯ݽ6t*KZX•)"``c} o%s(k&?}C_wڢ6tU:m@F#Y?-ǥٙ V_PH۝6L{\!(El~SN}C5TOVk;sb #X_:ݹjvTd.*R=grhۻ6Gp^+}W'plʫurIf[$I(˜MrvN_sJYT} ߹WFPm=ӣM\8[?=+Q/ʾbH9,<l@BRd0t7?C~rcr6\lin?!U? E@T'뺯LJ5e^(. l-"&Ǡhm oI( (i)8JNմm-س؉}xPoHA02N8R1/ܞIRk3UC8Y$\YlxTsl}:sQ\x ۱1-5h=b9C235ݎ>}`stWO,X:_LUT!ξ{q}\ih6wVPxC/zZkGuȌ9\j$O{OHG|(|ֲt 7nPa0 #N4%m_ N*O̤^xm$E ax9K "O ]#lf~wyu*QVLSJNI+e#߇䫸=x7ROqU[U9ze0PSY,;7-R+Un"1kYk{ؐ2ϧΪ\mz;601ӠQ:N0"UzWm#’yYY ;NJ 3YXWAIDži_cmt3ce@Eؕ݁N3啅% jfCo*y k W։W5'Ht.8W"28zʠAyb]ڹlycS( 15tϝU;i4Nj%fstմQj >+ٞ/CHg$T#{``1L/IH$ګ}O@J&"QcT& SU{;s?")scEaG^a3*yJAUS;tdYKd-JD:Ȑre kU-OZP5l j<ا+_SR+\i{3%*ݺԍJL4oz{"[0 ɣl#.3M$*GunJߚq3k|!0%IHkJ )#Xzu;b(( O4IկA!OAi4TmH[}tUE֥*XiS KAv|U%sT* J̳U_Pn5wіSc9W8]AM+F;W FWb@-Ė [ a=1jUZP+UQ8o/-紦["½KYm15Ō lyxȠ/'_\ }zI:,iT"t{1!Uc"j&^Zq aD>F+<&N 86͎@Ziu~qM92Ɋ)jN%(e3 1Ɠ.h5;v2lEjR;=@[V? ph`߻ <:5=\Pdȟ^oW:f9Ig3;,.B&go/%;e7W~jy,XD3[^XwJp5%8o͋f'"yA ztr̅ TT WOl|Q'\a>Zt3E^t[?dP,OԜGAGue!^zy}}i-ru'xVm"QȎsNݟSG[(A(vR۔Et Xs;H}-6iN# 'L j/6N~EI8d8ZFt.a.G0@[Eo+Mߩў9NsRh_͚Mֻ%SG͔9Aj8Xm>;Sf{ 13.tӏRjgn`r 2CNMP+1 "@ rjT7̨>?nq(Yrݘw[>RNXBQl؆}MZ9ɂmE8q7jf^e?cK$TG_(_XWOk52ן@Sٿ.O*(pw/%EIDz+Qx~sp9yRO4OQK%+N4Z׏Ab?/~5ΑآQE5tVAaO%g v(5dVpv ɓ$%k73F\|Oy4iz8țRoI=PЇQ/7E5"C?8,}%rgp60THo5f֝n01x*2JpT84Eou 除h75XEoW|6rf|eMT \ BbL/NqF 'Ir Jv0`& A~Mz}^hJqIΡ{.|r_Q}:N MOb16%wx{8yi|J|t89V?~| | =;X?JNhzRKJFIG1;:W|xd!ovٷW¸mģkD%X\/\k2KbW?!γ#.QXp=]C뇖nMw\ytN l [~7^S{Ӵ7U3^}HB$O$o;>U`&[˹:mj2ewnZCKB$+W#Λ' [$c`7f)Wu'!Z-Kd>oZŦD?4m59"\#;Qx J;̝Пuu-C;X,qD#Le'JCj"N6 ctל`pE]S!]"\٢7l"ntzc)PD>4n>)z#dMb^isp< N0,\էN㎠>1E. H++(WfZz O:j[GȖh CW{NAR ,Ԣi҃LB`[V{Uu 9|4aEO){ ޴ r`lyEp" G&T;HR1d0̕bnրDc K՚XҸ8Cr(g -(1]I7wqL[-vBt½ĒkGO@v)վrvpc2as[E)ڂ,XtS`,iVr-DXQ݁ivgpROݟ2LrDcxm1*41Qu >IGjb(Xf1f {>w,TWSeԈ$M;ƞIk.GRe0D[ =M&ObGl8*j1ԻaX[UT2{N"f,3,d`k(i]IBk퇸*bilR3m=44E+pNĝpH\yho]yF)9m}6ey+AQpuؕNm }&;p[ꃟWWS:U6twL.H{Dž묧n_ҽ.^\ˌqWw]3LҎ{ұzeT*XCG_$h46YH r3?i>V2ϜRtѱ`܌}[#޷߸yeD:IW3aHOɾtxusP QuSժEWإ):ңW$vG,ԉ$5{߂%A"lb}0Ӿ7=s"5(4i^dR.nn[t0'O) e|`>"ɶZje˹e=0]5w,v&0,R/zܙk4o5$VMe#*=p-᥎?ǧ{w^4 ʯ"m"aFn؋:v@Q'BhbK7I om;Q2E [0(zi|A3Sq;|k[`FԠaUFӛ˄>\`6͋9%fMbjEpI7\7,,tzP@06}j/-v,GA#lJ 4ksWGeFCjM\D1?ky@l-yOK^fmZ:Ό2jmIޅ gvgh/~&Χ$Y# ?O7F2[ގn"}D@8)n' ("$}1.UThQ椫ߩ1@nq\2SZ ov^Jt/aIpWSWK!rsw{;­$2 6rᘋK+$MսW#ʬ?= oE =FaΉ'-9}Ӛ~@t`j_'rUecʍC«ո"lX#e$5Q"բރbE6YL0¼,옵ۭ-āD%"׺(rU*1|!Vg:䛧VԒ&bp*\"4FONv&&s>1Iy7FIj߉n֞_rFsXFFdecAȷ}*.g\y[9K!pHEJߋH5K+ڱ].\Ɣՠ+> endobj 153 0 obj << /Type /ObjStm /N 38 /First 302 /Length 1283 /Filter /FlateDecode >> stream xڝ[oJ)1#ޫm5RB>ćX0N\@wvfw lP#@ l P %HTɁڜrRce.*lE%< m$>'z fsFȡ P¶x J8t\?11EnfʀSlhqB ڸD!z\y j枃M:=;9~h^g5~d,=n?SLT,TԺI-k,T(,J2m&q4qʢ}*"G5BM\`M\uEsx?Ql$@r'N^ pہ4u<\,<}ȴ(\IIJup3pl[rSK_NgodڨKw8X$aKpg"K؊+c"hWrK"4Ja>̝VJ+ˣZрz5*)[M2T }|8O w S ->W&},?y 6-#DVx endstream endobj 163 0 obj << /Type /XRef /Index [0 164] /Size 164 /W [1 3 1] /Root 161 0 R /Info 162 0 R /ID [ ] /Length 420 /Filter /FlateDecode >> stream x%ӹRQ 싢" * ʦ( ".,EqjILB9!w^!\UVYe"g7]sfϙ13;Nf<~7R#9$hVK)FpZ5)NC+|8m. nP;O*bhVE*RK ʡYRT.ՋnVzޡ4Fmr y]74%s{Ki0y0V0tF̥]p :[ MwMn+8&vC/ aQ1L$Lx UUAYJ/ܶ+^>Ps*ͻOf^TZp}OiTSgw&V{PZҲo[J+"yKpO# YgjNV4E endstream endobj startxref 205556 %%EOF octclip-1.0.8/doc/octclip.tex000644 001750 001750 00000020227 12540021550 016102 0ustar00topotopo000000 000000 \documentclass[10pt,a4paper]{article} \usepackage{tocbibind} \usepackage{hyperref} \hypersetup{colorlinks,citecolor=red,linkcolor=red,urlcolor=red} \newcommand{\octclip}{\texttt{OctCLIP}} \newcommand{\octave}{GNU Octave} \title{Clipping polygons from \octave\footnote{This document is distributed under the terms of the GNU Free Documentation License. Please, see \url{http://www.gnu.org/licenses/}}} \author{Jos\'e Luis Garc\'ia Pallero\footnote{ETSI en Topograf\'ia, Geodesia y Cartograf\'ia, Universidad Polit\'ecnica de Madrid. \texttt{jlg.pallero@upm.es}, \texttt{jgpallero@gmail.com}}} \date{February 13, 2015 (version 1.0.6)\\ June 20, 2013 (version 1.0.5)\\ October 1, 2012 (version 1.0.2)\\ November 21, 2011 (version 1.0.1)\\ May 24, 2011 (version 1.0.0)} \begin{document} \maketitle % \tableofcontents \nocite{eat-om} \nocite{kim2006a} \begin{abstract} This is a small introduction to using the \octclip{} package. In this text, you can overview the basic usage of the functions in \octave\footnote{\url{http://www.octave.org}}. If you need a detailed description about the Greiner-Hormann implemented algorithm, please read \cite{greiner1998} and visit \url{http://davis.wpi.edu/~matt/courses/clipping/}. \end{abstract} \section{Overview} The \octclip{} package allows you to perform boolean operations (intersection, union, difference and exclusive or) between two polygons in \octave{} using the Greiner-Hormann algorithm\footnote{\cite{greiner1998} and \url{http://davis.wpi.edu/~matt/courses/clipping/}}. Greiner-Hormann is an efficient algorithm for clipping arbitrary 2D polygons. The algorithm can handle arbitrary closed polygons, specifically where the subject and clip polygons may self-intersect. \section{Installation} As most of \octave{} packages, \octclip{} installation consists in compiling the C++ kernel sources, link them against \octave{} library to generate \texttt{*.oct} functions and copy this \texttt{*.oct} executables and other \texttt{*.m} functions into a working directory. The automagic procedure can be easily done by running the command: \begin{verbatim} octave:1> pkg install octclip-x.x.x.tar.gz \end{verbatim} where \texttt{x.x.x} is the version number. After that, the functions and documentation are installed in your machine and you are ready for use the package. \section{\octave{} functions} Two types of functions are programmed for \octave: one \texttt{*.oct} function and one \texttt{*.m} function. \subsection{\texttt{*.oct} function} \label{op-of} This function are linked with the C code that actually make the computations. You can use it, but is no recommended because the input arguments are more strict than \texttt{*.m} functions and don't check for some errors. The function is: \begin{itemize} \item \texttt{\_oc\_polybool}: Performs boolean operation between two polygons. \end{itemize} \subsection{\texttt{*.m} function} This function makes the computations by calling the \texttt{*.oct} function. You must call this function because you can use different number of input arguments and checking of input arguments is performed. The function is the same as in section \ref{op-of} (without the \texttt{\_} at the beginning of the name): \begin{itemize} \item \texttt{oc\_polybool}: Performs boolean operation between two polygons by calling the \texttt{\_oc\_polybool}. \end{itemize} \texttt{oc\_polybool} includes too some demonstration code in order to test the functionality of the functions. The demo code can be executed as: \begin{verbatim} octave:1> demo oc_polybool \end{verbatim} \subsection{Error handling} \texttt{*.oct} and \texttt{*.m} functions can emit errors, some due to errors with input arguments and other due to errors in functions from the C\footnote{The algorithm is internally implemented in C (C99 standard).} code. Errors due to wrong input arguments (data types, dimensions, etc.) can be only given for \texttt{*.m} function and this is the reason because the use of this function is recommended. In this case, the execution is aborted and nothing is stored in output arguments. The \texttt{*.oct} function can emit errors due to wrong number of input arguments, wrong value of the operation identifier and internal errors of memory allocation. \section{Caveats of Greiner-Hormann algorithm} To do. \section{Examples} To do. \section{Notes} Apart from \url{http://octave.sourceforge.net/octclip/index.html}, an up to date version of \octclip{} can be downloaded from \url{https://bitbucket.org/jgpallero/octclip/}. % \subsection{Geodetic to geocentric and vice versa} % % \begin{verbatim} % lon=-6*pi/180;lat=43*pi/180;h=1000; % [x,y,z]=op_geod2geoc(lon,lat,h,6378388,1/297) % x = 4647300.72326257 % y = -488450.988568138 % z = 4328259.36425774 % % [lon,lat,h]=op_geoc2geod(x,y,z,6378388,1/297); % lon*=180/pi,lat*=180/pi,h % lon = -6 % lat = 43 % h = 1000.00000000074 % \end{verbatim} % % \subsection{Forward and inverse projection} % % \begin{verbatim} % lon=-6*pi/180;lat=43*pi/180; % [x,y]=op_fwd(lon,lat,'+proj=utm +lon_0=3w +ellps=GRS80') % x = 255466.980547577 % y = 4765182.93268401 % % [lon,lat]=op_inv(x,y,'+proj=utm +lon_0=3w +ellps=GRS80'); % lon*=180/pi,lat*=180/pi % lon = -6.00000000003597 % lat = 42.9999999999424 % \end{verbatim} % % \subsection{Forward and inverse projection: \texttt{op\_transform}} % % \subsubsection{With altitude} % % \begin{verbatim} % lon=-6*pi/180;lat=43*pi/180;h=1000; % [x,y,h]=op_transform(lon,lat,h,'+proj=latlong +ellps=GRS80',... % '+proj=utm +lon_0=3w +ellps=GRS80') % x = 255466.980547577 % y = 4765182.93268401 % h = 1000 % % [lon,lat,h]=op_transform(x,y,h,... % '+proj=utm +lon_0=3w +ellps=GRS80',... % '+proj=latlong +ellps=GRS80'); % lon*=180/pi,lat*=180/pi,h % lon = -6.00000000003597 % lat = 42.9999999999424 % h = 1000 % \end{verbatim} % % \subsubsection{Without altitude} % % \begin{verbatim} % lon=-6*pi/180;lat=43*pi/180; % [x,y]=op_transform(lon,lat,'+proj=latlong +ellps=GRS80',... % '+proj=utm +lon_0=3w +ellps=GRS80') % x = 255466.980547577 % y = 4765182.93268401 % % [lon,lat]=op_transform(x,y,'+proj=utm +lon_0=3w +ellps=GRS80',... % '+proj=latlong +ellps=GRS80'); % lon*=180/pi,lat*=180/pi % lon = -6.00000000003597 % lat = 42.9999999999424 % \end{verbatim} % % \subsection{Error due to an erroneous parameter} % % \begin{verbatim} % lon=-6*pi/180;lat=43*pi/180; % [x,y]=op_fwd(lon,lat,'+proj=utm +lon_0=3w +ellps=GRS8') % error: % In function op_fwd: % In function _op_fwd: % Projection parameters % unknown elliptical parameter name % +proj=utm +lon_0=3w +ellps=GRS8 % \end{verbatim} % % \subsection{Error due to latitude too big} % % \begin{verbatim} % lon=[-6*pi/180;-6*pi/180];lat=[43*pi/180;43]; % [x,y]=op_fwd(lon,lat,'+proj=utm +lon_0=3w +ellps=GRS80') % warning: _op_fwd: % % warning: Projection error in point 2 (index starts at 1) % x = % % 255466.980547577 % Inf % % y = % % 4765182.93268401 % Inf % \end{verbatim} \begin{thebibliography}{99} \bibitem{eat-om} \textsc{Eaton}, John W.; \textsc{Bateman}, David, and \textsc{Hauberg}, S\o{}ren; \textit{GNU Octave. A high-level interactive language for numerical computations}; Edition 3 for Octave version 3.2.3; July 2007; Permanently updated at \url{http://www.gnu.org/software/octave/docs.html}. \bibitem{greiner1998} \textsc{Greiner}, G\"unter, and \textsc{Hormann}, Kai; \textit{Efficient clipping of arbitrary polygons}; ACM Transactions on Graphics; Volume 17(2), April 1998; Pages 71--83. There is a web link with some example code at \url{http://davis.wpi.edu/~matt/courses/clipping/}. \bibitem{kim2006a} \textsc{Kim}, Dae Hyun, and \textsc{Kim}, Myoung-Jun; \textit{An Extension of Polygon Clipping To Resolve Degenerate Cases}; Computer-Aided Design \& Applications; Vol. 3; Numbers 1--4, 2006; Pages 447--456. \end{thebibliography} \end{document} octclip-1.0.8/inst/000755 001750 001750 00000000000 12540021550 014130 5ustar00topotopo000000 000000 octclip-1.0.8/inst/oc_polybool.m000644 001750 001750 00000017343 12540021550 016636 0ustar00topotopo000000 000000 ## Copyright (C) 2011-2015, José Luis García Pallero, ## ## This file is part of OctCLIP. ## ## OctCLIP is free software; you can redistribute it and/or modify it ## under the terms of the GNU General Public License as published by ## the Free Software Foundation; either version 3 of the License, or (at ## your option) any later version. ## ## This program is distributed in the hope that it will be useful, but ## WITHOUT ANY WARRANTY; without even the implied warranty of ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ## General Public License for more details. ## ## You should have received a copy of the GNU General Public License ## along with Octave; see the file COPYING. If not, see ## . ## -*- texinfo -*- ## @deftypefn{Function File}{[@var{X},@var{Y},@var{nPol},@var{nInt},@var{nPert}] =}oc_polybool(@var{sub},@var{clip},@var{op}) ## @deftypefnx{Function File}{[@var{X},@var{Y},@var{nPol},@var{nInt},@var{nPert}] =}oc_polybool(@var{sub},@var{clip}) ## ## This function performs boolean operations between two polygons using the ## Greiner-Hormann algorithm (http://davis.wpi.edu/~matt/courses/clipping/). ## ## @var{sub} is a two column matrix containing the X and Y coordinates of the ## vertices for the subject polygon. ## ## @var{clip} is a two column matrix containing the X and Y coordinates of the ## vertices for the clipper polygon. ## ## @var{op} is a text string containing the operation to perform between ## @var{sub} and @var{clip}. Possible values are: ## ## @itemize @bullet ## @item @var{'AND'} ## Intersection of @var{sub} and @var{clip} (value by default). ## @item @var{'OR'} ## Union of @var{subt} and @var{clip}. ## @item @var{'AB'} ## Operation @var{sub} - @var{clip}. ## @item @var{'BA'} ## Operation of @var{clip} - @var{sub}. ## @end itemize ## ## For the matrices @var{sub} and @var{clip}, the first point is not needed to ## be repeated at the end (but is permitted). Pairs of (NaN,NaN) coordinates in ## @var{sub} and/or @var{clip} are omitted, so they are treated as if each one ## stored a single polygon. ## ## @var{X} is a column vector containing the X coordinates of the vertices of ## the resultant polygon(s). ## ## @var{Y} is a column vector containing the Y coordinates of the vertices of ## the resultant polygon(s). ## ## @var{nPol} is the number of output polygons. ## ## @var{nInt} is the number of intersections between @var{sub} and @var{clip}. ## ## @var{nPert} is the number of perturbed points of the @var{clip} polygon in ## any particular case (points in the oborder of the other polygon) occurs see ## http://davis.wpi.edu/~matt/courses/clipping/ for details. ## @end deftypefn function [X,Y,nPol,nInt,nPert] = oc_polybool(sub,clip,op) try functionName = 'oc_polybool'; minArg = 2; maxArg = 3; %******************************************************************************* %NUMBER OF INPUT ARGUMENTS CHECKING %******************************************************************************* %number of input arguments checking if (narginmaxArg) error(['Incorrect number of input arguments (%d)\n\t ',... 'Correct number of input arguments = %d or %d'],... nargin,minArg,maxArg); end %check if we omit the op argument if nargin==minArg %by default, use AND op = 'AND'; end %******************************************************************************* %INPUT ARGUMENTS CHECKING %******************************************************************************* %checking input arguments [op] = checkInputArguments(sub,clip,op); catch %error message error('\n\tIn function %s:\n\t -%s ',functionName,lasterr); end %******************************************************************************* %COMPUTATION %******************************************************************************* try %calling oct function [X,Y,nPol,nInt,nPert] = _oc_polybool(sub,clip,op); catch %error message error('\n\tIn function %s:\n\tIn function %s ',functionName,lasterr); end %******************************************************************************* %AUXILIARY FUNCTION %******************************************************************************* function [outOp] = checkInputArguments(sub,clip,inOp) %sub must be matrix type if isnumeric(sub) %a dimensions [rowSub,colSub] = size(sub); else error('The first input argument is not numeric'); end %clip must be matrix type if isnumeric(clip) %b dimensions [rowClip,colClip] = size(clip); else error('The second input argument is not numeric'); end %checking dimensions if (colSub~=2)||(colClip~=2) error('The columns of input arguments must be 2'); end %operation must be a text string if ~ischar(inOp) error('The third input argument is not a text string'); else %upper case outOp = toupper(inOp); %check values if (~strcmp(outOp,'AND'))&&(~strcmp(outOp,'OR'))&& ... (~strcmp(outOp,'AB'))&&(~strcmp(outOp,'BA')) error('The third input argument is not correct'); end end %*****END OF FUNCIONS***** %*****FUNCTION TESTS***** %tests for input arguments %!error(oc_polybool) %!error(oc_polybool(1,2,3,4)) %!error(oc_polybool('string',2,3)) %!error(oc_polybool(1,'string',3)) %!error(oc_polybool(1,2,3)) %demo program %!demo %! %subject polygon %! clSub = [9.0 7.5 %! 9.0 3.0 %! 2.0 3.0 %! 2.0 4.0 %! 8.0 4.0 %! 8.0 5.0 %! 2.0 5.0 %! 2.0 6.0 %! 8.0 6.0 %! 8.0 7.0 %! 2.0 7.0 %! 2.0 7.5 %! 9.0 7.5]; %! %clipper polygon %! clClip = [2.5 1.0 %! 7.0 1.0 %! 7.0 8.0 %! 6.0 8.0 %! 6.0 2.0 %! 5.0 2.0 %! 5.0 8.0 %! 4.0 8.0 %! 4.0 2.0 %! 3.0 2.0 %! 3.0 8.0 %! 2.5 8.0 %! 2.5 1.0]; %! %limits for the plots %! clXLim = [1.5 11.75]; %! clYLim = [0.5 8.50]; %! %compute intersection %! [clXI,clYI] = oc_polybool(clSub,clClip,'and'); %! %compute union %! [clXU,clYU] = oc_polybool(clSub,clClip,'or'); %! %compute A-B %! [clXA,clYA] = oc_polybool(clSub,clClip,'ab'); %! %compute B-A %! [clXB,clYB] = oc_polybool(clSub,clClip,'ba'); %! %plot window for intersection %! subplot(2,2,1); %! plot(clXI,clYI,'r.-','markersize',10,'linewidth',3,clSub(:,1),clSub(:,2),... %! clClip(:,1),clClip(:,2)); %! axis('equal'); %! xlim(clXLim); %! ylim(clYLim); %! title('OctCLIP intersection'); %! legend('Intersection','Subject polygon','Clipper polygon',... %! 'location','southeast'); %! %plot window for union %! subplot(2,2,2); %! plot(clXU,clYU,'r.-','markersize',10,'linewidth',3,clSub(:,1),clSub(:,2),... %! clClip(:,1),clClip(:,2)); %! axis('equal'); %! xlim(clXLim); %! ylim(clYLim); %! title('OctCLIP union'); %! legend('Union','Subject polygon','Clipper polygon','location','southeast'); %! %plot window for A-B %! subplot(2,2,3); %! plot(clXA,clYA,'r.-','markersize',10,'linewidth',3,clSub(:,1),clSub(:,2),... %! clClip(:,1),clClip(:,2)); %! axis('equal'); %! xlim(clXLim); %! ylim(clYLim); %! title('OctCLIP A-B'); %! legend('A-B','Subject polygon','Clipper polygon','location','southeast'); %! %plot window for B-A %! subplot(2,2,4); %! plot(clXB,clYB,'r.-','markersize',10,'linewidth',3,clSub(:,1),clSub(:,2),... %! clClip(:,1),clClip(:,2)); %! axis('equal'); %! xlim(clXLim); %! ylim(clYLim); %! title('OctCLIP B-A'); %! legend('B-A','Subject polygon','Clipper polygon','location','southeast'); %! %input message %! disp('Press ENTER to continue ...'); %! pause(); %! %kill and close the plot window %! clf(); %! close(); %*****END OF TESTS***** octclip-1.0.8/DESCRIPTION000644 001750 001750 00000000734 12540021550 014665 0ustar00topotopo000000 000000 Name: OctCLIP Version: 1.0.8 Date: 2015-06-16 Author: José Luis García Pallero Maintainer: José Luis García Pallero Title: GNU Octave clipping polygons tool Description: This package allows to do boolean operations with polygons using the Greiner-Hormann algorithm. Depends: Octave (>= 2.9.7) Url: http://davis.wpi.edu/~matt/courses/clipping/ https://bitbucket.org/jgpallero/octclip Autoload: no License: GPLv3+, modified BSD octclip-1.0.8/src/000755 001750 001750 00000000000 12540021550 013742 5ustar00topotopo000000 000000 octclip-1.0.8/src/fgeneral.c000755 001750 001750 00000103036 12540021550 015677 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup eop general geom geopot matriz @{ \file fgeneral.c \brief Definición de funciones de utilidad general. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 10 de octubre de 2009 \version 1.0 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/fgeneral.h" /******************************************************************************/ /******************************************************************************/ int GeocParOmpFgeneral(char version[]) { //comprobamos si hay paralelización #if defined(_OPENMP) //comprobamos si hay que extraer versión if(version!=NULL) { //calculamos la versión VersionOpenMP(_OPENMP,version); } //salimos de la función return 1; #else if(version!=NULL) { //utilizamos la variable version para que no dé warming al compilar strcpy(version,""); } //salimos de la función return 0; #endif } /******************************************************************************/ /******************************************************************************/ double PonAnguloDominio(const double angulo) { //signo del ángulo de trabajo double signo=0.0; //2.0*pi double dosPi=2.0*GEOC_CONST_PI; //variable auxiliar double aux=angulo; //variable de salida double sal=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //sólo trabajamos si el valor de entrada está fuera de los límites if((angulo<=-dosPi)||(angulo>=dosPi)) { //extraemos el signo del ángulo pasado signo = GEOC_SIGNO(angulo); //valor absoluto del ángulo pasado aux = fabs(angulo); //metemos el ángulo en dominio eliminando la cantidad que se pase de //2.0*pi sal = signo*(aux-floor(aux/dosPi)*dosPi); } else { //el valor de entrada no cambia sal = angulo; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ void BuscaSegmento1DInc(const double valor, const double* lista, const size_t nDatos, const size_t incDatos, size_t* posInicio, size_t* posFin) { //variable para recorrer bucles size_t i=0; //variable indicadora de búsqueda secuencial int busca=0; //variables para calcular posiciones size_t pos1=0,pos2=0; //posiciones en memoria size_t posm=0,pos1m=0,pos2m=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //CONSIDERAMOS QUE LA LISTA CONTIENE ENTEROS EQUIESPACIADOS UNA UNIDAD //posición del valor anterior al de trabajo pos1 = (size_t)(floor(valor)-lista[0]); //posición del valor posterior al de trabajo pos2 = (size_t)(ceil(valor)-lista[0]); //si pos1==pos2, valor puede ser un extremo de la lista if(pos1==pos2) { if(pos1!=(nDatos-1)) { //calculamos el punto final del segmento pos2++; } else { //calculamos el punto inicial del segmento pos1--; } } //calculamos las posiciones en memoria pos1m = pos1*incDatos; pos2m = pos2*incDatos; //comprobamos si el segmento detectado es válido if((lista[pos1m]!=round(lista[pos1m]))|| (lista[pos2m]!=round(lista[pos2m]))|| ((lista[pos2m]-lista[pos1m])!=1.0)|| (valorlista[pos2m])) { //indicamos que se ha de hacer una búsqueda secuencial busca = 1; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //LA LISTA CONTIENE REALES NO EQUIESPACIADOS if(busca) { //recorremos todos los elementos de la lista for(i=0;i=valor) { //comprobamos el tipo de límite if(lista[posm]>valor) { //extraemos las posiciones pos1 = i-1; pos2 = i; } else { //comprobamos si estamos trabajando con el último elemento if(i==(nDatos-1)) { //extraemos las posiciones pos1 = i-1; pos2 = i; } else { //extraemos las posiciones pos1 = i; pos2 = i+1; } } //salimos del bucle break; } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos las variables de salida *posInicio = pos1; *posFin = pos2; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void BuscaSegmento1D(const double valor, const double* lista, const size_t nDatos, size_t* posInicio, size_t* posFin) { //realizamos la búsqueda con incremento igual a 1 BuscaSegmento1DInc(valor,lista,nDatos,1,posInicio,posFin); } /******************************************************************************/ /******************************************************************************/ void BuscaPosNWEnMalla(const double xPto, const double yPto, const double xMin, const double xMax, const double yMin, const double yMax, const double pasoX, const double pasoY, size_t* fil, size_t* col) { //dimensiones de la matriz size_t f=0,c=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos las dimensiones de la matriz de trabajo f = (size_t)(round((yMax-yMin)/pasoY)+1.0); c = (size_t)(round((xMax-xMin)/pasoX)+1.0); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos la fila y comprobamos si es el extremo S *fil = (size_t)(fabs(yPto-yMax)/pasoY); if(*fil==(f-1)) { //retrasamos una fila (*fil)--; } //calculamos la columna y comprobamos si es el extremo E *col = (size_t)((xPto-xMin)/pasoX); if(*col==(c-1)) { //retrasamos una columna (*col)--; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ double Minimo(const double* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como el máximo valor para un double double salida=DBL_MAX; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(min:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(min:salida) #endif //recorremos el resto de elementos de la lista for(i=0;i fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ double Maximo(const double* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como el mínimo valor para un double double salida=DBL_MIN; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(max:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(max:salida) #endif //recorremos el resto de elementos de la lista for(i=0;isalida) { //asignamos el nuevo valor menor salida = lista[pos]; } } // --> fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ double MinimoAbs(const double* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como el máximo valor para un double double salida=DBL_MAX; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(min:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(min:salida) #endif //recorremos el resto de elementos de la lista for(i=0;i fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ double MaximoAbs(const double* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como 0.0 (trabajamos en valor absoluto) double salida=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(max:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(max:salida) #endif //recorremos el resto de elementos de la lista for(i=0;isalida) { //asignamos el nuevo valor menor salida = fabs(lista[pos]); } } // --> fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ size_t MinimoSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como el máximo valor para un size_t size_t salida=SIZE_MAX; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(min:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(min:salida) #endif //recorremos el resto de elementos de la lista for(i=0;i fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ size_t MaximoSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //variable de salida, inicializada como 0 (size_t es sólo positivo) size_t salida=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP, sólo si la versión es superior a la 3.0 //en versiones anteriores no existe la posibilidad de usar reduction(max:) #if defined(_OPENMP)&&(_OPENMP>=GEOC_OMP_F_3_1) #pragma omp parallel for default(none) \ shared(lista) \ private(i,pos) \ reduction(max:salida) #endif //recorremos el resto de elementos de la lista for(i=0;isalida) { //asignamos el nuevo valor menor salida = lista[pos]; } } // --> fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ void MinMax(const double* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //consideramos que el primer elemento es el mayor y el menor *posMin = 0; *posMax = 0; //recorremos el resto de elementos de la lista for(i=1;ilista[(*posMax)*incDatos]) { //asignamos la nueva posición *posMax = i; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void MinMaxAbs(const double* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //consideramos que el primer elemento es el mayor y el menor *posMin = 0; *posMax = 0; //recorremos el resto de elementos de la lista for(i=1;ifabs(lista[(*posMax)*incDatos])) { //asignamos la nueva posición *posMax = i; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void MinMaxSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //consideramos que el primer elemento es el mayor y el menor *posMin = 0; *posMax = 0; //recorremos el resto de elementos de la lista for(i=1;ilista[(*posMax)*incDatos]) { //asignamos la nueva posición *posMax = i; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ double** AsigMemMatrizC(const size_t fil, const size_t col) { //índices para recorrer bucles size_t i=0; //matriz de salida double** matriz=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos memoria para el array principal matriz = (double**)malloc(fil*sizeof(double*)); //comprobamos los errores if(matriz==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos toda la memoria al primer puntero matriz[0] = (double*)malloc(fil*col*sizeof(double)); //comprobamos los errores if(matriz[0]==NULL) { //liberamos la memoria previamente asignada free(matriz); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //recorremos el resto de filas for(i=1;ilong int suele ser de 4 bytes en procesadores de 32 bits. Para seleccionar este tipo como long long int, lo que en procesadores de 32 bits equivale a una variable de 64 bits, es necesario definir la variable para el preprocesador \em PTOPOL_BORDE_LONG_64. En procesadores de 64 bits no es necesario (aunque puede utilizarse), ya que el tipo long int tiene una longitud de 64 bits. Si no se define la variable, se usará un tipo long int para los cálculos intermedios. En \p gcc, las variables para el preprocesador se pasan como \em -DXXX, donde \em XXX es la variable a introducir. El uso del tipo long long int en procesadores de 32 bits puede hacer que las funciones se ejecuten hasta 10 veces más lentamente que si se utiliza el tipo long int. Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 05 de abril de 2010 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/ptopol.h" /******************************************************************************/ /******************************************************************************/ int GeocParOmpPtopol(char version[]) { //comprobamos si hay paralelización #if defined(_OPENMP) //comprobamos si hay que extraer versión if(version!=NULL) { //calculamos la versión VersionOpenMP(_OPENMP,version); } //salimos de la función return 1; #else if(version!=NULL) { //utilizamos la variable version para que no dé warming al compilar strcpy(version,""); } //salimos de la función return 0; #endif } /******************************************************************************/ /******************************************************************************/ int GeocLongLongIntPtopol(void) { //comprobamos si se ha pasado la variable del preprocesador #if defined(PTOPOL_BORDE_LONG_64) return 1; #else return 0; #endif } /******************************************************************************/ /******************************************************************************/ int PtoEnRectangulo(const double x, const double y, const double xMin, const double xMax, const double yMin, const double yMax) { //posibles posiciones del punto if((xxMax)||(yyMax)) { //punto fuera return GEOC_PTO_FUERA_POLIG; } else if((x>xMin)&&(xyMin)&&(y=xMin2)&&(xMax1<=xMax2)&&(yMin1>=yMin2)&&(yMax1<=yMax2)) { //el rectángulo está contenido sal = 1; } } else { //el borde no se tiene en cuenta if((xMin1>xMin2)&&(xMax1yMin2)&&(yMax1xMax2)||(xMax1yMax2)||(yMax1y)!=(coorY[posJY]>y))&& (x<(coorX[posJX]-coorX[posIX])*(y-coorY[posIY])/ (coorY[posJY]-coorY[posIY])+coorX[posIX])) { c = !c; } } //asignamos el elemento de salida if(c) { //el punto está dentro del polígono c = GEOC_PTO_DENTRO_POLIG; } else { //el punto está fuera del polígono c = GEOC_PTO_FUERA_POLIG; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return c; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoligonoVertice(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY) { //índice para recorrer bucles size_t i=0; //variable de salida, que inicializamos fuera del polígono int pos=GEOC_PTO_FUERA_POLIG; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si el punto es un vértice for(i=0;i0)!=(cy1>0); Lstrad = (cy<0)!=(cy1<0); //straddle computation if(Rstrad||Lstrad) { //compute intersection of e with x axis X = ((double)(cx*cy1-cx1*cy))/((double)(cy1-cy)); //crosses ray if strictly positive intersection if(Rstrad&&(X>0.0)) { Rcross++; } //crosses ray if strictly negative intersection if(Lstrad&&(X<0.0)) { Lcross++; } } } //q on the edge if left and right cross are not the same parity if((Rcross%2)!=(Lcross%2)) { //el punto está en un borde return GEOC_PTO_BORDE_POLIG; } //q inside if an odd number of crossings if((Rcross%2)==1) { //el punto es interior return GEOC_PTO_DENTRO_POLIG; } else { //el punto es exterior return GEOC_PTO_FUERA_POLIG; } } /******************************************************************************/ /******************************************************************************/ int PtoEnPoligonoVerticeBordeDouble(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const double factor, const int redondeo) { //NOTA: SE MANTIENEN LOS COMENTARIOS ORIGINALES DE LA FUNCIÓN PARA VARIABLES //DE TIPO ENTERO //índices de vértices size_t i=0,i1=0; //number of (right,left) edge/ray crossings int Rcross=0,Lcross=0; //flags indicating the edge strads the X axis int Rstrad=0,Lstrad=0; //punto a evaluar pasado a número entero ptopol_long fX=0,fY=0; //coordenadas del polígono referidas al punto de trabajo ptopol_long cx=0,cy=0,cx1=0,cy1=0; //número de elementos de trabajo del polígono size_t n=N; //variable auxiliar double X=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si el primer vértice se repite al final if((coorX[0]==coorX[(N-1)*incX])&&(coorY[0]==coorY[(N-1)*incY])) { //trabajamos con todos los vértices, menos el último n = N-1; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //pasamos a número entero el punto a evaluar if(redondeo) { //redondeo fX = (ptopol_long)(round(factor*x)); fY = (ptopol_long)(round(factor*y)); } else { //truncamiento fX = (ptopol_long)(factor*x); fY = (ptopol_long)(factor*y); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //for each edge e=(i-1,i), see if crosses ray for(i=0;i0)!=(cy1>0); Lstrad = (cy<0)!=(cy1<0); //straddle computation if(Rstrad||Lstrad) { //compute intersection of e with x axis X = ((double)(cx*cy1-cx1*cy))/((double)(cy1-cy)); //crosses ray if strictly positive intersection if(Rstrad&&(X>0.0)) { Rcross++; } //crosses ray if strictly negative intersection if(Lstrad&&(X<0.0)) { Lcross++; } } } //q on the edge if left and right cross are not the same parity if((Rcross%2)!=(Lcross%2)) { //el punto está en un borde return GEOC_PTO_BORDE_POLIG; } //q inside if an odd number of crossings if((Rcross%2)==1) { //el punto es interior return GEOC_PTO_DENTRO_POLIG; } else { //el punto es exterior return GEOC_PTO_FUERA_POLIG; } } /******************************************************************************/ /******************************************************************************/ size_t* BuscaGeocNanEnVectores(const double* x, const double* y, const size_t N, const size_t incX, const size_t incY, size_t* nNan) { //índice para recorrer bucles size_t i=0; //identificadores de NaN int esNanX=0,esNanY=0; //vector de salida size_t* salida=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos a 0 el número de NaN encontrados *nNan = 0; //comprobamos una posible salida rápida if(N==0) { //salimos de la función return salida; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los elementos de los vectores for(i=0;i fin del #pragma omp parallel for } else { //hacemos una comprobación normal pos = PtoEnPoligono(x,y,coorX,coorY,N,incX,incY); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return pos; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoligonoVerticeInd(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, size_t* poli) { //índice para recorrer bucles size_t i=0; //posiciones de inicio de los vértices X e Y size_t iniX=0,iniY=0; //número de elementos del polígono a chequear size_t nElem=0; //variable auxiliar de situación de punto int posAux=0; //variable indicadora de continuación de chequeos size_t continuar=1; //variable de salida int pos=GEOC_PTO_FUERA_POLIG; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el polígono que contiene al punto *poli = 0; //comprobamos si hay valores NaN if(nNan) { //paralelización con OpenMP //utilizo schedule(dynamic) para que los polígonos vayan siendo //chequeados uno a uno según los hilos de ejecución van quedándose //libres //hago esto porque es muy probable que los polígonos vengan listados de //mayor a menor número de vértices y así se podrá trabajar con varios //polígonos pequeños mientras se testea uno grande #if defined(_OPENMP) #pragma omp parallel for default(none) schedule(dynamic) \ shared(continuar,posNan,coorX,coorY,pos,poli) \ private(i,iniX,iniY,nElem,posAux) #endif //recorremos desde el primer NaN hasta el penúltimo for(i=0;i<(nNan-1);i++) { //hacemos que todos los hilos vean la variable continuar actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif //comprobamos si hay que continuar chequeando polígonos if(continuar) { //extraemos los datos de definición del polígono DatosPoliIndividualEnVecInd(posNan,i,incX,incY,&iniX,&iniY, &nElem); //comprobamos la inclusión para el polígono de trabajo posAux = PtoEnPoligonoVertice(x,y,&coorX[iniX],&coorY[iniY], nElem,incX,incY); //me aseguro de que las variables involucradas sean actualizadas //por un hilo cada vez, sin posibilidad de modificación por //varios al mismo tiempo #if defined(_OPENMP) #pragma omp critical #endif { //si el punto no está fuera, no se han de hacer más operaciones //el continuar==1 asegura que nos quedemos con el primer //polígono en que está incluido el punto, ya que una vez que el //hilo con punto encontrado actualice la variable continuar, el //resto con posibles resultados positivos no pasarán este if() if((continuar==1)&&(posAux!=GEOC_PTO_FUERA_POLIG)) { //asignamos la variable de salida pos = posAux; //asignamos el polígono que contiene al punto *poli = i; //indicamos que no hay que continuar haciendo pruebas //esta variable se usa para el caso de ejecución en paralelo continuar = 0; //hacemos que todos los hilos vean la variable continuar //actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif } } } } // --> fin del #pragma omp parallel for } else { //hacemos una comprobación normal pos = PtoEnPoligonoVertice(x,y,coorX,coorY,N,incX,incY); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return pos; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoligonoVerticeBordeInd(const long x, const long y, const long* coorX, const long* coorY, const size_t N, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, size_t* poli) { //índice para recorrer bucles size_t i=0; //posiciones de inicio de los vértices X e Y size_t iniX=0,iniY=0; //número de elementos del polígono a chequear size_t nElem=0; //variable auxiliar de situación de punto int posAux=0; //variable indicadora de continuación de chequeos size_t continuar=1; //variable de salida int pos=GEOC_PTO_FUERA_POLIG; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el polígono que contiene al punto *poli = 0; //comprobamos si hay valores NaN if(nNan) { //paralelización con OpenMP //utilizo schedule(dynamic) para que los polígonos vayan siendo //chequeados uno a uno según los hilos de ejecución van quedándose //libres //hago esto porque es muy probable que los polígonos vengan listados de //mayor a menor número de vértices y así se podrá trabajar con varios //polígonos pequeños mientras se testea uno grande #if defined(_OPENMP) #pragma omp parallel for default(none) schedule(dynamic) \ shared(continuar,posNan,coorX,coorY,pos,poli) \ private(i,iniX,iniY,nElem,posAux) #endif //recorremos desde el primer NaN hasta el penúltimo for(i=0;i<(nNan-1);i++) { //hacemos que todos los hilos vean la variable continuar actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif //comprobamos si hay que continuar chequeando polígonos if(continuar) { //extraemos los datos de definición del polígono DatosPoliIndividualEnVecInd(posNan,i,incX,incY,&iniX,&iniY, &nElem); //comprobamos la inclusión para el polígono de trabajo posAux = PtoEnPoligonoVerticeBorde(x,y,&coorX[iniX], &coorY[iniY],nElem,incX, incY); //me aseguro de que las variables involucradas sean actualizadas //por un hilo cada vez, sin posibilidad de modificación por //varios al mismo tiempo #if defined(_OPENMP) #pragma omp critical #endif { //si el punto no está fuera, no se han de hacer más operaciones //el continuar==1 asegura que nos quedemos con el primer //polígono en que está incluido el punto, ya que una vez que el //hilo con punto encontrado actualice la variable continuar, el //resto con posibles resultados positivos no pasarán este if() if((continuar==1)&&(posAux!=GEOC_PTO_FUERA_POLIG)) { //asignamos la variable de salida pos = posAux; //asignamos el polígono que contiene al punto *poli = i; //indicamos que no hay que continuar haciendo pruebas //esta variable se usa para el caso de ejecución en paralelo continuar = 0; //hacemos que todos los hilos vean la variable continuar //actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif } } } } // --> fin del #pragma omp parallel for } else { //hacemos una comprobación normal pos = PtoEnPoligonoVerticeBorde(x,y,coorX,coorY,N,incX,incY); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return pos; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoligonoVerticeBordeDoubleInd(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const double factor, const int redondeo, const size_t* posNan, const size_t nNan, size_t* poli) { //índice para recorrer bucles size_t i=0; //posiciones de inicio de los vértices X e Y size_t iniX=0,iniY=0; //número de elementos del polígono a chequear size_t nElem=0; //variable auxiliar de situación de punto int posAux=0; //variable indicadora de continuación de chequeos size_t continuar=1; //variable de salida int pos=GEOC_PTO_FUERA_POLIG; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el polígono que contiene al punto *poli = 0; //comprobamos si hay valores NaN if(nNan) { //paralelización con OpenMP //utilizo schedule(dynamic) para que los polígonos vayan siendo //chequeados uno a uno según los hilos de ejecución van quedándose //libres //hago esto porque es muy probable que los polígonos vengan listados de //mayor a menor número de vértices y así se podrá trabajar con varios //polígonos pequeños mientras se testea uno grande #if defined(_OPENMP) #pragma omp parallel for default(none) schedule(dynamic) \ shared(continuar,posNan,coorX,coorY,pos,poli) \ private(i,iniX,iniY,nElem,posAux) #endif //recorremos desde el primer NaN hasta el penúltimo for(i=0;i<(nNan-1);i++) { //hacemos que todos los hilos vean la variable continuar actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif //comprobamos si hay que continuar chequeando polígonos if(continuar) { //extraemos los datos de definición del polígono DatosPoliIndividualEnVecInd(posNan,i,incX,incY,&iniX,&iniY, &nElem); //comprobamos la inclusión para el polígono de trabajo posAux = PtoEnPoligonoVerticeBordeDouble(x,y,&coorX[iniX], &coorY[iniY],nElem, incX,incY,factor, redondeo); //me aseguro de que las variables involucradas sean actualizadas //por un hilo cada vez, sin posibilidad de modificación por //varios al mismo tiempo #if defined(_OPENMP) #pragma omp critical #endif { //si el punto no está fuera, no se han de hacer más operaciones //el continuar==1 asegura que nos quedemos con el primer //polígono en que está incluido el punto, ya que una vez que el //hilo con punto encontrado actualice la variable continuar, el //resto con posibles resultados positivos no pasarán este if() if((continuar==1)&&(posAux!=GEOC_PTO_FUERA_POLIG)) { //asignamos la variable de salida pos = posAux; //asignamos el polígono que contiene al punto *poli = i; //indicamos que no hay que continuar haciendo pruebas //esta variable se usa para el caso de ejecución en paralelo continuar = 0; //hacemos que todos los hilos vean la variable continuar //actualizada #if defined(_OPENMP) #pragma omp flush(continuar) #endif } } } } // --> fin del #pragma omp parallel for } else { //hacemos una comprobación normal pos = PtoEnPoligonoVerticeBordeDouble(x,y,coorX,coorY,N,incX,incY, factor,redondeo); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return pos; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/polil.c000755 001750 001750 00000160726 12540021550 015244 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file polil.c \brief Definición de funciones para el trabajo con polilíneas. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 03 de junio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/polil.h" /******************************************************************************/ /******************************************************************************/ int GeocParOmpPolil(char version[]) { //comprobamos si hay paralelización #if defined(_OPENMP) //comprobamos si hay que extraer versión if(version!=NULL) { //calculamos la versión VersionOpenMP(_OPENMP,version); } //salimos de la función return 1; #else if(version!=NULL) { //utilizamos la variable version para que no dé warming al compilar strcpy(version,""); } //salimos de la función return 0; #endif } /******************************************************************************/ /******************************************************************************/ polil* IniciaPolilVacia(void) { //estructura de salida polil* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos memoria para la estructura sal = (polil*)malloc(sizeof(polil)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //inicializamos los campos escalares a 0 sal->nElem = 0; sal->nPolil = 0; sal->hayLim = 0; //inicializamos los campos vectoriales a NULL sal->x = NULL; sal->y = NULL; sal->posIni = NULL; sal->nVert = NULL; sal->xMin = NULL; sal->xMax = NULL; sal->yMin = NULL; sal->yMax = NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ int AuxCreaPolil1(const size_t nElem, const size_t* posNanX, const size_t* posNanY, const size_t nNanX, const size_t nNanY, size_t* nElemMax, size_t* nPolil) { //índice para recorrer bucles size_t i=0; //variable de salida int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay el mismo número de NaN en los dos vectores if(nNanX!=nNanY) { //salimos de la función return GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL; } //comprobamos si hay NaN en las mismas posiciones de los vectores for(i=0;i fin del #pragma omp parallel sections //comprobamos los posibles errores de asignación de memoria if(((posNanX==NULL)&&(nNanX!=0))||((posNanY==NULL)&&(nNanY!=0))) { //liberamos la memoria asignada LibMemPolil(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si los vectores tienen bien colocados los NaN y calculamos //el número máximo de elementos de los vectores de la estructura y el //número de polilíneas *idError = AuxCreaPolil1(nElem,posNanX,posNanY,nNanX,nNanY,&nElemMax, &nPolil); //comprobamos los posibles errores if(*idError!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(sal); free(posNanX); free(posNanY); //escribimos el mensaje de error if(*idError==GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL) { GEOC_ERROR("Error: Los vectores de trabajo no contienen el mismo " "número de polilíneas"); } else if(*idError==GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL) { GEOC_ERROR("Error: Los vectores de trabajo no contienen las mismas " "polilíneas"); } //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el número de polilíneas sal->nPolil = nPolil; //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(sal,nElemMax,nPolil) #endif { //asignamos memoria para los vectores de la estructura #if defined(_OPENMP) #pragma omp section #endif sal->x = (double*)malloc(nElemMax*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->y = (double*)malloc(nElemMax*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->posIni = (size_t*)malloc(nPolil*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->nVert = (size_t*)malloc(nPolil*sizeof(double)); } // --> fin del #pragma omp parallel sections //comprobamos los posibles errores if((sal->x==NULL)||(sal->y==NULL)||(sal->posIni==NULL)||(sal->nVert==NULL)) { //liberamos la memoria asignada LibMemPolil(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //copiamos las polilíneas a la estructura //como ya sabemos que el número de NaN y sus posiciones son los mismos para //los vectores x e y, trabajamos con los valores para el vector x AuxCreaPolil3(x,y,nElem,incX,incY,posNanX,nNanX,sal->x,sal->y,sal->posIni, sal->nVert,&ptos,&nPolil); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay de verdad alguna polilínea if(nPolil==0) { //liberamos la memoria asignada LibMemPolil(sal); free(posNanX); free(posNanY); //creamos la estructura vacía sal = IniciaPolilVacia(); //comprobamos los posibles errores if(sal==NULL) { //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //salimos de la función return sal; } //asignamos el número de elementos a la estructura sal->nElem = ptos; //comprobamos si hay que reajustar el tamaño de los vectores de coordenadas if(ptos!=nElemMax) { //asignamos el nuevo tamaño de los vectores sal->nElem = ptos; //reajustamos los tamaños sal->x = (double*)realloc(sal->x,ptos*sizeof(double)); sal->y = (double*)realloc(sal->y,ptos*sizeof(double)); } //comprobamos si el número de polilíneas es el estimado if(nPolil!=sal->nPolil) { //asignamos de nuevo la variable de número de polilíneas sal->nPolil = nPolil; //reajustamos los tamaños sal->posIni = (size_t*)realloc(sal->posIni,nPolil*sizeof(size_t)); sal->nVert = (size_t*)realloc(sal->nVert,nPolil*sizeof(size_t)); } //comprobamos los posibles errores if((sal->x==NULL)||(sal->y==NULL)||(sal->posIni==NULL)||(sal->nVert==NULL)) { //liberamos la memoria asignada LibMemPolil(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria asignada free(posNanX); free(posNanY); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ void EnlazaCamposPolil(polil* poliEnt, polil* poliSal) { //LIBERAMOS LA POSIBLE MEMORIA ASIGNADA A LOS CAMPOS VECTORIALES DE LA //ESTRUCTURA DE SALIDA //comprobamos si hay algún elemento en los vectores de coordenadas if(poliSal->nElem) { free(poliSal->x); free(poliSal->y); } //comprobamos si hay alguna polilínea en los vectores de posiciones if(poliSal->nPolil) { free(poliSal->posIni); free(poliSal->nVert); } //comprobamos si hay límites calculados if(poliSal->hayLim) { free(poliSal->xMin); free(poliSal->xMax); free(poliSal->yMin); free(poliSal->yMax); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //enlazamos todos los campos de la estructura de entrada en la de salida poliSal->nElem = poliEnt->nElem; poliSal->x = poliEnt->x; poliSal->y = poliEnt->y; poliSal->nPolil = poliEnt->nPolil; poliSal->posIni = poliEnt->posIni; poliSal->nVert = poliEnt->nVert; poliSal->hayLim = poliEnt->hayLim; poliSal->xMin = poliEnt->xMin; poliSal->xMax = poliEnt->xMax; poliSal->yMin = poliEnt->yMin; poliSal->yMax = poliEnt->yMax; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ polil* CopiaPolil(const polil* poli, int* idError) { //polilínea de salida polil* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la variable de error *idError = GEOC_ERR_NO_ERROR; //inicializamos la polilínea de salida sal = IniciaPolilVacia(); //comprobamos los posibles errores if(sal==NULL) { //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //sólo continuamos si la polilínea de entrada contiene datos if(poli->nElem) { //copiamos las coordenadas de los vértices *idError = AnyadeDatosPolil(sal,poli->x,poli->y,poli->nElem,1,1); //comprobamos si ha ocurrido algún error if((*idError)!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(sal); //escribimos el mensaje de error if((*idError)==GEOC_ERR_ASIG_MEMORIA) { GEOC_ERROR("Error de asignación de memoria"); } else if((*idError)==GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL) { GEOC_ERROR("Error: Los vectores de coordenadas de la\n" "polilínea de entrada no contienen el mismo número " "de polilíneas"); } else if((*idError)==GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL) { GEOC_ERROR("Error: Los vectores de coordenadas de la\n" "polilínea de entrada no contienen las mismas " "polilíneas"); } //salimos de la función return NULL; } //comprobamos si hay que calcular límites if(poli->hayLim) { //calculamos los límites *idError = CalcLimitesPolil(sal); //comprobamos los posibles errores if((*idError)!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(sal); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ int AnyadePolilPolil(polil* poli, const polil* anyade) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //número total de elementos size_t nElem=0,nPolil=0; //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si la polilínea a añadir está vacía, salimos de la función if((anyade!=NULL)&&(anyade->nPolil==0)) { //salimos de la función sin hacer nada return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el número total de elementos de la polilínea conjunta nElem = poli->nElem+anyade->nElem; //si la polilínea original contenía datos, al número total de elementos hay //que restarle 1 por el NaN común que sobra al juntar las dos estructuras if(poli->nPolil) { nElem--; } //calculamos el número total de polilíneas nPolil = poli->nPolil+anyade->nPolil; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //reasignamos memoria para cubrir los nuevos datos poli->x = (double*)realloc(poli->x,nElem*sizeof(double)); poli->y = (double*)realloc(poli->y,nElem*sizeof(double)); poli->posIni = (size_t*)realloc(poli->posIni,nPolil*sizeof(size_t)); poli->nVert = (size_t*)realloc(poli->nVert,nPolil*sizeof(size_t)); //reasignamos también para los posibles vectores de límites if(poli->hayLim) { poli->xMin = (double*)realloc(poli->xMin,nPolil*sizeof(double)); poli->xMax = (double*)realloc(poli->xMax,nPolil*sizeof(double)); poli->yMin = (double*)realloc(poli->yMin,nPolil*sizeof(double)); poli->yMax = (double*)realloc(poli->yMax,nPolil*sizeof(double)); } //comprobamos los posibles errores en las asignaciones obligatorias if((poli->x==NULL)||(poli->y==NULL)||(poli->posIni==NULL)|| (poli->nVert==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //comprobamos los posibles errores en las asignaciones de límites if(poli->hayLim) { if((poli->xMin==NULL)||(poli->xMax==NULL)||(poli->yMin==NULL)|| (poli->yMax==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos la posición de inicio para copiar en la estructura de salida //si la estructura de salida está vacía, se comienza en la primera posición //si tiene datos, se comienza a continuación en la última (dentro del bucle, //la suma de posIni hace que se comience a continuación de la última) pos = (poli->nPolil==0) ? 0 : poli->nElem-1; //recorremos el número de nuevos elementos for(i=0;inElem;i++) { //copiamos las coordenadas poli->x[pos+i] = anyade->x[i]; poli->y[pos+i] = anyade->y[i]; } //calculamos las posiciones a sumar para ajustar las posiciones de inicio de //las polilíneas añadidas //si la estructura de salida está vacía, se copian las posiciones tal cual //si tiene datos, se suman las posiciones ya ocupadas pos = (poli->nPolil==0) ? 0 : poli->nElem-1; //recorremos el número de polilíneas for(i=0;inPolil;i++) { //copiamos las posiciones de inicio actualizadas y el número de vértices poli->posIni[poli->nPolil+i] = anyade->posIni[i]+pos; poli->nVert[poli->nPolil+i] = anyade->nVert[i]; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que calcular límites if(poli->hayLim) { //comprobamos si ya están calculados if(anyade->hayLim) { //recorremos el número de polilíneas y copiamos los límites for(i=0;inPolil;i++) { //copiamos los límites poli->xMin[poli->nPolil+i] = anyade->xMin[i]; poli->xMax[poli->nPolil+i] = anyade->xMax[i]; poli->yMin[poli->nPolil+i] = anyade->yMin[i]; poli->yMax[poli->nPolil+i] = anyade->yMax[i]; } } else { //calculamos los límites y los copiamos LimitesPoligonosPolig(&(anyade->x[1]),&(anyade->y[1]),1,1, anyade->posIni,anyade->nVert,anyade->nPolil, anyade->posIni[0],&(poli->xMin[poli->nPolil]), &(poli->xMax[poli->nPolil]), &(poli->yMin[poli->nPolil]), &(poli->yMax[poli->nPolil])); } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ajustamos los tamaños antes de salir poli->nElem = nElem; poli->nPolil = nPolil; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ int AnyadeDatosPolil(polil* poli, const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY) { //polilínea auxiliar polil* aux=NULL; //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contemplamos una posible salida rápida if(nElem==0) { //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos una nueva polilínea con los datos a añadir aux = CreaPolil(x,y,nElem,incX,incY,&estado); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(aux); //escribimos el mensaje de error if(estado==GEOC_ERR_ASIG_MEMORIA) { GEOC_ERROR("Error de asignación de memoria"); } else if(estado==GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL) { GEOC_ERROR("Error: Los vectores de trabajo no contienen el mismo " "número de polilíneas"); } else if(estado==GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL) { GEOC_ERROR("Error: Los vectores de trabajo no contienen las mismas " "polilíneas"); } //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //añadimos la nueva estructura estado = AnyadePolilPolil(poli,aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria utilizada LibMemPolil(aux); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void LibMemPolil(polil* datos) { //comprobamos si hay memoria que liberar if(datos!=NULL) { //liberamos la memoria asignada al vector de coordenadas X if(datos->x!=NULL) { free(datos->x); } //liberamos la memoria asignada al vector de coordenadas Y if(datos->y!=NULL) { free(datos->y); } //liberamos la memoria asignada al vector de posiciones if(datos->posIni!=NULL) { free(datos->posIni); } //liberamos la memoria asignada al vector de número de vértices if(datos->nVert!=NULL) { free(datos->nVert); } //liberamos la memoria asignada a los vector de coordenadas X mínimas if(datos->xMin!=NULL) { free(datos->xMin); } //liberamos la memoria asignada a los vector de coordenadas X máximas if(datos->xMax!=NULL) { free(datos->xMax); } //liberamos la memoria asignada a los vector de coordenadas Y mínimas if(datos->yMin!=NULL) { free(datos->yMin); } //liberamos la memoria asignada a los vector de coordenadas Y máximas if(datos->yMax!=NULL) { free(datos->yMax); } //liberamos la memoria asignada a la estructura free(datos); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int CalcLimitesPolil(polil* poli) { //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos salida rápida if((poli->nPolil==0)||(poli->hayLim)) { //salimos de la función si la estructura no contiene polilíneas o si //éstas ya tienen calculados sus límites return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { //asignamos memoria para los vectores de límites #if defined(_OPENMP) #pragma omp section #endif poli->xMin = (double*)malloc((poli->nPolil)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->xMax = (double*)malloc((poli->nPolil)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->yMin = (double*)malloc((poli->nPolil)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->yMax = (double*)malloc((poli->nPolil)*sizeof(double)); } // --> fin del #pragma omp parallel sections //comprobamos los posibles errores if((poli->xMin==NULL)||(poli->xMax==NULL)||(poli->yMin==NULL)|| (poli->yMax==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //indicamos que sí hay límites poli->hayLim = 1; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos los límites de todas las polilíneas LimitesPoligonosPolig(poli->x,poli->y,1,1,poli->posIni,poli->nVert, poli->nPolil,0,poli->xMin,poli->xMax,poli->yMin, poli->yMax); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void EscalaYTrasladaPolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim) { //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { #if defined(_OPENMP) #pragma omp section #endif //aplicamos los factores de escala y las traslaciones a las coordenadas X EscalaYTrasladaVector(poli->x,poli->nElem,1,escalaX,trasladaX); #if defined(_OPENMP) #pragma omp section #endif //aplicamos los factores de escala y las traslaciones a las coordenadas Y EscalaYTrasladaVector(poli->y,poli->nElem,1,escalaY,trasladaY); } // --> fin del #pragma omp parallel sections //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ESTA PARTE NO LA PARALELIZAMOS, YA QUE SUPONEMOS QUE EL NÚMERO DE //POLÍGONOS EN UNA ESTRUCTURA SIEMPRE SERÁ MUCHÍSIMO MENOR QUE EL NÚMERO //TOTAL DE VÉRTICES //comprobamos si hay que aplicar el factor a los límites if(aplicaLim&&poli->hayLim) { //aplicamos los factores de escala y las traslaciones a los límites EscalaYTrasladaVector(poli->xMin,poli->nPolil,1,escalaX,trasladaX); EscalaYTrasladaVector(poli->xMax,poli->nPolil,1,escalaX,trasladaX); EscalaYTrasladaVector(poli->yMin,poli->nPolil,1,escalaY,trasladaY); EscalaYTrasladaVector(poli->yMax,poli->nPolil,1,escalaY,trasladaY); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void TrasladaYEscalaPolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim) { //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { #if defined(_OPENMP) #pragma omp section #endif //aplicamos las traslaciones y los factores de escala a las coordenadas X TrasladaYEscalaVector(poli->x,poli->nElem,1,escalaX,trasladaX); #if defined(_OPENMP) #pragma omp section #endif //aplicamos las traslaciones y los factores de escala a las coordenadas Y TrasladaYEscalaVector(poli->y,poli->nElem,1,escalaY,trasladaY); } // --> fin del #pragma omp parallel sections //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ESTA PARTE NO LA PARALELIZAMOS, YA QUE SUPONEMOS QUE EL NÚMERO DE //POLÍGONOS EN UNA ESTRUCTURA SIEMPRE SERÁ MUCHÍSIMO MENOR QUE EL NÚMERO //TOTAL DE VÉRTICES //comprobamos si hay que aplicar el factor a los límites if(aplicaLim&&poli->hayLim) { //aplicamos las traslaciones y los factores de escala a los límites TrasladaYEscalaVector(poli->xMin,poli->nPolil,1,escalaX,trasladaX); TrasladaYEscalaVector(poli->xMax,poli->nPolil,1,escalaX,trasladaX); TrasladaYEscalaVector(poli->yMin,poli->nPolil,1,escalaY,trasladaY); TrasladaYEscalaVector(poli->yMax,poli->nPolil,1,escalaY,trasladaY); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void MuevePolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int orden, const int aplicaLim) { //comprobamos el orden de aplicación de los factores if(orden==0) { //primero los factores de escala y luego las traslaciones EscalaYTrasladaPolil(poli,escalaX,escalaY,trasladaX,trasladaY, aplicaLim); } else { //primero las traslaciones y luego los factores de escala TrasladaYEscalaPolil(poli,escalaX,escalaY,trasladaX,trasladaY, aplicaLim); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int AligeraPolil(polil* poli, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto) { //índices para recorrer bucles size_t i=0,j=0; //posición inicial de la polilínea de trabajo y número de puntos aligerados size_t posIni=0,nPtos=0; //polilínea que es un mismo punto int pmp=0; //coordenadas de las polilíneas aligeradas double* x=NULL; double* y=NULL; //estructura auxiliar polil* aux=NULL; //vector de posiciones después del aligerado size_t* pos=NULL; //variable de salida int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos una posible salida rápida if(poli->nPolil==0) { //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar vacía aux = IniciaPolilVacia(); //comprobamos los posibles errores if(aux==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos el número de polilíneas almacenadas for(i=0;inPolil;i++) { //extraemos la posición inicial de la polilínea de trabajo posIni = poli->posIni[i]; //aligeramos la polilínea de trabajo pos = AligeraPolilinea(&(poli->x[posIni]),&(poli->y[posIni]), poli->nVert[i],1,1,tol,robusto,nPtosRobusto, nSegRobusto,&nPtos); //comprobamos posibles errores if(pos==NULL) { //liberamos la memoria asignada LibMemPolil(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //comprobamos si la polilínea se ha quedado en dos puntos if(nPtos==2) { //comprobamos si los tres puntos son colineales pmp = ((poli->x[posIni+pos[0]])==(poli->x[posIni+pos[1]]))&& ((poli->y[posIni+pos[0]])==(poli->y[posIni+pos[1]])); } //comprobamos si después del aligerado todavía queda una polilínea que //no sea un único punto if((nPtos>2)||((nPtos==2)&&(!pmp))) { //asignamos memoria para los vectores de coordenadas de la polilínea //aligerada x = (double*)malloc(nPtos*sizeof(double)); y = (double*)malloc(nPtos*sizeof(double)); //comprobamos posibles errores if((x==NULL)||(y==NULL)) { //liberamos la memoria asignada LibMemPolil(aux); free(pos); free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //recorremos el número de puntos de la polilínea aligerada for(j=0;jx[posIni+pos[j]]; y[j] = poli->y[posIni+pos[j]]; } //añadimos las coordenadas a la polilínea aligerada estado = AnyadeDatosPolil(aux,x,y,nPtos,1,1); //sólo puede haber ocurrido un error de asignación de memoria, ya //que suponemos que la polilínea de entrada es correcta if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(aux); free(pos); free(x); free(y); //escribimos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //liberamos la memoria asignada a los vectores de coordenadas free(x); free(y); } //liberamos la memoria asignada al vector de posiciones del aligerado free(pos); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que calcular límites if(poli->hayLim) { //calculamos los límites estado = CalcLimitesPolil(aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolil(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //enlazamos los campos de la estructura auxiliar a los de la estructura de //salida EnlazaCamposPolil(aux,poli); //liberamos la memoria asignada a la estructura auxiliar (pero no a sus //campos) free(aux); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void ImprimeCabeceraPolilFichero(const polil* poli, const size_t indice, const char iniCab[], const int impLim, const char formCoor[], const double factorX, const double factorY, FILE* idFich) { //número de vértices de la polilínea de trabajo size_t nVert=0; //límites double xMin=0.0,xMax=0.0,yMin=0.0,yMax=0.0,limAux=0.0; //variables de posición size_t pos=0,posXMin=0,posXMax=0,posYMin=0,posYMax=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //número de vértices a imprimir de la polilínea nVert = poli->nVert[indice]; //posición de inicio de la polilínea pos = poli->posIni[indice]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //imprimimos la marca de inicio y el número de vértices fprintf(idFich,"%s %8zu",iniCab,nVert); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que imprimir los límites if(impLim) { //comprobamos si ya están calculados los límites if(poli->hayLim) { //extraemos los límites xMin = poli->xMin[indice]; xMax = poli->xMax[indice]; yMin = poli->yMin[indice]; yMax = poli->yMax[indice]; } else { //buscamos las posiciones de los elementos máximo y mínimo //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli,pos,nVert,posXMin,posXMax,posYMin,posYMax) #endif { //posiciones en el vector X #if defined(_OPENMP) #pragma omp section #endif MinMax(&(poli->x[pos]),nVert,1,&posXMin,&posXMax); //posiciones en el vector Y #if defined(_OPENMP) #pragma omp section #endif MinMax(&(poli->y[pos]),nVert,1,&posYMin,&posYMax); } // --> fin del #pragma omp parallel sections //extraemos los valores extremos xMin = poli->x[pos+posXMin]; xMax = poli->x[pos+posXMax]; yMin = poli->y[pos+posYMin]; yMax = poli->y[pos+posYMax]; } //comprobamos si el factor de escala para X es negativo if(factorX<0.0) { //los límites cambian limAux = xMin; xMin = xMax; xMax = limAux; //aplicamos el factor de escala xMin *= factorX; xMax *= factorX; } //comprobamos si el factor de escala para Y es negativo if(factorY<0.0) { //los límites cambian limAux = yMin; yMin = yMax; yMax = limAux; //aplicamos el factor de escala yMin *= factorY; yMax *= factorY; } //imprimimos los límites fprintf(idFich," "); fprintf(idFich,formCoor,xMin); fprintf(idFich," "); fprintf(idFich,formCoor,xMax); fprintf(idFich," "); fprintf(idFich,formCoor,yMin); fprintf(idFich," "); fprintf(idFich,formCoor,yMax); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salto de línea final fprintf(idFich,"\n"); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void ImprimePolilFichero(const polil* poli, const double factorX, const double factorY, const int iniNan, const int finNan, const char formCoor[], const int impCabecera, const char iniCab[], const int impLim, FILE* idFich) { //índices para recorrer bucles size_t i=0,j=0; //cadena de formato para imprimir los posibles valores NaN char formNan[GEOC_NAN_LON_FORM_NUM_SIMPLE+1]; //variable de posición size_t pos=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si la estructura contiene alguna polilínea if(poli->nPolil==0) { //salimos sin imprimir nada return; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la cadena de formato para imprimir los polibles NaN FormatoNumFormatoTexto(formCoor,formNan); //comprobamos si hay que imprimir la marca separadora al principio if(iniNan) { //la imprimimos ImprimeGeocNanTexto(idFich,2,formNan,1); } //recorremos el número de polilíneas for(i=0;inPolil;i++) { //comprobamos si hay que imprimir la cabecera if(impCabecera) { //imprimos la cabecera ImprimeCabeceraPolilFichero(poli,i,iniCab,impLim,formCoor,factorX, factorY,idFich); } //posición del punto inicial de la polilínea pos = poli->posIni[i]; //recorremos el número de vértices de la polilínea de trabajo for(j=0;jnVert[i];j++) { //imprimimos las coordenadas, multiplicadas por factor fprintf(idFich,formCoor,factorX*poli->x[pos+j]); fprintf(idFich,formCoor,factorY*poli->y[pos+j]); fprintf(idFich,"\n"); } //imprimimos la marca separadora al final (menos para el último) if(i!=(poli->nPolil-1)) { ImprimeGeocNanTexto(idFich,2,formNan,1); } } //comprobamos si hay que imprimir la marca separadora al final if(finNan) { //la imprimimos ImprimeGeocNanTexto(idFich,2,formNan,1); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/polig.c000755 001750 001750 00000215017 12540021550 015231 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file polig.c \brief Definición de funciones para el trabajo con polígonos. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 20 de abril de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/polig.h" /******************************************************************************/ /******************************************************************************/ int GeocParOmpPolig(char version[]) { //comprobamos si hay paralelización #if defined(_OPENMP) //comprobamos si hay que extraer versión if(version!=NULL) { //calculamos la versión VersionOpenMP(_OPENMP,version); } //salimos de la función return 1; #else if(version!=NULL) { //utilizamos la variable version para que no dé warming al compilar strcpy(version,""); } //salimos de la función return 0; #endif } /******************************************************************************/ /******************************************************************************/ polig* IniciaPoligVacio(void) { //estructura de salida polig* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos memoria para la estructura sal = (polig*)malloc(sizeof(polig)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //inicializamos los campos escalares a 0 sal->nElem = 0; sal->nPolig = 0; sal->hayLim = 0; sal->hayArea = 0; //inicializamos los campos vectoriales a NULL sal->x = NULL; sal->y = NULL; sal->posIni = NULL; sal->nVert = NULL; sal->xMin = NULL; sal->xMax = NULL; sal->yMin = NULL; sal->yMax = NULL; sal->area = NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ int AuxCreaPolig1(const size_t nElem, const size_t* posNanX, const size_t* posNanY, const size_t nNanX, const size_t nNanY, size_t* nElemMax, size_t* nPolig) { //índice para recorrer bucles size_t i=0; //variable de salida int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay el mismo número de NaN en los dos vectores if(nNanX!=nNanY) { //salimos de la función return GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG; } //comprobamos si hay NaN en las mismas posiciones de los vectores for(i=0;i fin del #pragma omp parallel sections //comprobamos los posibles errores de asignación de memoria if(((posNanX==NULL)&&(nNanX!=0))||((posNanY==NULL)&&(nNanY!=0))) { //liberamos la memoria asignada LibMemPolig(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si los vectores tienen bien colocados los NaN y calculamos //el número máximo de elementos de los vectores de la estructura y el //número de polígonos *idError = AuxCreaPolig1(nElem,posNanX,posNanY,nNanX,nNanY,&nElemMax, &nPolig); //comprobamos los posibles errores if(*idError!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(sal); free(posNanX); free(posNanY); //escribimos el mensaje de error if(*idError==GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG) { GEOC_ERROR("Error: Los vectores de trabajo no contienen el mismo " "número de polígonos"); } else if(*idError==GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG) { GEOC_ERROR("Error: Los vectores de trabajo no contienen los mismos " "polígonos"); } //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el número de polígonos sal->nPolig = nPolig; //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(sal,nElemMax,nPolig) #endif { //asignamos memoria para los vectores de la estructura #if defined(_OPENMP) #pragma omp section #endif sal->x = (double*)malloc(nElemMax*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->y = (double*)malloc(nElemMax*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->posIni = (size_t*)malloc(nPolig*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif sal->nVert = (size_t*)malloc(nPolig*sizeof(double)); } // --> fin del #pragma omp parallel sections //comprobamos los posibles errores if((sal->x==NULL)||(sal->y==NULL)||(sal->posIni==NULL)||(sal->nVert==NULL)) { //liberamos la memoria asignada LibMemPolig(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //copiamos los polígonos a la estructura //como ya sabemos que el número de NaN y sus posiciones son los mismos para //los vectores x e y, trabajamos con los valores para el vector x AuxCreaPolig3(x,y,nElem,incX,incY,posNanX,nNanX,sal->x,sal->y,sal->posIni, sal->nVert,&ptos,&nPolig); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay de verdad algún polígono if(nPolig==0) { //liberamos la memoria asignada LibMemPolig(sal); free(posNanX); free(posNanY); //creamos la estructura vacía sal = IniciaPoligVacio(); //comprobamos los posibles errores if(sal==NULL) { //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //salimos de la función return sal; } //asignamos el número de elementos a la estructura sal->nElem = ptos; //comprobamos si hay que reajustar el tamaño de los vectores de coordenadas if(ptos!=nElemMax) { //asignamos el nuevo tamaño de los vectores sal->nElem = ptos; //reajustamos los tamaños sal->x = (double*)realloc(sal->x,ptos*sizeof(double)); sal->y = (double*)realloc(sal->y,ptos*sizeof(double)); } //comprobamos si el número de polígonos es el estimado if(nPolig!=sal->nPolig) { //asignamos de nuevo la variable de número de polígonos sal->nPolig = nPolig; //reajustamos los tamaños sal->posIni = (size_t*)realloc(sal->posIni,nPolig*sizeof(size_t)); sal->nVert = (size_t*)realloc(sal->nVert,nPolig*sizeof(size_t)); } //comprobamos los posibles errores if((sal->x==NULL)||(sal->y==NULL)||(sal->posIni==NULL)||(sal->nVert==NULL)) { //liberamos la memoria asignada LibMemPolig(sal); free(posNanX); free(posNanY); //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria asignada free(posNanX); free(posNanY); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ void EnlazaCamposPolig(polig* poliEnt, polig* poliSal) { //LIBERAMOS LA POSIBLE MEMORIA ASIGNADA A LOS CAMPOS VECTORIALES DE LA //ESTRUCTURA DE SALIDA //comprobamos si hay algún elemento en los vectores de coordenadas if(poliSal->nElem) { free(poliSal->x); free(poliSal->y); } //comprobamos si hay algún polígono en los vectores de posiciones if(poliSal->nPolig) { free(poliSal->posIni); free(poliSal->nVert); } //comprobamos si hay límites calculados if(poliSal->hayLim) { free(poliSal->xMin); free(poliSal->xMax); free(poliSal->yMin); free(poliSal->yMax); } //comprobamos si hay superficies calculadas if(poliSal->hayArea) { free(poliSal->area); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //enlazamos todos los campos de la estructura de entrada en la de salida poliSal->nElem = poliEnt->nElem; poliSal->x = poliEnt->x; poliSal->y = poliEnt->y; poliSal->nPolig = poliEnt->nPolig; poliSal->posIni = poliEnt->posIni; poliSal->nVert = poliEnt->nVert; poliSal->hayLim = poliEnt->hayLim; poliSal->xMin = poliEnt->xMin; poliSal->xMax = poliEnt->xMax; poliSal->yMin = poliEnt->yMin; poliSal->yMax = poliEnt->yMax; poliSal->hayArea = poliEnt->hayArea; poliSal->area = poliEnt->area; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ polig* CopiaPolig(const polig* poli, int* idError) { //polígono de salida polig* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la variable de error *idError = GEOC_ERR_NO_ERROR; //inicializamos el polígono de salida sal = IniciaPoligVacio(); //comprobamos los posibles errores if(sal==NULL) { //asignamos la variable de error *idError = GEOC_ERR_ASIG_MEMORIA; //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //sólo continuamos si el polígono de entrada contiene datos if(poli->nElem) { //copiamos las coordenadas de los vértices *idError = AnyadeDatosPolig(sal,poli->x,poli->y,poli->nElem,1,1); //comprobamos si ha ocurrido algún error if((*idError)!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(sal); //escribimos el mensaje de error if((*idError)==GEOC_ERR_ASIG_MEMORIA) { GEOC_ERROR("Error de asignación de memoria"); } else if((*idError)==GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG) { GEOC_ERROR("Error: Los vectores de coordenadas del polígono\n" "de entrada no contienen el mismo número de " "polígonos"); } else if((*idError)==GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG) { GEOC_ERROR("Error: Los vectores de coordenadas del polígono\n" "de entrada no contienen los mismos polígonos"); } //salimos de la función return NULL; } //comprobamos si hay que calcular límites if(poli->hayLim) { //calculamos los límites *idError = CalcLimitesPolig(sal); //comprobamos los posibles errores if((*idError)!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(sal); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //comprobamos si hay que calcular superficies if(poli->hayArea) { //calculamos las áreas *idError = CalcAreaPolig(sal); //comprobamos los posibles errores if((*idError)!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(sal); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ int AnyadePoligPolig(polig* poli, const polig* anyade) { //índice para recorrer bucles size_t i=0; //variable de posición size_t pos=0; //número total de elementos size_t nElem=0,nPolig=0; //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si el polígono a añadir está vacío, salimos de la función if((anyade!=NULL)&&(anyade->nPolig==0)) { //salimos de la función sin hacer nada return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el número total de elementos del polígono conjunto nElem = poli->nElem+anyade->nElem; //si el polígono original contenía datos, al número total de elementos hay //que restarle 1 por el NaN común que sobra al juntar las dos estructuras if(poli->nPolig) { nElem--; } //calculamos el número total de polígonos nPolig = poli->nPolig+anyade->nPolig; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //reasignamos memoria para cubrir los nuevos datos poli->x = (double*)realloc(poli->x,nElem*sizeof(double)); poli->y = (double*)realloc(poli->y,nElem*sizeof(double)); poli->posIni = (size_t*)realloc(poli->posIni,nPolig*sizeof(size_t)); poli->nVert = (size_t*)realloc(poli->nVert,nPolig*sizeof(size_t)); //reasignamos también para los posibles vectores de límites y superficies if(poli->hayLim) { poli->xMin = (double*)realloc(poli->xMin,nPolig*sizeof(double)); poli->xMax = (double*)realloc(poli->xMax,nPolig*sizeof(double)); poli->yMin = (double*)realloc(poli->yMin,nPolig*sizeof(double)); poli->yMax = (double*)realloc(poli->yMax,nPolig*sizeof(double)); } if(poli->hayArea) { poli->area = (double*)realloc(poli->area,nPolig*sizeof(double)); } //comprobamos los posibles errores en las asignaciones obligatorias if((poli->x==NULL)||(poli->y==NULL)||(poli->posIni==NULL)|| (poli->nVert==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //comprobamos los posibles errores en las asignaciones de límites if(poli->hayLim) { if((poli->xMin==NULL)||(poli->xMax==NULL)||(poli->yMin==NULL)|| (poli->yMax==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //comprobamos los posibles errores en las asignaciones de áreas if(poli->hayArea) { if(poli->area==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos la posición de inicio para copiar en la estructura de salida //si la estructura de salida está vacía, se comienza en la primera posición //si tiene datos, se comienza a continuación en la última (dentro del bucle, //la suma de posIni hace que se comience a continuación de la última) pos = (poli->nPolig==0) ? 0 : poli->nElem-1; //recorremos el número de nuevos elementos for(i=0;inElem;i++) { //copiamos las coordenadas poli->x[pos+i] = anyade->x[i]; poli->y[pos+i] = anyade->y[i]; } //calculamos las posiciones a sumar para ajustar las posiciones de inicio de //los polígonos añadidos //si la estructura de salida está vacía, se copian las posiciones tal cual //si tiene datos, se suman las posiciones ya ocupadas pos = (poli->nPolig==0) ? 0 : poli->nElem-1; //recorremos el número de polígonos for(i=0;inPolig;i++) { //copiamos las posiciones de inicio actualizadas y el número de vértices poli->posIni[poli->nPolig+i] = anyade->posIni[i]+pos; poli->nVert[poli->nPolig+i] = anyade->nVert[i]; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que calcular límites if(poli->hayLim) { //comprobamos si ya están calculados if(anyade->hayLim) { //recorremos el número de polígonos y copiamos los límites for(i=0;inPolig;i++) { //copiamos los límites poli->xMin[poli->nPolig+i] = anyade->xMin[i]; poli->xMax[poli->nPolig+i] = anyade->xMax[i]; poli->yMin[poli->nPolig+i] = anyade->yMin[i]; poli->yMax[poli->nPolig+i] = anyade->yMax[i]; } } else { //calculamos los límites y los copiamos LimitesPoligonosPolig(&(anyade->x[1]),&(anyade->y[1]),1,1, anyade->posIni,anyade->nVert,anyade->nPolig, anyade->posIni[0],&(poli->xMin[poli->nPolig]), &(poli->xMax[poli->nPolig]), &(poli->yMin[poli->nPolig]), &(poli->yMax[poli->nPolig])); } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que calcular áreas if(poli->hayArea) { //comprobamos si ya están calculadas if(anyade->hayArea) { //recorremos el número de polígonos y copiamos las superficies for(i=0;inPolig;i++) { //copiamos los límites poli->area[poli->nPolig+i] = anyade->area[i]; } } else { //calculamos las superficies y las copiamos AreaPoligonosSimplesPolig(&(anyade->x[1]),&(anyade->y[1]),1,1, anyade->posIni,anyade->nVert, anyade->nPolig,anyade->posIni[0], &(poli->area[poli->nPolig])); } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ajustamos los tamaños antes de salir poli->nElem = nElem; poli->nPolig = nPolig; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ int AnyadeDatosPolig(polig* poli, const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY) { //polígono auxiliar polig* aux=NULL; //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contemplamos una posible salida rápida if(nElem==0) { //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos un nuevo polígono con los datos a añadir aux = CreaPolig(x,y,nElem,incX,incY,&estado); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); //escribimos el mensaje de error if(estado==GEOC_ERR_ASIG_MEMORIA) { GEOC_ERROR("Error de asignación de memoria"); } else if(estado==GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG) { GEOC_ERROR("Error: Los vectores de trabajo no contienen el mismo " "número de polígonos"); } else if(estado==GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG) { GEOC_ERROR("Error: Los vectores de trabajo no contienen los mismos " "polígonos"); } //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //añadimos la nueva estructura estado = AnyadePoligPolig(poli,aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria utilizada LibMemPolig(aux); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void LibMemPolig(polig* datos) { //comprobamos si hay memoria que liberar if(datos!=NULL) { //liberamos la memoria asignada al vector de coordenadas X if(datos->x!=NULL) { free(datos->x); } //liberamos la memoria asignada al vector de coordenadas Y if(datos->y!=NULL) { free(datos->y); } //liberamos la memoria asignada al vector de posiciones if(datos->posIni!=NULL) { free(datos->posIni); } //liberamos la memoria asignada al vector de número de vértices if(datos->nVert!=NULL) { free(datos->nVert); } //liberamos la memoria asignada a los vector de coordenadas X mínimas if(datos->xMin!=NULL) { free(datos->xMin); } //liberamos la memoria asignada a los vector de coordenadas X máximas if(datos->xMax!=NULL) { free(datos->xMax); } //liberamos la memoria asignada a los vector de coordenadas Y mínimas if(datos->yMin!=NULL) { free(datos->yMin); } //liberamos la memoria asignada a los vector de coordenadas Y máximas if(datos->yMax!=NULL) { free(datos->yMax); } //liberamos la memoria asignada al vector de áreas if(datos->area!=NULL) { free(datos->area); } //liberamos la memoria asignada a la estructura free(datos); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int CalcLimitesPolig(polig* poli) { //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos salida rápida if((poli->nPolig==0)||(poli->hayLim)) { //salimos de la función si la estructura no contiene polígonos o si //éstos ya tienen calculados sus límites return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { //asignamos memoria para los vectores de límites #if defined(_OPENMP) #pragma omp section #endif poli->xMin = (double*)malloc((poli->nPolig)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->xMax = (double*)malloc((poli->nPolig)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->yMin = (double*)malloc((poli->nPolig)*sizeof(double)); #if defined(_OPENMP) #pragma omp section #endif poli->yMax = (double*)malloc((poli->nPolig)*sizeof(double)); } // --> fin del #pragma omp parallel sections //comprobamos los posibles errores if((poli->xMin==NULL)||(poli->xMax==NULL)||(poli->yMin==NULL)|| (poli->yMax==NULL)) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //indicamos que sí hay límites poli->hayLim = 1; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos los límites de todos los polígonos LimitesPoligonosPolig(poli->x,poli->y,1,1,poli->posIni,poli->nVert, poli->nPolig,0,poli->xMin,poli->xMax,poli->yMin, poli->yMax); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void LimitesPoligono(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, double* xMin, double* xMax, double* yMin, double* yMax) { //posiciones de los elementos máximo y mínimo size_t posXMin=0,posXMax=0,posYMin=0,posYMax=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //buscamos las posiciones de los elementos máximo y mínimo //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(x,posXMin,posXMax,y,posYMin,posYMax) #endif { //posiciones en el vector X #if defined(_OPENMP) #pragma omp section #endif MinMax(x,nElem,incX,&posXMin,&posXMax); //posiciones en el vector Y #if defined(_OPENMP) #pragma omp section #endif MinMax(y,nElem,incY,&posYMin,&posYMax); } // --> fin del #pragma omp parallel sections //extraemos los valores de las posiciones calculadas *xMin = x[posXMin*incX]; *xMax = x[posXMax*incX]; *yMin = y[posYMin*incY]; *yMax = y[posYMax*incY]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void LimitesPoligonosPolig(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posIni, const size_t* nVert, const size_t nPolig, const size_t restaPosIni, double* xMin, double* xMax, double* yMin, double* yMax) { //índice para recorrer bucles size_t i=0; //posición inicial del polígono de trabajo size_t pI=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel for default(none) schedule(dynamic) \ shared(posIni,x,y,nVert,xMin,xMax,yMin,yMax) \ private(i,pI) #endif //recorremos el número de polígonos for(i=0;i fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int CalcAreaPolig(polig* poli) { //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos salida rápida if((poli->nPolig==0)||(poli->hayArea)) { //salimos de la función si la estructura no contiene polígonos o si //éstos ya tienen calculada su superficie return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos memoria para el vector de superficies poli->area = (double*)malloc((poli->nPolig)*sizeof(double)); //comprobamos los posibles errores if(poli->area==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //indicamos que sí hay superficies poli->hayArea = 1; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos las superficies de todos los polígonos AreaPoligonosSimplesPolig(poli->x,poli->y,1,1,poli->posIni,poli->nVert, poli->nPolig,0,poli->area); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ double AreaPoligonoSimple(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY) { //índice para recorrer bucles size_t i=0; //número de elementos de trabajo, que inicializamos con el valor pasado size_t nElemTrab=nElem; //variable de salida double area=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si el primero punto es el mismo que el último, restamos una unidad al //número de elementos pasado, ya que el algoritmo está preparado para //trabajar con un vector en el que no se repite el primer punto if((x[0]==x[(nElem-1)*incX])&&(y[0]==y[(nElem-1)*incY])) { //el número de elementos de trabajo es uno menos que el pasado nElemTrab = nElem-1; } //el algoritmo utilizado es la segunda expresión de la ecuación 21.4.20 del //Numerical Recipes, tercera edición, página 1127 //recorremos los puntos hasta el penúltimo for(i=0;i<(nElemTrab-1);i++) { //vamos sumando area += (x[(i+1)*incX]+x[i*incX])*(y[(i+1)*incY]-y[i*incY]); } //sumamos la contribución del último lado, es decir, el lado que contiene //como vértice final al primer punto area += (x[0]+x[(nElemTrab-1)*incX])*(y[0]-y[(nElemTrab-1)*incY]); //dividimos entre dos para calcular el área real area /= 2.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return area; } /******************************************************************************/ /******************************************************************************/ void AreaPoligonosSimplesPolig(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posIni, const size_t* nVert, const size_t nPolig, const size_t restaPosIni, double* area) { //índice para recorrer bucles size_t i=0; //posición inicial del polígono de trabajo size_t pI=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel for default(none) schedule(dynamic) \ shared(posIni,area,x,y,nVert) \ private(i,pI) #endif //recorremos el número de polígonos for(i=0;i fin del #pragma omp parallel for //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void EscalaYTrasladaPolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim, const int aplicaArea) { //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { #if defined(_OPENMP) #pragma omp section #endif //aplicamos los factores de escala y las traslaciones a las coordenadas X EscalaYTrasladaVector(poli->x,poli->nElem,1,escalaX,trasladaX); #if defined(_OPENMP) #pragma omp section #endif //aplicamos los factores de escala y las traslaciones a las coordenadas Y EscalaYTrasladaVector(poli->y,poli->nElem,1,escalaY,trasladaY); } // --> fin del #pragma omp parallel sections //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ESTA PARTE NO LA PARALELIZAMOS, YA QUE SUPONEMOS QUE EL NÚMERO DE //POLÍGONOS EN UNA ESTRUCTURA SIEMPRE SERÁ MUCHÍSIMO MENOR QUE EL NÚMERO //TOTAL DE VÉRTICES //comprobamos si hay que aplicar el factor a los límites if(aplicaLim&&poli->hayLim) { //aplicamos los factores de escala y las traslaciones a los límites EscalaYTrasladaVector(poli->xMin,poli->nPolig,1,escalaX,trasladaX); EscalaYTrasladaVector(poli->xMax,poli->nPolig,1,escalaX,trasladaX); EscalaYTrasladaVector(poli->yMin,poli->nPolig,1,escalaY,trasladaY); EscalaYTrasladaVector(poli->yMax,poli->nPolig,1,escalaY,trasladaY); } //comprobamos si hay que aplicar el factor a las superficies if(aplicaArea&&poli->hayArea) { //aplicamos el factor de escala a las áreas EscalaYTrasladaVector(poli->area,poli->nPolig,1,fabs(escalaX*escalaY), 0.0); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void TrasladaYEscalaPolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim, const int aplicaArea) { //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli) #endif { #if defined(_OPENMP) #pragma omp section #endif //aplicamos las traslaciones y los factores de escala a las coordenadas X TrasladaYEscalaVector(poli->x,poli->nElem,1,escalaX,trasladaX); #if defined(_OPENMP) #pragma omp section #endif //aplicamos las traslaciones y los factores de escala a las coordenadas Y TrasladaYEscalaVector(poli->y,poli->nElem,1,escalaY,trasladaY); } // --> fin del #pragma omp parallel sections //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ESTA PARTE NO LA PARALELIZAMOS, YA QUE SUPONEMOS QUE EL NÚMERO DE //POLÍGONOS EN UNA ESTRUCTURA SIEMPRE SERÁ MUCHÍSIMO MENOR QUE EL NÚMERO //TOTAL DE VÉRTICES //comprobamos si hay que aplicar el factor a los límites if(aplicaLim&&poli->hayLim) { //aplicamos las traslaciones y los factores de escala a los límites TrasladaYEscalaVector(poli->xMin,poli->nPolig,1,escalaX,trasladaX); TrasladaYEscalaVector(poli->xMax,poli->nPolig,1,escalaX,trasladaX); TrasladaYEscalaVector(poli->yMin,poli->nPolig,1,escalaY,trasladaY); TrasladaYEscalaVector(poli->yMax,poli->nPolig,1,escalaY,trasladaY); } //comprobamos si hay que aplicar el factor a las superficies if(aplicaArea&&poli->hayArea) { //aplicamos el factor de escala a las áreas TrasladaYEscalaVector(poli->area,poli->nPolig,1,fabs(escalaX*escalaY), 0.0); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void MuevePolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int orden, const int aplicaLim, const int aplicaArea) { //comprobamos el orden de aplicación de los factores if(orden==0) { //primero los factores de escala y luego las traslaciones EscalaYTrasladaPolig(poli,escalaX,escalaY,trasladaX,trasladaY,aplicaLim, aplicaArea); } else { //primero las traslaciones y luego los factores de escala TrasladaYEscalaPolig(poli,escalaX,escalaY,trasladaX,trasladaY,aplicaLim, aplicaArea); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int AligeraPolig(polig* poli, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto) { //índices para recorrer bucles size_t i=0,j=0; //posición inicial del polígono de trabajo y número de puntos del aligerado size_t posIni=0,nPtos=0; //puntos colineales int colin=0; //coordenadas de los polígonos aligerados double* x=NULL; double* y=NULL; //estructura auxiliar polig* aux=NULL; //vector de posiciones después del aligerado size_t* pos=NULL; //variable de salida int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos una posible salida rápida if(poli->nPolig==0) { //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar vacía aux = IniciaPoligVacio(); //comprobamos los posibles errores if(aux==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos el número de polígonos almacenados for(i=0;inPolig;i++) { //extraemos la posición inicial del polígono de trabajo posIni = poli->posIni[i]; //aligeramos el polígono de trabajo pos = AligeraPolilinea(&(poli->x[posIni]),&(poli->y[posIni]), poli->nVert[i],1,1,tol,robusto,nPtosRobusto, nSegRobusto,&nPtos); //comprobamos posibles errores if(pos==NULL) { //liberamos la memoria asignada LibMemPolig(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //comprobamos si el polígono se ha quedado en tres puntos if(nPtos==3) { //comprobamos si los tres puntos son colineales colin = TresPuntosColineales2D(poli->x[posIni+pos[0]], poli->y[posIni+pos[0]], poli->x[posIni+pos[1]], poli->y[posIni+pos[1]], poli->x[posIni+pos[2]], poli->y[posIni+pos[2]]); } //comprobamos si después del aligerado queda algún polígono if((nPtos>3)||((nPtos==3)&&(!colin))) { //asignamos memoria para los vectores de coordenadas del polígono //aligerado x = (double*)malloc(nPtos*sizeof(double)); y = (double*)malloc(nPtos*sizeof(double)); //comprobamos posibles errores if((x==NULL)||(y==NULL)) { //liberamos la memoria asignada LibMemPolig(aux); free(pos); free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //recorremos el número de puntos del polígono aligerado for(j=0;jx[posIni+pos[j]]; y[j] = poli->y[posIni+pos[j]]; } //añadimos las coordenadas al polígono aligerado estado = AnyadeDatosPolig(aux,x,y,nPtos,1,1); //sólo puede haber ocurrido un error de asignación de memoria, ya //que suponemos que el polígono de entrada es correcto if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); free(pos); free(x); free(y); //escribimos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //liberamos la memoria asignada a los vectores de coordenadas free(x); free(y); } //liberamos la memoria asignada al vector de posiciones del aligerado free(pos); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que calcular límites if(poli->hayLim) { //calculamos los límites estado = CalcLimitesPolig(aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //comprobamos si hay que calcular superficies if(poli->hayArea) { //calculamos las áreas estado = CalcAreaPolig(aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //enlazamos los campos de la estructura auxiliar a los de la estructura de //salida EnlazaCamposPolig(aux,poli); //liberamos la memoria asignada a la estructura auxiliar (pero no a sus //campos) free(aux); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ void ImprimeCabeceraPoligFichero(const polig* poli, const size_t indice, const char iniCab[], const int impLim, const char formCoor[], const int impArea, const char formArea[], const double factorX, const double factorY, const int repitePrimerPunto, FILE* idFich) { //número de vértices del polígono de trabajo size_t nVert=0; //superficie de los polígonos double area=0.0; //límites double xMin=0.0,xMax=0.0,yMin=0.0,yMax=0.0,limAux=0.0; //variables de posición size_t pos=0,posXMin=0,posXMax=0,posYMin=0,posYMax=0; //variable auxiliar size_t aux=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //ajustamos la variable auxiliar como el posible número a restar si no hay //que repetir el primer vértice del polígono aux = (repitePrimerPunto) ? 0 : 1; //número de vértices a imprimir del polígono nVert = poli->nVert[indice]-aux; //posición de inicio del polígono pos = poli->posIni[indice]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //imprimimos la marca de inicio y el número de vértices fprintf(idFich,"%s %8zu",iniCab,nVert); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que imprimir la superficie if(impArea) { //comprobamos si ya está calculada la superficie o no if(poli->hayArea) { //aplicamos los factores de escala y extraemos la superficie area = poli->area[indice]*fabs(factorX)*fabs(factorY); } else { //calculamos la superficie area = AreaPoligonoSimple(&(poli->x[pos]),&(poli->y[pos]), poli->nVert[indice],1,1); //aplicamos los factores de escala area *= fabs(factorX)*fabs(factorY); } //imprimimos el valor de la superficie fprintf(idFich," "); fprintf(idFich,formArea,area); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si hay que imprimir los límites if(impLim) { //comprobamos si ya están calculados los límites if(poli->hayLim) { //extraemos los límites xMin = poli->xMin[indice]; xMax = poli->xMax[indice]; yMin = poli->yMin[indice]; yMax = poli->yMax[indice]; } else { //buscamos las posiciones de los elementos máximo y mínimo //paralelización con OpenMP #if defined(_OPENMP) #pragma omp parallel sections default(none) \ shared(poli,pos,nVert,posXMin,posXMax,posYMin,posYMax) #endif { //posiciones en el vector X #if defined(_OPENMP) #pragma omp section #endif MinMax(&(poli->x[pos]),nVert,1,&posXMin,&posXMax); //posiciones en el vector Y #if defined(_OPENMP) #pragma omp section #endif MinMax(&(poli->y[pos]),nVert,1,&posYMin,&posYMax); } // --> fin del #pragma omp parallel sections //extraemos los valores extremos xMin = poli->x[pos+posXMin]; xMax = poli->x[pos+posXMax]; yMin = poli->y[pos+posYMin]; yMax = poli->y[pos+posYMax]; } //comprobamos si el factor de escala para X es negativo if(factorX<0.0) { //los límites cambian limAux = xMin; xMin = xMax; xMax = limAux; //aplicamos el factor de escala xMin *= factorX; xMax *= factorX; } //comprobamos si el factor de escala para Y es negativo if(factorY<0.0) { //los límites cambian limAux = yMin; yMin = yMax; yMax = limAux; //aplicamos el factor de escala yMin *= factorY; yMax *= factorY; } //imprimimos los límites fprintf(idFich," "); fprintf(idFich,formCoor,xMin); fprintf(idFich," "); fprintf(idFich,formCoor,xMax); fprintf(idFich," "); fprintf(idFich,formCoor,yMin); fprintf(idFich," "); fprintf(idFich,formCoor,yMax); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salto de línea final fprintf(idFich,"\n"); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void ImprimePoligFichero(const polig* poli, const double factorX, const double factorY, const int repitePrimerPunto, const int iniNan, const int finNan, const char formCoor[], const int impCabecera, const char iniCab[], const int impLim, const int impArea, const char formArea[], FILE* idFich) { //índices para recorrer bucles size_t i=0,j=0; //cadena de formato para imprimir los posibles valores NaN char formNan[GEOC_NAN_LON_FORM_NUM_SIMPLE+1]; //variable de posición size_t pos=0; //variable auxiliar size_t aux=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si la estructura contiene algún polígono if(poli->nPolig==0) { //salimos sin imprimir nada return; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la cadena de formato para imprimir los polibles NaN FormatoNumFormatoTexto(formCoor,formNan); //ajustamos la variable auxiliar como el posible número a restar si no hay //que repetir el primer vértice de los polígonos aux = (repitePrimerPunto) ? 0 : 1; //comprobamos si hay que imprimir la marca separadora al principio if(iniNan) { //la imprimimos ImprimeGeocNanTexto(idFich,2,formNan,1); } //recorremos el número de polígonos for(i=0;inPolig;i++) { //comprobamos si hay que imprimir la cabecera if(impCabecera) { //imprimos la cabecera ImprimeCabeceraPoligFichero(poli,i,iniCab,impLim,formCoor,impArea, formArea,factorX,factorY, repitePrimerPunto,idFich); } //posición del punto inicial del polígono pos = poli->posIni[i]; //recorremos el número de vértices del polígono de trabajo for(j=0;j<(poli->nVert[i]-aux);j++) { //imprimimos las coordenadas, multiplicadas por los factores fprintf(idFich,formCoor,factorX*poli->x[pos+j]); fprintf(idFich,formCoor,factorY*poli->y[pos+j]); fprintf(idFich,"\n"); } //imprimimos la marca separadora al final (menos para el último) if(i!=(poli->nPolig-1)) { ImprimeGeocNanTexto(idFich,2,formNan,1); } } //comprobamos si hay que imprimir la marca separadora al final if(finNan) { //la imprimimos ImprimeGeocNanTexto(idFich,2,formNan,1); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/Makefile000644 001750 001750 00000002517 12540021550 015407 0ustar00topotopo000000 000000 # -*- coding: utf-8 -*- #Compiler MKOCTFILE=mkoctfile #Common warning flags for C and C++ FLAGSCOMW=-Wall -Wextra -Wshadow -Wcast-qual -Wcast-align -Wwrite-strings #Common optimization flags for C and C++ FLAGSCOMO=-O2 -funroll-loops -fno-common -fshort-enums #Flags for C CFLAGS=-std=c99 -pedantic $(FLAGSCOMW) -Wconversion -Wmissing-prototypes CFLAGS+=-Wstrict-prototypes -Wnested-externs $(FLAGSCOMO) #Flags for C++ CXXFLAGS=$(FLAGSCOMW) $(FLAGSCOMO) #Export flags for compilers and linker export CFLAGS CXXFLAGS .PHONY: all all: compile .PHONY: compile compile: $(MKOCTFILE) -c -I. calctopo.c -o calctopo.o $(MKOCTFILE) -c -I. compilador.c -o compilador.o $(MKOCTFILE) -c -I. dpeucker.c -o dpeucker.o $(MKOCTFILE) -c -I. errores.c -o errores.o $(MKOCTFILE) -c -I. eucli.c -o eucli.o $(MKOCTFILE) -c -I. fgeneral.c -o fgeneral.o $(MKOCTFILE) -c -I. geocnan.c -o geocnan.o $(MKOCTFILE) -c -I. geocomp.c -o geocomp.o $(MKOCTFILE) -c -I. greiner.c -o greiner.o $(MKOCTFILE) -c -I. polig.c -o polig.o $(MKOCTFILE) -c -I. polil.c -o polil.o $(MKOCTFILE) -c -I. ptopol.c -o ptopol.o $(MKOCTFILE) -c -I. recpolil.c -o recpolil.o $(MKOCTFILE) -c -I. segmento.c -o segmento.o $(MKOCTFILE) -c -I. ventorno.c -o ventorno.o $(MKOCTFILE) -s -I. _oc_polybool.cc *.o .PHONY: clean clean: rm -rf *.o *~ .PHONY: cleanall cleanall: rm -rf *~ *.o *.oct octclip-1.0.8/src/errores.c000755 001750 001750 00000013535 12540021550 015601 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup anespec errores eop fichero general geodesia geom geopot gshhs marea \ingroup matriz mmcc orden snx texto @{ \file errores.c \brief Definición de funciones para el tratamiento de errores. En el momento de la compilación ha de seleccionarse el comportamiento de la función \ref GeocError. Para realizar la selección es necesario definir las variables para el preprocesador \em ESCRIBE_MENSAJE_ERROR si se quiere que la función imprima un mensaje de error y/o \em FIN_PROGRAMA_ERROR si se quiere que la función termine la ejecución del programa en curso. Si no se define ninguna variable, la función no ejecuta ninguna acción. En \p gcc, las variables para el preprocesador se pasan como \em -DXXX, donde \em XXX es la variable a introducir. \author José Luis García Pallero, jgpallero@gmail.com \date 09 de enero de 2011 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/errores.h" /******************************************************************************/ /******************************************************************************/ int GeocTipoError(void) { //variable de salida int valor=GEOC_TIPO_ERR_NADA; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //distinguimos los posibles casos según las variables del preprocesador #if defined(ESCRIBE_MENSAJE_ERROR) && defined(FIN_PROGRAMA_ERROR) //mensaje de error y terminación del programa valor = GEOC_TIPO_ERR_MENS_Y_EXIT; #elif defined(ESCRIBE_MENSAJE_ERROR) //mensaje de error valor = GEOC_TIPO_ERR_MENS; #elif defined(FIN_PROGRAMA_ERROR) //terminación del programa valor = GEOC_TIPO_ERR_EXIT; #endif //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return valor; } /******************************************************************************/ /******************************************************************************/ void GeocError(const char mensaje[], const char funcion[]) { //hacemos una copia para que en la compilación no dé warning si sólo se //termina la ejecución del programa o no se hace nada mensaje = mensaje; funcion = funcion; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //distinguimos los posibles casos según las variables del preprocesador #if defined(ESCRIBE_MENSAJE_ERROR) && defined(FIN_PROGRAMA_ERROR) //imprimimos el nombre de la función y el mensaje fprintf(stderr,"En la función '%s'\n",funcion); fprintf(stderr,"%s\n",mensaje); //indicamos que el programa finalizará fprintf(stderr,"El programa finalizará mediante la llamada a la función " "'exit(EXIT_FAILURE)'\n"); //detenemos la ejecución del programa exit(EXIT_FAILURE); #elif defined(ESCRIBE_MENSAJE_ERROR) //imprimimos el nombre de la función y el mensaje fprintf(stderr,"En la función '%s'\n",funcion); fprintf(stderr,"%s\n",mensaje); //salimos de la función return; #elif defined(FIN_PROGRAMA_ERROR) //indicamos que el programa finalizará fprintf(stderr,"El programa finalizará mediante la llamada a la función " "'exit(EXIT_FAILURE)'\n"); //detenemos la ejecución del programa exit(EXIT_FAILURE); #else //salimos de la función return; #endif } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/greiner.c000755 001750 001750 00000227725 12540021550 015563 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file greiner.c \brief Definición de funciones para el recorte de polígonos mediante el algoritmo de Greiner-Hormann (http://davis.wpi.edu/~matt/courses/clipping/). \author José Luis García Pallero, jgpallero@gmail.com \date 14 de mayo de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/greiner.h" /******************************************************************************/ /******************************************************************************/ vertPoliClip* CreaVertPoliClip(const double x, const double y, vertPoliClip* anterior, vertPoliClip* siguiente, vertPoliClip* vecino, const char ini, const char interseccion, const char entrada, const char visitado, const double alfa) { //variable de salida (nuevo vértice) vertPoliClip* nuevoVert=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos memoria para el nuevo vértice nuevoVert = (vertPoliClip*)malloc(sizeof(vertPoliClip)); //comprobamos los posibles errores if(nuevoVert==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos los vértices anterior y posterior nuevoVert->anterior = anterior; nuevoVert->siguiente = siguiente; //si anterior es un vértice bueno if(anterior!=NULL) { //lo apuntamos al vértice creado nuevoVert->anterior->siguiente = nuevoVert; } //si siguiente es un vértice bueno if(siguiente!=NULL) { //indicamos que el vértice creado es el anterior nuevoVert->siguiente->anterior = nuevoVert; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el resto de campos nuevoVert->x = x; nuevoVert->y = y; nuevoVert->xP = x; nuevoVert->yP = y; nuevoVert->vecino = vecino; nuevoVert->ini = ini; nuevoVert->interseccion = interseccion; nuevoVert->entrada = entrada; nuevoVert->visitado = visitado; nuevoVert->alfa = alfa; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return nuevoVert; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* CreaPoliClip(const double* x, const double* y, const size_t nCoor, const size_t incX, const size_t incY) { //índice para recorrer bucles size_t i=0; //variables auxiliares de posición size_t posIni=0,posFin=0; //otra variable auxiliar int hayVert=0; //estructura auxiliar vertPoliClip* aux=NULL; //variable de salida vertPoliClip* poli=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //buscamos el primer punto que sea distinto de NaN for(i=0;isiguiente; //liberamos la memoria free(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* ReiniciaPoliClip(vertPoliClip* poli) { //estructura que apunta al espacio en memoria a liberar vertPoliClip* borra=NULL; //estructura auxiliar vertPoliClip* aux=NULL; //estructura de salida vertPoliClip* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar aux = poli; //comprobamos una posible salida rápida if(aux==NULL) { //salimos de la función return NULL; } //buscamos para la estructura de salida el primer vértice que no sea una //intersección while(aux!=NULL) { //comprobamos si estamos ante un vértice bueno if(aux->interseccion==0) { //asignamos la variable de salida sal = aux; //salimos del bucle break; } //siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //volvemos a inicializar la variable auxiliar aux = poli; //mientras la variable de trabajo no apunte a NULL while(aux!=NULL) { //comprobamos si estamos ante un vértice a borrar if(aux->interseccion) { //lo almacenamos en la estructura de borrado borra = aux; //actualizamos el puntero de vértice siguiente if(aux->anterior!=NULL) { //cuando el vértice a borrar no es el primero de la lista aux->anterior->siguiente = aux->siguiente; } else if(aux->siguiente!=NULL) { //cuando el vértice a borrar es el primero de la lista aux->siguiente->anterior = NULL; } //actualizamos el puntero de vértice anterior if(aux->siguiente!=NULL) { //cuando el vértice a borrar no es el último de la lista aux->siguiente->anterior = aux->anterior; } else if(aux->anterior!=NULL) { //cuando el vértice a borrar es el último de la lista aux->anterior->siguiente = NULL; } //apuntamos al siguiente elemento aux = aux->siguiente; //liberamos la memoria free(borra); } else { //reinicializamos el resto de miembros, menos las coordenadas //originales y el identificador de primer elemento aux->xP = aux->x; aux->yP = aux->y; aux->vecino = NULL; aux->interseccion = 0; aux->entrada = 0; aux->visitado = 0; aux->alfa = 0.0; //siguiente elemento aux = aux->siguiente; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* ReiniciaVerticesPoliClip(vertPoliClip* poli) { //estructura auxiliar vertPoliClip* aux=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura de auxiliar con la dirección de entrada aux = poli; //mientras no lleguemos al final while(aux!=NULL) { //vamos poniendo a 0 el campo 'visitado' aux->visitado = 0; //vamos poniendo a 0 el campo 'entrada' aux->entrada = 0; //nos posicionamos en el siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return poli; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* SiguienteVertOrigPoliClip(vertPoliClip* vert) { //variable de salida, que inicializamos con la dirección de entrada vertPoliClip* sal=vert; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si estamos ante un vértice original, pasamos al siguiente if((sal!=NULL)&&(sal->interseccion==0)) { //apuntamos al siguiente vértice sal = sal->siguiente; } //vamos rechazando intersecciones (el bucle se para cuando llegamos al final //o a un vértice que no es intersección) while((sal!=NULL)&&(sal->interseccion!=0)) { //pasamos al siguiente vértice sal = sal->siguiente; } //si hemos llegado a un vértice que no es original, apuntamos a NULL if((sal!=NULL)&&(sal->interseccion!=0)) { //asignamos NULL sal = NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* SiguienteIntersecNoVisitadaPoliClip(vertPoliClip* vert) { //variable de salida, que inicializamos con la dirección de entrada vertPoliClip* sal=vert; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si estamos ante una intersección no visitada o ante el vértice original //del polígono, pasamos al siguiente vértice if((sal!=NULL)&& (((sal->interseccion!=0)&&(sal->visitado==0))||(sal->ini!=0))) { //apuntamos al siguiente vértice sal = sal->siguiente; } //vamos rechazando vértices originales e intersecciones visitadas: el bucle //se para cuando llegamos al final (si la lista no es circular), cuando //volvamos al principio (si la lista es circular) o cuando lleguemos a una //intersección no visitada while(((sal!=NULL)&&(sal->ini==0))&& ((sal->interseccion==0)|| ((sal->interseccion!=0)&&(sal->visitado!=0)))) { //pasamos al siguiente vértice sal = sal->siguiente; } //si hemos llegado a un vértice que no es una intersección no visitada o es //de nuevo el punto inicial (lista circular), apuntamos a NULL if((sal!=NULL)&& (((sal->interseccion!=0)&&(sal->visitado!=0))||(sal->ini!=0))) { //asignamos NULL sal = NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* UltimoVertPoliClip(vertPoliClip* poli) { //variable de salida, que inicializamos con la dirección de entrada vertPoliClip* sal=poli; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //sólo trabajamos si la entrada es distinta de NULL if(sal!=NULL) { //mientras el siguiente vértice sea distinto de NULL while(sal->siguiente!=NULL) { //avanzamos un vértice sal = sal->siguiente; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ void InsertaVertPoliClip(vertPoliClip* ins, vertPoliClip* extremoIni, vertPoliClip* extremoFin) { //estructura auxiliar vertPoliClip* aux=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el vértice auxiliar como el extremo inicial pasado aux = extremoIni; //mientras no lleguemos al extremo final y el punto a insertar esté más //lejos del origen que el punto de trabajo while((aux!=extremoFin)&&((aux->alfa)<=(ins->alfa))) { //avanzamos al siguiente vértice aux = aux->siguiente; } //insertamos el punto y ordenamos los punteros de vértices anterior y //posterior ins->siguiente = aux; ins->anterior = aux->anterior; ins->anterior->siguiente = ins; ins->siguiente->anterior = ins; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ vertPoliClip* CierraPoliClip(vertPoliClip* poli) { //estructura auxiliar vertPoliClip* aux=NULL; //variable de salida: último vértice de la lista original vertPoliClip* ultimo=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si se ha pasado NULL if(poli==NULL) { //salimos de la función return NULL; } //buscamos el último vértice de la lista original ultimo = UltimoVertPoliClip(poli); //almacenamos el penúltimo vértice en la estructura auxiliar aux = ultimo->anterior; //apuntamos el penúltimo vértice al primero aux->siguiente = poli; //le decimos al primer vértice cuál es el anterior aux->siguiente->anterior = aux; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return ultimo; } /******************************************************************************/ /******************************************************************************/ void AbrePoliClip(vertPoliClip* poli, vertPoliClip* ultimo) { //estructuras auxiliares vertPoliClip* aux=poli; vertPoliClip* ult=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //buscamos el vértice inicial while((aux!=NULL)&&(aux->ini==0)) { //pasamos al siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //último vértice ult = aux->anterior; //le decimos al falso último vértice cuál es el último verdadero ult->siguiente = ultimo; //ajustamos los parámetros del nuevo último vértice ultimo->anterior = ult; ultimo->siguiente = NULL; //le decimos al primer vértice que el anterior es NULL aux->anterior = NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoliClip(const double x, const double y, vertPoliClip* poli) { //estructuras auxiliares vertPoliClip* aux=NULL; vertPoliClip* aux1=NULL; //coordenadas auxiliares double x1=0.0,y1=0.0,x2=0.0,y2=0.0; //variable de salida int c=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //comprobamos si no es un vértice original if(aux->interseccion!=0) { //nos posicionamos en el siguiente vértice original aux = SiguienteVertOrigPoliClip(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //entramos en un bucle infinito while(1) { //nos posicionamos en el siguiente vértice original aux1 = SiguienteVertOrigPoliClip(aux); //sólo continuamos si el siguiente vértice no es NULL if(aux1!=NULL) { //extraemos las coordenadas de trabajo x1 = aux->xP; y1 = aux->yP; x2 = aux1->xP; y2 = aux1->yP; //actalizamos el vértice inicial de trabajo para la siguiente vuelta aux = aux1; //calculamos if(((y1>y)!=(y2>y))&&(x<(x2-x1)*(y-y1)/(y2-y1)+x1)) { c = !c; } } else { //salimos del bucle break; } } //asignamos el elemento de salida if(c) { //el punto está dentro del polígono c = GEOC_PTO_DENTRO_POLIG; } else { //el punto está fuera del polígono c = GEOC_PTO_FUERA_POLIG; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return c; } /******************************************************************************/ /******************************************************************************/ int PtoEnPoliClipVertice(const double x, const double y, vertPoliClip* poli) { //estructura auxiliar vertPoliClip* aux=NULL; //variable de salida, que inicializamos fuera del polígono int pos=GEOC_PTO_FUERA_POLIG; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //comprobamos si no es un vértice original if(aux->interseccion!=0) { //nos posicionamos en el siguiente vértice original aux = SiguienteVertOrigPoliClip(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si el punto es un vértice while(aux!=NULL) { //comprobamos si las coordenadas coinciden if((aux->xP==x)&&(aux->yP==y)) { //indicamos que el punto es un vértice pos = GEOC_PTO_VERTICE_POLIG; //salimos del bucle break; } //nos posicionamos en el siguiente vértice original aux = SiguienteVertOrigPoliClip(aux); } //sólo continuamos si el punto no es un vértice if(pos!=GEOC_PTO_VERTICE_POLIG) { //calculamos la posición sin tener en cuenta el borde pos = PtoEnPoliClip(x,y,poli); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return pos; } /******************************************************************************/ /******************************************************************************/ size_t NumeroVertOrigPoliClip(vertPoliClip* poli) { //estructura auxiliar vertPoliClip* aux=NULL; //variable de salida size_t num=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //comprobamos si estamos ante un vértice original if(aux->interseccion!=0) { //si no es un vértice original, nos posicionamos en el siguiente que sí //lo sea aux = SiguienteVertOrigPoliClip(aux); } //mientras no lleguemos al final while(aux!=NULL) { //aumentamos el contador de vértices originales num++; //nos posicionamos en el siguiente vértice original aux = SiguienteVertOrigPoliClip(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return num; } /******************************************************************************/ /******************************************************************************/ size_t NumeroVertPoliClip(vertPoliClip* poli) { //estructura auxiliar vertPoliClip* aux=NULL; //variable de salida size_t num=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //mientras no lleguemos al final while(aux!=NULL) { //aumentamos el contador de vértices num++; //nos posicionamos en el siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return num; } /******************************************************************************/ /******************************************************************************/ double CantPerturbMin(const double x, const double factor) { //valor absoluto del argumento de entrada double xAbs=fabs(x); //variable auxiliar double aux=0.0; //variable de salida, que inicializamos como el épsilon para el tipo de dato double sal=fabs(DBL_EPSILON); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //mientras la variable auxiliar sea igual a la de antrada (la primera vuelta //del bucle se ejecuta siempre) do { //escalamos la variable de salida sal *= factor; //sumamos el nuevo valor a la coordenada de entrada //esta suma es necesario realizarla aquí, en lugar de en la propia //comparación del while, para obligar al resultado a almacenarse en una //variable y evitar errores porque las variables intermedias de la //comparación puede que se almacenen en registros de más precisión que //el tipo de dato aux = xAbs+sal; }while(aux==xAbs); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ double PerturbaPuntoMin(const double x, const double factor) { //variable para almacenar un número seudoaleatorio int aleat=0; //cantidad perturbadora double perturb=0.0; //signo para multiplicar por la cantidad perturbadora double signo=0.0; //variable de salida double sal=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //plantamos la semilla para la función rand() srand((unsigned int)time(NULL)); //generamos el número seudoaleatorio aleat = rand(); //calculamos el signo para la multiplicación, basándonos en la paridad del //número seudoaleatorio generado: si es par vale 1 y si es impar -1 signo = (aleat%2) ? -1.0 : 1.0; //calculamos la cantidad perturbadora perturb = CantPerturbMin(x,factor); //perturbamos la coordenada sal = x+signo*perturb; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ int Paso1Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const double facPer, size_t* nIntersec, size_t* nPerturb) { //estructuras auxiliares que apuntan a los polígonos pasados vertPoliClip* auxA=NULL; vertPoliClip* auxC=NULL; //estructuras auxiliares para trabajar con el siguiente vértice vertPoliClip* auxB=NULL; vertPoliClip* auxD=NULL; //vértices de intersección a insertar vertPoliClip* insBas=NULL; vertPoliClip* insRec=NULL; //coordenadas de la intersección de dos segmentos double xI=0.0,yI=0.0; //longitudes de segmentos y parámetros alfa double lonAB=0.0,lonCD=0.0,alfaAB=0.0,alfaCD=0.0; //código de intersección de segmentos int intersec=0; //variable de salida int salida=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el número de intersecciones a 0 *nIntersec = 0; //inicializamos el número de puntos perturbados a 0 *nPerturb = 0; //EL PRIMER PASO DEL ALGORITMO DE GREINER-HORMANN ES EL CÁLCULO DE TODOS LOS //PUNTOS DE INTERSECCIÓN ENTRE LOS POLÍGONOS //recorremos los vértices del polígono base for(auxA=poliBas;auxA->siguiente!=NULL;auxA=auxA->siguiente) { //sólo trabajamos si el vértice es original if(auxA->interseccion==0) { //recorremos los vértices del polígono de recorte for(auxC=poliRec;auxC->siguiente!=NULL;auxC=auxC->siguiente) { //sólo trabajamos si el vértice es original if(auxC->interseccion==0) { //siguiente vértice de los segmentos auxB = SiguienteVertOrigPoliClip(auxA); auxD = SiguienteVertOrigPoliClip(auxC); //calculamos la intersección de los segmentos intersec = IntersecSegmentos2D(auxA->xP,auxA->yP,auxB->xP, auxB->yP,auxC->xP,auxC->yP, auxD->xP,auxD->yP,&xI,&yI); //perturbamos las coordenadas de los extremos de los //segmentos mientras haya una intersección no limpia while((intersec!=GEOC_SEG_NO_INTERSEC)&& (intersec!=GEOC_SEG_INTERSEC)) { //distinguimos entre intersecciones donde sólo se toca //un extremo e intersecciones colineales donde se //comparte más de un punto if((intersec==GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN)|| (intersec==GEOC_SEG_INTERSEC_EXTREMO_COLIN)) { if((xI==auxC->xP)&&(yI==auxC->yP)) { //perturbamos el extremo C auxC->xP = PerturbaPuntoMin(auxC->x,facPer); auxC->yP = PerturbaPuntoMin(auxC->y,facPer); //aumentamos el contador de puntos perturbados (*nPerturb)++; } else if((xI==auxD->xP)&&(yI==auxD->yP)) { //perturbamos el extremo D auxD->xP = PerturbaPuntoMin(auxD->x,facPer); auxD->yP = PerturbaPuntoMin(auxD->y,facPer); //aumentamos el contador de puntos perturbados (*nPerturb)++; } else { //si el punto de contacto es un extremo de AB y //los segmentos no son paralelos, perturbamos //todo el segmento CD auxC->xP = PerturbaPuntoMin(auxC->x,facPer); auxC->yP = PerturbaPuntoMin(auxC->y,facPer); auxD->xP = PerturbaPuntoMin(auxD->x,facPer); auxD->yP = PerturbaPuntoMin(auxD->y,facPer); //aumentamos el contador de puntos perturbados (*nPerturb) += 2; } } else if((intersec==GEOC_SEG_INTERSEC_MISMO_SEG)|| (intersec==GEOC_SEG_INTERSEC_COLIN)) { //perturbamos todo el segmento CD auxC->xP = PerturbaPuntoMin(auxC->x,facPer); auxC->yP = PerturbaPuntoMin(auxC->y,facPer); auxD->xP = PerturbaPuntoMin(auxD->x,facPer); auxD->yP = PerturbaPuntoMin(auxD->y,facPer); //aumentamos el contador de puntos perturbados (*nPerturb) += 2; } //volvemos a calcular la intersección de los segmentos intersec = IntersecSegmentos2D(auxA->xP,auxA->yP, auxB->xP,auxB->yP, auxC->xP,auxC->yP, auxD->xP,auxD->yP, &xI,&yI); } //comprobamos si los segmentos se cortan limpiamente if(intersec==GEOC_SEG_INTERSEC) { //aumentamos el contador de intersecciones (*nIntersec)++; //calculamos las longitudes de los segmentos lonAB = Dist2D(auxA->xP,auxA->yP,auxB->xP,auxB->yP); lonCD = Dist2D(auxC->xP,auxC->yP,auxD->xP,auxD->yP); //calculamos los parámetros alfa alfaAB = Dist2D(auxA->xP,auxA->yP,xI,yI)/lonAB; alfaCD = Dist2D(auxC->xP,auxC->yP,xI,yI)/lonCD; //creamos los nuevos vértices a insertar insBas = CreaVertPoliClip(xI,yI,NULL,NULL,NULL,0,1,0,0, alfaAB); insRec = CreaVertPoliClip(xI,yI,NULL,NULL,NULL,0,1,0,0, alfaCD); //comprobamos los posibles errores if((insBas==NULL)||(insRec==NULL)) { //liberamos la memoria previamente asignada free(insBas); free(insRec); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //asignamos el código de error salida = GEOC_ERR_ASIG_MEMORIA; //salimos de la función return salida; } //enlazamos los vértices mediante el campo 'vecino' insBas->vecino = insRec; insRec->vecino = insBas; //los insertamos en los polígonos InsertaVertPoliClip(insBas,auxA,auxB); InsertaVertPoliClip(insRec,auxC,auxD); } } } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ void Paso2Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIG op) { //estructuras auxiliares que apuntan a los polígonos pasados vertPoliClip* auxA=NULL; vertPoliClip* auxC=NULL; //identificador de si una intersección es de entrada o salida char entrada=0; //variables auxiliares char entA=0,entC=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos los valores iniciales a los identificadores de intersección switch(op) { //distinguimos los tipos de operación case GeocOpBoolInter: //intersección entA = 1; entC = 1; break; case GeocOpBoolUnion: //unión entA = 0; entC = 0; break; case GeocOpBoolAB: //A-B entA = 0; entC = 1; break; case GeocOpBoolBA: //B-A entA = 1; entC = 0; break; default: //por defecto, intersección entA = 1; entC = 1; break; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //EL SEGUNDO PASO DEL ALGORITMO DE GREINER-HORMANN ES LA IDENTIFICACIÓN DE //INTERSECCIONES COMO ENTRADA-SALIDA //comprobamos si el primer punto del polígono base está fuera del polígono //de recorte if(PtoEnPoliClipVertice(poliBas->xP,poliBas->yP,poliRec)) { //si el punto está fuera, la siguiente intersección es de entrada entrada = !entA; } else { entrada = entA; } //recorremos los vértices del polígono de recorte for(auxA=poliBas;auxA->siguiente!=NULL;auxA=auxA->siguiente) { //sólo trabajamos si el vértice es intersección if(auxA->interseccion!=0) { //indicamos la dirección auxA->entrada = entrada; //actualizamos la variable de entrada para la siguiente vuelta entrada = !entrada; } } //comprobamos si el primer punto del polígono de recorte está fuera del //polígono base if(PtoEnPoliClipVertice(poliRec->xP,poliRec->yP,poliBas)) { //si el punto está fuera, la siguiente intersección es de entrada entrada = !entC; } else { entrada = entC; } //recorremos los vértices del polígono base for(auxC=poliRec;auxC->siguiente!=NULL;auxC=auxC->siguiente) { //sólo trabajamos si el vértice es intersección if(auxC->interseccion!=0) { //indicamos la dirección auxC->entrada = entrada; //actualizamos la variable de entrada para la siguiente vuelta entrada = !entrada; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ polig* Paso3Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec) { //vértices colgados al cerrar los polígonos vertPoliClip* ultBas=NULL; vertPoliClip* ultRec=NULL; //estructura auxiliar vertPoliClip* aux=NULL; //vectores de coordenadas de los vértices del resultado double* x=NULL; double* y=NULL; //número de elementos de los vectores x e y size_t nPtos=0; //número de elementos para los que ha sido asignada memoria size_t nElem=0; //variable de estado int estado=GEOC_ERR_NO_ERROR; //polígono de salida polig* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //cerramos los polígonos, convirtiéndolos en listas circulares ultBas = CierraPoliClip(poliBas); ultRec = CierraPoliClip(poliRec); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //mientras queden intersecciones sin visitar while((aux = SiguienteIntersecNoVisitadaPoliClip(poliBas))!=NULL) { //aumentamos el contador de elementos para los vectores x e y en 2 //unidades: una para el marcador de inicio de polígono y la otra para //las coordenadas del primer vértice nPtos+=2; //comprobamos si hay que reasignar memoria a los vectores de coordenadas if(nPtos>nElem) { //actualizamos el número de elementos de los vectores de puntos nElem += GEOC_GREINER_BUFFER_PTOS; //reasignamos memoria para los vectores x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos si ha ocurrido algún error if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //reabrimos los polígonos AbrePoliClip(poliBas,ultBas); AbrePoliClip(poliRec,ultRec); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos el marcador NaN como identificador de comienzo de polígono x[nPtos-2] = GeocNan(); y[nPtos-2] = GeocNan(); //asignamos las coordenadas del punto de intersección x[nPtos-1] = aux->xP; y[nPtos-1] = aux->yP; //EN ESTE NIVEL SIEMPRE ESTAMOS ANTE UN PUNTO DE INTERSECCIÓN //mientras el punto no haya sido visitado con anterioridad do { //lo marcamos como visitado aux->visitado = 1; aux->vecino->visitado = 1; //comprobamos si el punto es de entrada o no if(aux->entrada!=0) { //mientras no encontremos otra intersección do { //caminamos en la lista hacia adelante aux = aux->siguiente; //aumentamos el contador de elementos para x e y nPtos++; //comprobamos si hay que reasignar memoria a los vectores de //coordenadas if(nPtos>nElem) { //actualizamos el número de elementos de los vectores de //puntos nElem += GEOC_GREINER_BUFFER_PTOS; //reasignamos memoria para los vectores x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos si ha ocurrido algún error if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //reabrimos los polígonos AbrePoliClip(poliBas,ultBas); AbrePoliClip(poliRec,ultRec); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos las coordenadas del punto de intersección x[nPtos-1] = aux->xP; y[nPtos-1] = aux->yP; } while(aux->interseccion==0); //mientras no sea intersección } else { ////mientras no encontremos otra intersección do { //caminamos hacia atrás aux = aux->anterior; //aumentamos el contador de elementos para x e y nPtos++; //comprobamos si hay que reasignar memoria a los vectores de //coordenadas if(nPtos>nElem) { //actualizamos el número de elementos de los vectores de //puntos nElem += GEOC_GREINER_BUFFER_PTOS; //reasignamos memoria para los vectores x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos si ha ocurrido algún error if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //reabrimos los polígonos AbrePoliClip(poliBas,ultBas); AbrePoliClip(poliRec,ultRec); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos las coordenadas del punto de intersección x[nPtos-1] = aux->xP; y[nPtos-1] = aux->yP; } while(aux->interseccion==0); //mientras no sea intersección } //saltamos al otro polígono aux = aux->vecino; }while(aux->visitado==0); //mientras el punto no haya sido visitado } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la estructura de salida resultado = CreaPolig(x,y,nPtos,1,1,&estado); //comprobamos los posibles errores if(resultado==NULL) { //liberamos la memoria asignada free(x); free(y); //reabrimos los polígonos AbrePoliClip(poliBas,ultBas); AbrePoliClip(poliRec,ultRec); //comprobamos el error if(estado==GEOC_ERR_ASIG_MEMORIA) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); } else { //mensaje de error GEOC_ERROR("Error en la llamada a 'CreaPolig()'\nEste error no " "puede producirse aquí porque los NaN deben estar " "bien puestos"); } //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //reabrimos los polígonos AbrePoliClip(poliBas,ultBas); AbrePoliClip(poliRec,ultRec); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria asignada free(x); free(y); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polig* PoliBoolGreiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIG op, const double facPer, size_t* nIntersec, size_t* nPerturb) { //factor de perturbación double factor=0.0; //variables de posición int posBas=0,posRec=0; //identificador de error int idError=GEOC_ERR_NO_ERROR; //polígono auxiliar polig* ba=NULL; //polígono de salida polig* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si se ha pasado factor de perturbación if(facPer<=1.0) { //utilizamos el valor por defecto factor = GEOC_GREINER_FAC_EPS_PERTURB; } else { //utilizamos el valor pasado factor = facPer; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //PRIMER PASO DEL ALGORITMO DE GREINER-HORMANN: CÁLCULO DE TODOS LOS PUNTOS //DE INTERSECCIÓN ENTRE LOS POLÍGONOS //calculamos los puntos de intersección idError = Paso1Greiner(poliBas,poliRec,factor,nIntersec,nPerturb); //comprobamos los posibles errores if(idError==GEOC_ERR_ASIG_MEMORIA) { //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso1Greiner'"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si no hay intersecciones if(!(*nIntersec)) { //calculo la situación relativa entre los polígonos posBas = PtoEnPoliClipVertice(poliBas->xP,poliBas->yP,poliRec); posRec = PtoEnPoliClipVertice(poliRec->xP,poliRec->yP,poliBas); //comprobamos las posibles situaciones relativas entre los polígonos que //pueden producir cero intersecciones if((posBas==GEOC_PTO_DENTRO_POLIG)||(posBas==GEOC_PTO_VERTICE_POLIG)) { //EL POLÍGONO BASE ESTÁ DENTRO DEL POLÍGONO DE RECORTE //distinguimos las operaciones (por defecto, intersección) if(op==GeocOpBoolUnion) { //el resultado es el polígono de recorte resultado = CreaPoligPoliClip(poliRec,0); } else if(op==GeocOpBoolAB) { //el resultado es un polígono vacío resultado = CreaPoligPoliClip(NULL,0); } else if((op==GeocOpBoolBA)||(op==GeocOpBoolXor)) { //el resultado son los dos polígonos //polígono base resultado = CreaPoligPoliClip(poliBas,0); //añadimos el polígono de recorte AnyadePoligClipPolig(resultado,poliRec,0); } else { //el resultado es el polígono base resultado = CreaPoligPoliClip(poliBas,0); } } else if((posRec==GEOC_PTO_DENTRO_POLIG)|| (posRec==GEOC_PTO_VERTICE_POLIG)) { //EL POLÍGONO DE RECORTE ESTÁ DENTRO DEL POLÍGONO BASE //distinguimos las operaciones (por defecto, intersección) if(op==GeocOpBoolUnion) { //el resultado es el polígono base resultado = CreaPoligPoliClip(poliBas,0); } else if((op==GeocOpBoolAB)||(op==GeocOpBoolXor)) { //el resultado son los dos polígonos //polígono base resultado = CreaPoligPoliClip(poliBas,0); //añadimos el polígono de recorte AnyadePoligClipPolig(resultado,poliRec,0); } else if(op==GeocOpBoolBA) { //el resultado es un polígono vacío resultado = CreaPoligPoliClip(NULL,0); } else { //el resultado es el polígono de recorte resultado = CreaPoligPoliClip(poliRec,0); } } else { //NINGÚN POLÍGONO ESTÁ DENTRO DEL OTRO //distinguimos las operaciones (por defecto, intersección) if((op==GeocOpBoolUnion)||(op==GeocOpBoolXor)) { //el resultado son los dos polígonos //polígono base resultado = CreaPoligPoliClip(poliBas,0); //añadimos el polígono de recorte AnyadePoligClipPolig(resultado,poliRec,0); } else if(op==GeocOpBoolAB) { //el resultado es el polígono base resultado = CreaPoligPoliClip(poliBas,0); } else if(op==GeocOpBoolBA) { //el resultado es el polígono de recorte resultado = CreaPoligPoliClip(poliRec,0); } else { //el resultado es un polígono vacío resultado = CreaPoligPoliClip(NULL,0); } } //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //salimos de la función return resultado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //distinguimos entre XOR y el resto de operaciones if(op!=GeocOpBoolXor) { //SEGUNDO PASO DEL ALGORITMO DE GREINER-HORMANN: IDENTIFICACIÓN DE //INTERSECCIONES COMO ENTRADA-SALIDA //marcamos los puntos como entrada o salida Paso2Greiner(poliBas,poliRec,op); //TERCER PASO DEL ALGORITMO DE GREINER-HORMANN: EXTRACCIÓN DE LOS POLÍGONOS //RESULTADO DE LA OPERACIÓN //extraemos los polígonos resultado = Paso3Greiner(poliBas,poliRec); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso3Greiner'"); //salimos de la función return NULL; } } else { //LA OPERCIÓN XOR LA HACEMOS COMO LA UNIÓN DE LA OPERACIÓN A-B CON B-A //marcamos los puntos como entrada o salida para la operación A-B Paso2Greiner(poliBas,poliRec,GeocOpBoolAB); //extraemos los polígonos resultado = Paso3Greiner(poliBas,poliRec); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso3Greiner'"); //salimos de la función return NULL; } //reinicializamos los polígonos, pero manteniendo las intersecciones poliBas = ReiniciaVerticesPoliClip(poliBas); poliRec = ReiniciaVerticesPoliClip(poliRec); //marcamos los puntos como entrada o salida para la operación B-A Paso2Greiner(poliBas,poliRec,GeocOpBoolBA); //extraemos los polígonos ba = Paso3Greiner(poliBas,poliRec); //comprobamos los posibles errores if(ba==NULL) { //liberamos la memoria asignada LibMemPolig(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso3Greiner'"); //salimos de la función return NULL; } //añadimos el resultado de la operación B-A al anterior de A-B idError = AnyadePoligPolig(resultado,ba); //comprobamos los posibles errores if(idError==GEOC_ERR_ASIG_MEMORIA) { //liberamos la memoria asignada LibMemPolig(resultado); LibMemPolig(ba); //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'AnyadePoligPolig' para la operación XOR"); //salimos de la función return NULL; } //liberamos la memoria asociada a la estructura auxiliar ba LibMemPolig(ba); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polig* PoliBoolGreinerMult(const polig* poliBas, const polig* poliRec, const enum GEOC_OP_BOOL_POLIG op, const double facPer, size_t* nIntersec, size_t* nPerturb) { //índices para recorrer bucles size_t i=0,j=0; //variable de posición size_t pos=0; //número de intersecciones y de puntos perturbados auxiliar size_t nInt=0,nPer=0; //posición de un rectángulo con respecto a otro int pr=0; //variables de error int estado1=GEOC_ERR_NO_ERROR,estado2=GEOC_ERR_NO_ERROR; //listas de trabajo vertPoliClip* poligBas=NULL; vertPoliClip* poligRec=NULL; //polígono auxiliar polig* poligAux=NULL; //variable de salida polig* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el número total de intersecciones y de puntos perturbados *nIntersec = 0; *nPerturb = 0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la variable de salida resultado = IniciaPoligVacio(); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los polígonos base for(i=0;inPolig;i++) { //dirección de inicio de los vértices del polígono base pos = poliBas->posIni[i]; //creamos el polígono base de trabajo poligBas = CreaPoliClip(&(poliBas->x[pos]),&(poliBas->y[pos]), poliBas->nVert[i],1,1); //comprobamos los posibles errores if(poligBas==NULL) { //liberamos la memoria asignada hasta ahora LibMemPolig(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //recorremos los polígonos de recorte for(j=0;jnPolig;j++) { //comprobamos si los polígonos tienen definidos sus límites if((poliBas->hayLim)&&(poliRec->hayLim)) { //comprobamos si los restángulos que encierran a los polígonos //son disjuntos o no pr = RectDisjuntos(poliBas->xMin[i],poliBas->xMax[i], poliBas->yMin[i],poliBas->yMax[i], poliRec->xMin[j],poliRec->xMax[j], poliRec->yMin[j],poliRec->yMax[j]); //comprobamos los casos particulares si los rectángulos son //disjuntos if(pr&&(op==GeocOpBoolInter)) { //EN CASO DE INTERSECCIÓN, NO SE AÑADE NADA //vamos a la siguiente vuelta del bucle continue; } else if(pr&&((op==GeocOpBoolUnion)||(op==GeocOpBoolXor))) { //EN CASO DE UNIÓN O UNIÓN EXCLUSIVA, SE AÑADEN LOS DOS //POLÍGONOS //añadimos el polígono base estado1 = AnyadeDatosPolig(resultado,&(poliBas->x[pos]), &(poliBas->y[pos]), poliBas->nVert[i],1,1); //añadimos el polígono de recorte pos = poliRec->posIni[j]; estado2 = AnyadeDatosPolig(resultado,&(poliRec->x[pos]), &(poliRec->y[pos]), poliRec->nVert[j],1,1); //comprobamos los posibles errores, que sólo pueden ser de //asignación de memoria if((estado1!=GEOC_ERR_NO_ERROR)|| (estado2!=GEOC_ERR_NO_ERROR)) { //liberamos la posible memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPolig(resultado); //lanzamos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //vamos a la siguiente vuelta del bucle continue; } else if(pr&&(op==GeocOpBoolAB)) { //EN CASO DE OPERACIÓN A-B, SE AÑADE EL POLÍGONO BASE //añadimos el polígono base estado1 = AnyadeDatosPolig(resultado,&(poliBas->x[pos]), &(poliBas->y[pos]), poliBas->nVert[i],1,1); //comprobamos los posibles errores, que sólo pueden ser de //asignación de memoria if(estado1!=GEOC_ERR_NO_ERROR) { //liberamos la posible memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPolig(resultado); //lanzamos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //vamos a la siguiente vuelta del bucle continue; } else if(pr&&(op==GeocOpBoolBA)) { //EN CASO DE OPERACIÓN B-A, SE AÑADE EL POLÍGONO DE RECORTE //añadimos el polígono de recorte pos = poliRec->posIni[j]; estado1 = AnyadeDatosPolig(resultado,&(poliRec->x[pos]), &(poliRec->y[pos]), poliRec->nVert[j],1,1); //comprobamos los posibles errores, que sólo pueden ser de //asignación de memoria if(estado1!=GEOC_ERR_NO_ERROR) { //liberamos la posible memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPolig(resultado); //lanzamos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //vamos a la siguiente vuelta del bucle continue; } } //dirección de inicio de los vértices del polígono de recorte pos = poliRec->posIni[j]; //creamos el polígono de recorte de trabajo poligRec = CreaPoliClip(&(poliRec->x[pos]),&(poliRec->y[pos]), poliRec->nVert[j],1,1); //comprobamos los posibles errores if(poligRec==NULL) { //liberamos la memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPolig(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //recortamos poligAux = PoliBoolGreiner(poligBas,poligRec,op,facPer,&nInt,&nPer); //comprobamos los posibles errores if(poligAux==NULL) { //liberamos la posible memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPoliClip(poligRec); LibMemPolig(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //sumamos el número de intersecciones y de puntos perturbados (*nIntersec) += nInt; (*nPerturb) += nPer; //añadimos los polígonos recortados a la variable de salida if(AnyadePoligPolig(resultado,poligAux)==GEOC_ERR_ASIG_MEMORIA) { //liberamos la posible memoria asignada hasta ahora LibMemPoliClip(poligBas); LibMemPoliClip(poligRec); LibMemPolig(poligAux); LibMemPolig(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //liberamos la memoria asignada al polígono de esta vuelta del bucle LibMemPoliClip(poligRec); //liberamos la memoria asignada al polígono auxiliar LibMemPolig(poligAux); //reinicializamos el polígono base poligBas = ReiniciaPoliClip(poligBas); } //liberamos la memoria asignada al polígono de esta vuelta del bucle LibMemPoliClip(poligBas); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polig* CreaPoligPoliClip(vertPoliClip* poli, const int coorOrig) { //índice para recorrer bucles size_t i=0; //número de elementos size_t nVert=0,nElem=0; //estructura auxiliar vertPoliClip* aux=poli; //variable de salida polig* result=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la estructura vacía result = IniciaPoligVacio(); //comprobamos los posibles errores if(result==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contamos todos los vértices del polígono nVert = NumeroVertPoliClip(poli); //contemplamos una posible salida rápida if(nVert==0) { //devolvemos la estructura vacía return result; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //número de elementos de los vectores de coordenadas nElem = nVert+2; //asignamos memoria para los vectores de coordenadas de la estructura result->x = (double*)malloc(nElem*sizeof(double)); result->y = (double*)malloc(nElem*sizeof(double)); //asignamos memoria para los vectores de posición result->posIni = (size_t*)malloc(sizeof(size_t)); result->nVert = (size_t*)malloc(sizeof(size_t)); //comprobamos los posibles errores de asignación de memoria if((result->x==NULL)||(result->y==NULL)||(result->posIni==NULL)|| (result->nVert==NULL)) { //liberamos la posible memoria asignada LibMemPolig(result); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el número de elementos de los vectores de coordenadas y de //polígonos result->nElem = nElem; result->nPolig = 1; //asignamos la posición de inicio y el número de vértices result->posIni[0] = 1; result->nVert[0] = nVert; //asignamos los separadores de polígono al principio y al final result->x[0] = GeocNan(); result->y[0] = GeocNan(); result->x[nElem-1] = GeocNan(); result->y[nElem-1] = GeocNan(); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los vértices del polígono for(i=1;i<=nVert;i++) { //distinguimos el tipo de coordenadas a copiar if(coorOrig) { //coordenadas originales result->x[i] = aux->x; result->y[i] = aux->y; } else { //coordenadas perturbadas result->x[i] = aux->xP; result->y[i] = aux->yP; } //siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return result; } /******************************************************************************/ /******************************************************************************/ int AnyadePoligClipPolig(polig* poli, vertPoliClip* anyade, const int coorOrig) { //número de elementos a añadir size_t nVert=0; //polígono auxiliar polig* aux=NULL; //variable de estado (salida) int estado=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contamos todos los vértices del polígono a añadir nVert = NumeroVertPoliClip(anyade); //contemplamos una posible salida rápida if(nVert==0) { //devolvemos la estructura vacía return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos un nuevo polígono con los datos a añadir aux = CreaPoligPoliClip(anyade,coorOrig); //comprobamos los posibles errores if(aux==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //añadimos la nueva estructura estado = AnyadePoligPolig(poli,aux); //comprobamos los posibles errores if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la memoria asignada LibMemPolig(aux); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return estado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria utilizada LibMemPolig(aux); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return estado; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/calctopo.c000644 001750 001750 00000007027 12540021550 015720 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geodesia geom @{ \file calctopo.c \brief Definición de funciones para cálculos de topografía. \author José Luis García Pallero, jgpallero@gmail.com \date 05 de julio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/calctopo.h" /******************************************************************************/ /******************************************************************************/ double AcimutTopografico(const double x1, const double y1, const double x2, const double y2) { //acimut calculado double acimut=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el acimut en el dominio [-pi pi] acimut = atan2(x2-x1,y2-y1); //comprobamos si ha salido un valor negativo if(acimut<0.0) { //metemos el valor en dominio acimut += 2.0*GEOC_CONST_PI; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return acimut; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/_oc_polybool.cc000644 001750 001750 00000022341 12540021550 016732 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /* Copyright (C) 2011-2015 José Luis García Pallero, * * This file is part of OctCLIP. * * OctCLIP is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this software; see the file COPYING. If not, see * . */ /******************************************************************************/ /******************************************************************************/ #define HELPTEXT "\ -*- texinfo -*-\n\ @deftypefn{Loadable Function}{[@var{X},@var{Y},@var{nPol},@var{nInt},\ @var{nPert}] =}_oc_polybool(@var{sub},@var{clip},@var{op})\n\ \n\ @cindex Performs boolean operations between two polygons.\n\ \n\ This function performs boolean operations between two polygons using the\n\ Greiner-Hormann algorithm (http://davis.wpi.edu/~matt/courses/clipping/).\n\ \n\ @var{sub} is a two column matrix containing the X and Y coordinates of the\n\ vertices for the subject polygon.\n\n\ @var{clip} is a two column matrix containing the X and Y coordinates of the\n\ vertices for the clipper polygon.\n\n\ @var{op} is a text string containing the operation to perform between\n\ @var{sub} and @var{clip}. Possible values are:\n\ \n\ @itemize @bullet\n\ @item @var{'AND'}\n\ Intersection of @var{sub} and @var{clip}.\n\n\ @item @var{'OR'}\n\ Union of @var{subt} and @var{clip}.\n\n\ @item @var{'AB'}\n\ Operation @var{sub} - @var{clip}.\n\n\ @item @var{'BA'}\n\ Operation of @var{clip} - @var{sub}.\n\ @end itemize\n\ \n\ For the matrices @var{sub} and @var{clip}, the first point is not needed to\n\ be repeated at the end (but is permitted). Pairs of (NaN,NaN) coordinates in\n\ @var{sub} and/or @var{clip} are omitted, so they are treated as if each one\n\ stored a single polygon.\n\ \n\ @var{X} is a column vector containing the X coordinates of the vertices of\n\ the resultant polygon(s).\n\n\ @var{Y} is a column vector containing the Y coordinates of the vertices of\n\ the resultant polygon(s).\n\n\ @var{nPol} is the number of output polygons.\n\n\ @var{nInt} is the number of intersections between @var{sub} and @var{clip}.\n\n\ @var{nPert} is the number of perturbed points of the @var{clip} polygon in\n\ any particular case (points in the oborder of the other polygon) occurs see\n\ http://davis.wpi.edu/~matt/courses/clipping/ for details.\n\ \n\ This function do not check if the dimensions of @var{sub} and @var{clip} are\n\ correct.\n\ \n\ @end deftypefn" /******************************************************************************/ /******************************************************************************/ #include #include #include #include #include #include"octclip.h" /******************************************************************************/ /******************************************************************************/ #define ERRORTEXT 1000 /******************************************************************************/ /******************************************************************************/ DEFUN_DLD(_oc_polybool,args,,HELPTEXT) { //error message char errorText[ERRORTEXT+1]="_oc_polybool:\n\t"; //output list octave_value_list outputList; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //checking input arguments if(args.length()!=3) { //error text sprintf(&errorText[strlen(errorText)], "Incorrect number of input arguments\n\t" "See help _oc_polybool"); //error message error(errorText); } else { //loop index size_t i=0; //polygons and operation ColumnVector xSubj=args(0).matrix_value().column(0); ColumnVector ySubj=args(0).matrix_value().column(1); ColumnVector xClip=args(1).matrix_value().column(0); ColumnVector yClip=args(1).matrix_value().column(1); std::string opchar=args(2).string_value(); //computation vectors double* xA=NULL; double* yA=NULL; double* xB=NULL; double* yB=NULL; //double linked lists vertPoliClip* polA=NULL; vertPoliClip* polB=NULL; //operation identifier enum GEOC_OP_BOOL_POLIG op=GeocOpBoolInter; //output struct polig* result=NULL; //number of polygons, intersections and perturbations size_t nPol=0,nInter=0,nPert=0; //number of elements for the output vectors size_t nElem=0; //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //pointers to data xA = xSubj.fortran_vec(); yA = ySubj.fortran_vec(); xB = xClip.fortran_vec(); yB = yClip.fortran_vec(); //create double linked lists for subject and clipper polygons polA = CreaPoliClip(xA,yA,static_cast(xSubj.length()),1,1); polB = CreaPoliClip(xB,yB,static_cast(xClip.length()),1,1); //error checking if((polB==NULL)||(polB==NULL)) { //free peviously allocated memory LibMemPoliClip(polA); LibMemPoliClip(polB); //error text sprintf(&errorText[strlen(errorText)],"Error in memory allocation"); //error message error(errorText); //exit return outputList; } //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //select operation if((!strcmp(opchar.c_str(),"AND"))||(!strcmp(opchar.c_str(),"and"))) { op = GeocOpBoolInter; } else if((!strcmp(opchar.c_str(),"OR"))||(!strcmp(opchar.c_str(),"or"))) { op = GeocOpBoolUnion; } else if((!strcmp(opchar.c_str(),"AB"))||(!strcmp(opchar.c_str(),"ab"))) { op = GeocOpBoolAB; } else if((!strcmp(opchar.c_str(),"BA"))||(!strcmp(opchar.c_str(),"ba"))) { op = GeocOpBoolBA; } else { //free peviously allocated memory LibMemPoliClip(polA); LibMemPoliClip(polB); //error text sprintf(&errorText[strlen(errorText)], "The third input argument (op=%s) is not correct", opchar.c_str()); //error message error(errorText); //exit return outputList; } //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //clipping result = PoliBoolGreiner(polA,polB,op,GEOC_GREINER_FAC_EPS_PERTURB, &nInter,&nPert); //error checking if(result==NULL) { //free peviously allocated memory LibMemPoliClip(polA); LibMemPoliClip(polB); //error text sprintf(&errorText[strlen(errorText)],"Error in memory allocation"); //error message error(errorText); //exit return outputList; } //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //number or output polygons nPol = result->nPolig; //dimensions for the output vectors if(nPol) { nElem = result->nElem; } else { nElem = 0; } //output vectors ColumnVector xResult(nElem); ColumnVector yResult(nElem); //copy output data for(i=0;ix[i]; yResult(i) = result->y[i]; } //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //output parameters list outputList(0) = xResult; outputList(1) = yResult; outputList(2) = nPol; outputList(3) = nInter; outputList(4) = nPert; //////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////// //free memory LibMemPoliClip(polA); LibMemPoliClip(polB); LibMemPolig(result); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //exit return outputList; } octclip-1.0.8/src/segmento.c000755 001750 001750 00000030133 12540021550 015732 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom @{ \file segmento.c \brief Definición de funciones para la realización de cálculos con segmentos. \author José Luis García Pallero, jgpallero@gmail.com \date 22 de abril de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/segmento.h" /******************************************************************************/ /******************************************************************************/ double PosPtoRecta2D(const double x, const double y, const double xIni, const double yIni, const double xFin, const double yFin) { //calculamos y salimos de la función return (xIni-x)*(yFin-y)-(xFin-x)*(yIni-y); } /******************************************************************************/ /******************************************************************************/ int TresPuntosColineales2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC) { //variable de salida int colin=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //utilizamos la función de posición de punto con respecto a una recta, //aunque no es una función robusta //son colineales si el resultado es 0.0 colin = (PosPtoRecta2D(xA,yA,xB,yB,xC,yC)==0.0) ? 1 : 0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return colin; } /******************************************************************************/ /******************************************************************************/ int PuntoEntreDosPuntos2DColin(const double x, const double y, const double xA, const double yA, const double xB, const double yB) { //código de salida int cod=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //distinguimos entre segmento vertical y no vertical if(xA!=xB) { //segmento no vertical, utilizamos las coordenadas X cod = ((xAx)&&(x>xB)); } else { //segmento vertical, utilizamos las coordenadas Y cod = ((yAy)&&(y>yB)); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return cod; } /******************************************************************************/ /******************************************************************************/ int PtoComunSegmParalelos2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC, const double xD, const double yD, double* x, double* y) { //variable de salida int cod=GEOC_SEG_NO_INTERSEC; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si los puntos son colineales if(!TresPuntosColineales2D(xA,yA,xB,yB,xC,yC)) { //los segmentos son paralelos, pero no se cortan return GEOC_SEG_NO_INTERSEC; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si los segmentos son el mismo if(((xA==xC)&&(yA==yC)&&(xB==xD)&&(yB==yD))|| ((xA==xD)&&(yA==yD)&&(xB==xC)&&(yB==yC))) { //coordenadas de salida *x = xA; *y = yA; //los segmentos son el mismo return GEOC_SEG_INTERSEC_MISMO_SEG; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si algún punto está entre medias del otro segmento if(PuntoEntreDosPuntos2DColin(xA,yA,xC,yC,xD,yD)) { //el punto A está en el segmento CD *x = xA; *y = yA; //salimos return GEOC_SEG_INTERSEC_COLIN; } else if(PuntoEntreDosPuntos2DColin(xC,yC,xA,yA,xB,yB)) { //el punto C está en el segmento AB *x = xC; *y = yC; //salimos return GEOC_SEG_INTERSEC_COLIN; } else if(PuntoEntreDosPuntos2DColin(xB,yB,xC,yC,xD,yD)) { //el punto B está en el segmento CD *x = xB; *y = yB; //salimos return GEOC_SEG_INTERSEC_COLIN; } else if(PuntoEntreDosPuntos2DColin(xD,yD,xA,yA,xB,yB)) { //el punto D está en el segmento AB *x = xD; *y = yD; //salimos return GEOC_SEG_INTERSEC_COLIN; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si sólo comparten el extremo A if(((xA==xC)&&(yA==yC))||((xA==xD)&&(yA==yD))) { //coordenadas de salida *x = xA; *y = yA; //los segmentos comparten un extremo return GEOC_SEG_INTERSEC_EXTREMO_COLIN; } //comprobamos si sólo comparten el extremo B if(((xB==xC)&&(yB==yC))||((xB==xD)&&(yB==yD))) { //coordenadas de salida *x = xB; *y = yB; //los segmentos comparten un extremo return GEOC_SEG_INTERSEC_EXTREMO_COLIN; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return cod; } /******************************************************************************/ /******************************************************************************/ int IntersecSegmentos2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC, const double xD, const double yD, double* x, double* y) { //parámetros de las ecuaciones double s=0.0,t=0.0,num=0.0,den=0.0; //variable de salida int cod=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si los rectángulos que encierran a los segmentos son disjuntos if(RectDisjuntos(GEOC_MIN(xA,xB),GEOC_MAX(xA,xB),GEOC_MIN(yA,yB), GEOC_MAX(yA,yB),GEOC_MIN(xC,xD),GEOC_MAX(xC,xD), GEOC_MIN(yC,yD),GEOC_MAX(yC,yD))) { //si los rectángulos son disjuntos, los segmentos no se tocan cod = GEOC_SEG_NO_INTERSEC; //salimos de la función return cod; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el denominador den = xA*(yD-yC)+xB*(yC-yD)+xD*(yB-yA)+xC*(yA-yB); //si el denominador es 0.0, los segmentos son paralelos if(den==0.0) { //calculamos el punto común cod = PtoComunSegmParalelos2D(xA,yA,xB,yB,xC,yC,xD,yD,x,y); //salimos de la función return cod; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el numerador num = xA*(yD-yC)+xC*(yA-yD)+xD*(yC-yA); //un extremo de un segmento puede estar encima del otro segmento, pero los //segmentos no son colineales if((num==0.0)||(num==den)) { //asignamos la variable de salida cod = GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN; } //calculamos el parámetro s s = num/den; //calculamos de nuevo el numerador num = -(xA*(yC-yB)+xB*(yA-yC)+xC*(yB-yA)); //un extremo de un segmento puede estar encima del otro segmento, pero los //segmentos no son colineales if((num==0.0)||(num==den)) { //asignamos la variable de salida cod = GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN; } //calculamos el parámetro t t = num/den; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si estamos ante una intersección pura y dura o los segmentos //no se cortan if((s>0.0)&&(s<1.0)&&(t>0.0)&&(t<1.0)) { //asignamos la variable de salida cod = GEOC_SEG_INTERSEC; } else if((s<0.0)||(s>1.0)||(t<0.0)||(t>1.0)) { //asignamos la variable de salida cod = GEOC_SEG_NO_INTERSEC; } //calculamos las coordenadas del punto intersección *x = xA+s*(xB-xA); *y = yA+s*(yB-yA); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return cod; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/eucli.c000755 001750 001750 00000024433 12540021550 015220 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom interp @{ \file eucli.c \brief Definición de funciones para la realización de cálculos de geometría euclídea. \author José Luis García Pallero, jgpallero@gmail.com \date 27 de octubre de 2009 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/eucli.h" /******************************************************************************/ /******************************************************************************/ double Dist2D(const double x1, const double y1, const double x2, const double y2) { //calculamos y salimos de la función return sqrt((x2-x1)*(x2-x1)+(y2-y1)*(y2-y1)); } /******************************************************************************/ /******************************************************************************/ void Dist2DVC(const double x1, const double y1, const double x2, const double y2, const double varx1, const double varx1y1, const double vary1, const double varx2, const double varx2y2, const double vary2, double* dist, double* varDist) { //matrices auxiliares double j[4],jvc[4]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos la distancia *dist = Dist2D(x1,y1,x2,y2); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //rellenamos la matriz jacobiana j[0] = -(x2-x1)/(*dist); j[1] = -(y2-y1)/(*dist); j[2] = -j[0]; j[3] = -j[1]; //producto de la matriz jacobiana por la matriz de varianza-covarianza jvc[0] = j[0]*varx1+j[1]*varx1y1; jvc[1] = j[0]*varx1y1+j[1]*vary1; jvc[2] = j[2]*varx2+j[3]*varx2y2; jvc[3] = j[2]*varx2y2+j[3]*vary2; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //realizamos la propagación de errores *varDist = jvc[0]*j[0]+jvc[1]*j[1]+jvc[2]*j[2]+jvc[3]*j[3]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ double Dist3D(const double x1, const double y1, const double z1, const double x2, const double y2, const double z2) { //calculamos y salimos de la función return sqrt((x2-x1)*(x2-x1)+(y2-y1)*(y2-y1)+(z2-z1)*(z2-z1)); } /******************************************************************************/ /******************************************************************************/ void Dist3DVC(const double x1, const double y1, const double z1, const double x2, const double y2, const double z2, const double varx1, const double varx1y1, const double varx1z1, const double vary1, const double vary1z1, const double varz1, const double varx2, const double varx2y2, const double varx2z2, const double vary2, const double vary2z2, const double varz2, double* dist, double* varDist) { //matrices auxiliares double j[6],jvc[6]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos la distancia *dist = Dist3D(x1,y1,z1,x2,y2,z2); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //rellenamos la matriz jacobiana j[0] = -(x2-x1)/(*dist); j[1] = -(y2-y1)/(*dist); j[2] = -(z2-z1)/(*dist); j[3] = -j[0]; j[4] = -j[1]; j[5] = -j[2]; //producto de la matriz jacobiana por la matriz de varianza-covarianza jvc[0] = j[0]*varx1+j[1]*varx1y1+j[2]*varx1z1; jvc[1] = j[0]*varx1y1+j[1]*vary1+j[2]*vary1z1; jvc[2] = j[0]*varx1z1+j[1]*vary1z1+j[2]*varz1; jvc[3] = j[3]*varx2+j[4]*varx2y2+j[5]*varx2z2; jvc[4] = j[3]*varx2y2+j[4]*vary2+j[5]*vary2z2; jvc[5] = j[3]*varx2z2+j[4]*vary2z2+j[5]*varz2; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //realizamos la propagación de errores *varDist = jvc[0]*j[0]+jvc[1]*j[1]+jvc[2]*j[2]+jvc[3]*j[3]+jvc[4]*j[4]+ jvc[5]*j[5]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ double AnguloVecPlano(const double x1, const double y1, const double x2, const double y2) { //variables auxiliares double num=0.0,den=0.0; //variable de salida double alfa=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el numerador de la fórmula que da el coseno del ángulo num = x1*x2+y1*y2; //calculamos el denominador de la fórmula que da el coseno del ángulo den = sqrt((x1*x1+y1*y1)*(x2*x2+y2*y2)); //calculamos el coseno del ángulo, teniendo en cuenta casos singulares if(den==0.0) { //si el denominador es 0.0, el ángulo es 0.0 y su coseno 1.0 alfa = 1.0; } else { //no hay singularidad alfa = num/den; } //calculamos el ángulo alfa = acos(alfa); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return alfa; } /******************************************************************************/ /******************************************************************************/ double AlturaTriangulo(const double xVert, const double yVert, const double xBase1, const double yBase1, const double xBase2, const double yBase2) { //ángulo entra la base en el punto 1 y el vértice double alfa=0.0; //longitud del punto 1 de la base al vértice double lon=0.0; //variables auxiliares double dxv=0.0,dyv=0.0,dxb=0.0,dyb=0.0; //variable de salida double h=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos los incrementos de coordenadas auxiliares dxv = xVert-xBase1; dyv = yVert-yBase1; dxb = xBase2-xBase1; dyb = yBase2-yBase1; //calculamos el ángulo entre la base y el segmento que une el punto inicial //de ésta con el vértice alfa = AnguloVecPlano(dxv,dyv,dxb,dyb); //longitud del lado que une la base con el vértice 1 de la base lon = sqrt(dxv*dxv+dyv*dyv); //calculamos la altura h = fabs(lon*sin(alfa)); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return h; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/000755 001750 001750 00000000000 12540021550 015346 5ustar00topotopo000000 000000 octclip-1.0.8/src/libgeoc/dpeucker.h000644 001750 001750 00000034546 12540021550 017335 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom @{ \file dpeucker.h \brief Declaración de funciones para el aligerado de polilíneas basadas en el algoritmo de Douglas-Peucker. \author José Luis García Pallero, jgpallero@gmail.com \date 04 de julio de 2011 \section Licencia Licencia Copyright (c) 2009-2010, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _DPEUCKER_H_ #define _DPEUCKER_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include"libgeoc/calctopo.h" #include"libgeoc/constantes.h" #include"libgeoc/eucli.h" #include"libgeoc/fgeneral.h" #include"libgeoc/segmento.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_DPEUCKER_BUFFER_PTOS \brief Número de puntos para ir asignando memoria en bloques para el vector de salida en la funcion \ref AligeraPolilinea. \date 06 de julio de 2011: Creación de la constante. */ #define GEOC_DPEUCKER_BUFFER_PTOS 100 /******************************************************************************/ /******************************************************************************/ /** \enum GEOC_DPEUCKER_ROBUSTO \brief Aplicación o no del algoritmo robusto de aligerado de polilíneas. \date 10 de julio de 2011: Creación del tipo. */ enum GEOC_DPEUCKER_ROBUSTO { /** \brief \b *NO* se realiza aligerado robusto. */ GeocDPeuckerRobNo=111, /** \brief \b *SÍ* se realiza aligerado robusto. */ GeocDPeuckerRobSi=112, /** \brief Aligerado semi robusto con \ref AligPolilRobIntersecOrig. */ GeocDPeuckerRobOrig=113, /** \brief Aligerado semi robusto con \ref AligPolilRobAutoIntersec. */ GeocDPeuckerRobAuto=114 }; /******************************************************************************/ /******************************************************************************/ /** \brief Elimina vértices de una polilínea mediante un algoritmo inspirado en el de Douglas-Peucker. Este algoritmo, comenzando por el primer punto de la polilínea, va uniendo puntos en segmentos de tal forma que se eliminan todos aquellos puntos que queden a una distancia perpendicular menor o igual a \em tol del segmento de trabajo. Así aplicado, pueden ocurrir casos singulares en los que la polilínea aligerada tenga casos de auto intersección entre sus lados resultantes. Para evitar esto, se puede aplicar la versión robusta del algoritmo. \param[in] x Vector que contiene las coordenadas X de los vértices de la polilínea de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices de la polilínea de trabajo. \param[in] nPtos Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] tol Tolerancia para eliminar vértices, en las mismas unidades que las coordenadas de los vértices. \param[in] robusto Identificador para realizar o no un aligerado robusto. Ha de ser un elemento del tipo enumerado #GEOC_DPEUCKER_ROBUSTO. Varias posibilidades: - #GeocDPeuckerRobNo: No se aplica el algoritmo robusto. - #GeocDPeuckerRobSi: Se aplica el algoritmo robusto completo, que garantiza la no ocurrencia de auto intersecciones en la polilínea resultante. Internamente, primero se aplica el tratamiento robusto de la opción #GeocDPeuckerRobOrig y luego el de la opción #GeocDPeuckerRobAuto. - #GeocDPeuckerRobOrig: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos de la polilínea aligerada que se van creando no intersectarán con ninguno de los segmentos que forman los vértices que quedan por procesar de la polilínea original. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. - #GeocDPeuckerRobAuto: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos de la polilínea aligerada que se van creando no intersectarán con ninguno de los segmentos de la polilínea aligerada creados con anterioridad. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. \param[in] nPtosRobusto Número de puntos de la polilínea original a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobOrig. Si se pasa el valor 0, se utilizan todos los puntos hasta el final de la polilínea original. \param[in] nSegRobusto Número de segmentos de la polilínea aligerada a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobAuto. Si se pasa el valor 0, se utilizan todos los segmentos hasta el inicio de la polilínea aligerada. \param[out] nPtosSal Número de puntos de la polilínea aligerada. \return Vector de \em nPtosSal elementos que contiene los índices en los vectores \em x e \em y de los vértices que formarán la polilínea aligerada. Si ocurre algún error de asignación de memoria se devuelve el valor \p NULL. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con el valor pasado en \em nPtos. \note Esta función asume que \em nPtos es mayor que 0. En caso contrario, devuelve \p NULL. \date 07 de julio de 2011: Creación de la función. \date 10 de julio de 2011: Cambio del tipo del argumento \em robusto al tipo enumerado #GEOC_DPEUCKER_ROBUSTO. \todo Esta función todavía no está probada. */ size_t* AligeraPolilinea(const double* x, const double* y, const size_t nPtos, const size_t incX, const size_t incY, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto, size_t* nPtosSal); /******************************************************************************/ /******************************************************************************/ /** \brief Aproximación robusta al aligerado de líneas consistente en evitar que los segmentos creados intersecten con los de la polilínea original a partir del punto de trabajo actual. \param[in] x Vector que contiene las coordenadas X de los vértices de la polilínea de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices de la polilínea de trabajo. \param[in] nPtos Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] ptosAUsar Número de puntos a utilizar de la polilínea original. Si se pasa el valor 0 se utilizan todos los puntos que quedan desde el punto de trabajo hasta el final. \param[in] posIni Posición inicial del segmento a chequear. \param[in,out] posFin Posición final del segmento a chequear. Al término de la ejecución de la función almacena la posición del punto que hace que el segmento de la polilínea aligerada no intersecte con ninguno de los que quedan de la polilínea original. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con el valor pasado en \em nPtos. \note Esta función no comprueba si los índices pasados en los argumentos \em posIni y \em posFin son congruentes con el tamaño de los vectores pasado en \em nPtos. \note Esta función no comprueba internamente si la variable \em ptosAUsar es congruente con el valor pasado en \em nPtos. \date 07 de julio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void AligPolilRobIntersecOrig(const double* x, const double* y, const size_t nPtos, const size_t incX, const size_t incY, const size_t ptosAUsar, const size_t posIni, size_t* posFin); /******************************************************************************/ /******************************************************************************/ /** \brief Aproximación robusta al aligerado de líneas consistente en evitar que los segmentos creados intersecten con los anteriores de la polilínea aligerada. \param[in] x Vector que contiene las coordenadas X de los vértices de la polilínea de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices de la polilínea de trabajo. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] posAlig Vector de posiciones de \em x e \em y utilizadas en la polilínea aligerada. \param[in] nPosAlig Número de elementos de \em posAlig menos el último punto añadido. Esto se hace así para evitar chequear el segmento inmediatamente anterior, que siempre tiene un punto en común (su extremo final) con el de trabajo. \param[in] segAUsar Número de segmentos a utilizar de la polilínea aligerada. Si se pasa el valor 0 se utilizan todos los segmentos anteriores. \param[in] posIni Posición inicial del segmento a chequear. \param[in,out] posFin Posición final del segmento a chequear. Al término de la ejecución de la función almacena la posición del punto que hace que el segmento de la polilínea aligerada no intersecte con ninguno de los anteriormente calculados. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con el valor pasado en \em nPtos. \note Esta función no comprueba si los índices pasados en los argumentos \em posIni y \em posFin son congruentes con el tamaño de los vectores pasado en \em nPtos. \note Esta función trabaja internamente con el valor absoluto del argumento \em tamRect. \date 05 de julio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void AligPolilRobAutoIntersec(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posAlig, const size_t nPosAlig, const size_t segAUsar, const size_t posIni, size_t* posFin); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/geom.h000755 001750 001750 00000006405 12540021550 016456 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \defgroup geom Módulo GEOMETRIA \brief En este módulo se reúnen las funciones necesarias para el tratamiento de problemas de geometría. @{ \file geom.h \brief Inclusión de ficheros de cabecera para el trabajo con la biblioteca GEOMETRIA. \author José Luis García Pallero, jgpallero@gmail.com \date 26 de diciembre de 2009 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _GEOM_H_ #define _GEOM_H_ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/dpeucker.h" #include"libgeoc/eucli.h" #include"libgeoc/greiner.h" #include"libgeoc/polig.h" #include"libgeoc/polil.h" #include"libgeoc/ptopol.h" #include"libgeoc/recpolil.h" #include"libgeoc/segmento.h" /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/general.h000755 001750 001750 00000006243 12540021550 017144 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \defgroup general Módulo GENERAL \brief En este módulo se reúnen constantes, macros y funciones de utilidad general. @{ \file general.h \brief Inclusión de archivos de cabecera para la utilización de la biblioteca GENERAL. \author José Luis García Pallero, jgpallero@gmail.com \date 16 de febrero de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _GENERAL_H_ #define _GENERAL_H_ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/compilador.h" #include"libgeoc/constantes.h" #include"libgeoc/fgeneral.h" #include"libgeoc/ventorno.h" /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/geocnan.h000755 001750 001750 00000027464 12540021550 017151 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \defgroup geocnan Módulo GEOCNAN \ingroup geom matriz gshhs \brief En este módulo se reúnen constantes y funciones para el trabajo con valores Not-a-Number. @{ \file geocnan.h \brief Declaración de constantes y funciones para el trabajo con valores Not-a-Number. \author José Luis García Pallero, jgpallero@gmail.com \date 26 de mayo de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2010-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _GEOCNAN_H_ #define _GEOCNAN_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include #include #include"libgeoc/errores.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_NAN \brief Constante \em Not-a-Number (\em NaN). Se define como \em 0.0/0.0. \date 21 de diciembre de 2010: Creación de la constante. */ #define GEOC_NAN (0.0/0.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_NAN_TXT \brief Constante \em Not-a-Number (\em NaN), como cadena de texto. \date 22 de septiembre de 2011: Creación de la constante. */ #define GEOC_NAN_TXT "NaN" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_NAN_LON_FORM_NUM_SIMPLE \brief Longitud de una cadena de texto auxiliar para el cálculo de la longitud de una cadena de formato numérico simple. \date 22 de septiembre de 2011: Creación de la constante. */ #define GEOC_NAN_LON_FORM_NUM_SIMPLE 100 /******************************************************************************/ /******************************************************************************/ /** \brief Devuelve el número que representa el valor \em Not-a-Number (\em NaN), que se define como el resultado de la evaluación de la operación \em 0.0/0.0. \return Valor NaN. \note Esta función devuelve el valor almacenado en la constante #GEOC_NAN. \date 21 de diciembre de 2010: Creación de la función. \date 24 de mayo de 2011: Ahora la función devuelve el valor absoluto de #GEOC_NAN, calculado con la función fabs() de C estándar. Se ha hecho así porque, a veces, al imprimir un valor normal de #GEOC_NAN, éste aparecía con un signo negativo delante. \date 22 de septiembre de 2011: Lo del fabs() no funciona. Parece que los problemas en la impresión dependen del compilador y los flags de optimización utilizados. No obstante, se mantiene el uso de la función fabs() en el código. \todo Esta función todavía no está probada. */ double GeocNan(void); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un número es \em Not-a-Number (\em NaN). \param[in] valor Un número. \return Dos posibilidades: - 0: El número pasado no es NaN. - Distinto de 0: El número pasado sí es NaN. \note Esta función ha sido adaptada de LAPACK 3.2.1, disnan.f, (http://www.netlib.org/lapack). \date 21 de diciembre de 2010: Creación de la función. \todo Esta función todavía no está probada. */ int EsGeocNan(const double valor); /******************************************************************************/ /******************************************************************************/ /** \brief Busca valores #GEOC_NAN es un vector de datos. \param[in] datos Vector de trabajo. \param[in] nDatos Número de elementos que contiene el vector \em datos. \param[in] incDatos Posiciones de separación entre los elementos del vector \em datos. Este argumento siempre ha de ser un número positivo. \param[out] nNan Número de valores #GEOC_NAN encontrados, que es el número de elementos del vector de salida. \return Varias posibilidades: - Si todo ha ido bien, vector que contiene las posiciones en el vector original donde se almacena el valor #GEOC_NAN. - NULL: Pueden haber ocurrido dos cosas: - Si \em nNan vale 0, en los datos de entrada no hay ningún valor #GEOC_NAN. - Si \em nNan es mayor que 0, ha ocurrido un error interno de asignación de memoria. \note Esta función no comprueba si el número de elementos del vector \em datos es congruente con los valores pasados en \em nDatos e \em incDatos. \note Las posiciones de los elementos #GEOC_NAN encontradas se refieren al número de elementos \em nDatos del vector de trabajo. Para encontrar la posición real en memoria es necesario tener en cuenta la variable \em incDatos. \date 26 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ size_t* PosGeocNanEnVector(const double* datos, const size_t nDatos, const size_t incDatos, size_t* nNan); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el número de carácteres que ocupa un valor numérico imprimido con determinado formato. \param[in] formato Cadena de formato para imprimir \b *UN \b ÚNICO* valor numérico (de cualquier tipo). \return Número de carácteres que ocupa un valor numérico imprimido según el formato pasado. \note Esta función no comprueba internamente si la cadena de formato es correcta. \note \em formato no puede dar lugar a un texto impreso de más de #GEOC_NAN_LON_FORM_NUM_SIMPLE carácteres. \date 22 de septiembre de 2011: Creación de la función. \todo Esta función todavía no está probada. */ size_t LonFormatoNumSimple(const char formato[]); /******************************************************************************/ /******************************************************************************/ /** \brief Convierte una cadena de formato para imprimir un \b *ÚNICO* número en una cadena para imprimir texto con el mismo ancho que el que tendría de haber sido imprimida como número. \param[in] formatoNum Cadena de formato para imprimir \b *UN \b ÚNICO* valor numérico (de cualquier tipo). \param[out] formatoTexto Cadena de texto que almacenará la cadena de formato para la impresión en modo texto. \note Esta función no comprueba internamente si la cadena de formato numérico es correcta. \note \em formatoNum no puede dar lugar a un texto impreso de más de #GEOC_NAN_LON_FORM_NUM_SIMPLE carácteres. \note Esta función asume que \em formatoTexto tiene espacio suficiente para almacenar la cadena de salida. \note Si \em formatoNum contiene al final carácteres de retorno de carro y salto de línea, estos no son tenidos en cuenta en la creación de la cadena de salida (no son tenidos en cuenta en el sentido de que no se añaden al formato de salida, pero el espacio que ocupan sí se computa). \date 22 de septiembre de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void FormatoNumFormatoTexto(const char formatoNum[], char formatoTexto[]); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime valores Not-a-Number en modo texto (#GEOC_NAN_TXT) es un fichero. \param[in] idFich Identificador del fichero de trabajo, abierto para escribir. \param[in] nNan Número de veces que se ha de imprimir el valor #GEOC_NAN_TXT, una a continuación de otra. \param[in] formato Cadena de formato para la impresión de cada valor #GEOC_NAN_TXT. \param[in] retCarro Identificador para añadir un retorno de carro y cambio de línea al final de la impresión de datos, independientemente del valor pasado en el argumento \em formato. Dos posibilidades: - 0: No se imprime retorno de carro y cambio de línea al final. - Distinto de 0: Sí se imprime retorno de carro y cambio de línea al final. \note Esta función no comprueba internamente si el fichero de entrada está abierto correctamente. \note Esta función no comprueba internamente si la cadena de formato es correcta. \note Si se ha indicado que se imprima salto de línea y retorno de carro al final, este se imprime aunque \em nNan valga 0. \date 22 de septiembre de 2011: Creación de la función. \todo Esta función no está probada. */ void ImprimeGeocNanTexto(FILE* idFich, const size_t nNan, const char formato[], const int retCarro); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/compilador.h000755 001750 001750 00000012261 12540021550 017655 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup general geopot @{ \file compilador.h \brief Declaración de funciones para la detección de compiladores. \author José Luis García Pallero, jgpallero@gmail.com \date 28 de abril de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _COMPILADOR_H_ #define _COMPILADOR_H_ /******************************************************************************/ /******************************************************************************/ #include /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si el compilador utilizado para compilar este fichero es de la familia GCC. \param[out] noGnu Identificador de que estamos ante un compilador que no es de la familia GCC, diga lo que diga la variable devuelta por la función (ver nota al final de la documentación). Este argumento sólo es utilizado si en la entrada su valor es distinto de \p NULL. Dos posibles valores de salida: - 0: El compilador \b *ES* de la familia GCC. - Distinto de 0: El compilador \b *NO* \b *ES* de la familia GCC. \return Dos posibilidades: - 0: El compilador no pertenece a la familia GCC. - Distinto de 0: El compilador sí pertenece a la familia GCC (para una validez total de este valor hay que tener en cuenta el argumento \em noGnu). \note Esta función realiza la comprobación mediante el chequeo de la existencia de la constante simbólica \p __GNUC__. Este hecho hace que la detección del compilador se lleve a cabo durante la compilación del fichero que contiene a esta función, por lo que hay que tener en cuenta si ésta es llamada desde una función contenida en otro fichero que no fue compilado con un compilador de la familia GCC. \note Algunos compiladores, como el Intel C/C++ Compiler (\p icc), definen por defecto la macro \p __GNUC__, por lo que la detección puede ser errónea. Para estos casos ha de tenerse en cuenta el argumento \em noGnu. \note En las versiones más recientes de \p icc, el argumento \p -no-gcc suprime la definición de \p __GNUC__. \date 11 de octubre de 2009: Creación de la función. */ int EsCompiladorGNU(int* noGnu); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/polil.h000755 001750 001750 00000125322 12540021550 016646 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file polil.h \brief Definición de estructuras y declaración de funciones para el trabajo con polilíneas. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 03 de junio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _POLIL_H_ #define _POLIL_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include"libgeoc/dpeucker.h" #include"libgeoc/errores.h" #include"libgeoc/fgeneral.h" #include"libgeoc/geocnan.h" #include"libgeoc/geocomp.h" #include"libgeoc/polig.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \struct polil \brief Estructura contenedora de los vértices que definen el contorno de una o varias polilíneas. \date 03 de junio de 2011: Creación de la estructura. */ typedef struct { /** \brief Número de elementos de los vectores de coordenadas. */ size_t nElem; /** \brief Vector de polil::nElem elementos, que almacena las coordenadas X de los vértices de la polilínea (o las polilíneas), así como los separadores entre polilíneas. La primera coordenada de cada polilínea se repite al final. */ double* x; /** \brief Vector de polil::nElem elementos, que almacena las coordenadas Y de los vértices de la polilínea (o las polilíneas), así como los separadores entre polilíneas. La primera coordenada de cada polilínea se repite al final. */ double* y; /** \brief Número de polilíneas almacenadas. */ size_t nPolil; /** \brief Vector de polil::nPolig elementos, que almacena las posiciones en los vectores \em x e \em y de inicio de cada polilínea almacenada. */ size_t* posIni; /** \brief Vector de polil::nPolig elementos, que almacena el número de vértices de cada polilínea almacenada. */ size_t* nVert; /** \brief Identificador de si la estructura contiene información acerca de los límites del rectángulo que encierra a cada polilínea almacenada. Dos posibilidades: - 0: La estructura no contiene información de los límites. - Distinto de 0: La estructura sí contiene información de los límites. */ int hayLim; /** \brief Vector de polil::nPolig elementos, que almacena la coordenada X mínima de cada polilínea almacenada. Este campo sólo contiene información si el campo polil::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* xMin; /** \brief Vector de polil::nPolig elementos, que almacena la coordenada X máxima de cada polilínea almacenada. Este campo sólo contiene información si el campo polil::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* xMax; /** \brief Vector de polil::nPolig elementos, que almacena la coordenada Y mínima de cada polilínea almacenada. Este campo sólo contiene información si el campo polil::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* yMin; /** \brief Vector de polil::nPolig elementos, que almacena la coordenada Y máxima de cada polilínea almacenada. Este campo sólo contiene información si el campo polil::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* yMax; }polil; /******************************************************************************/ /******************************************************************************/ /** \brief Indica si hay alguna función compilada en paralelo con OpenMP en el fichero \ref polil.c. \param[out] version Cadena identificadora de la versión de OpenMP utilizada. Este argumento sólo se utiliza si su valor de entrada es distinto de \p NULL y si hay alguna función compilada con OpenMP. \return Dos posibles valores: - 0: No hay ninguna función compilada en paralelo con OpenMP. - Distinto de 0: Sí hay alguna función compilada en paralelo con OpenMP. \note Esta función asume que el argumento \em version tiene suficiente memoria asignada (si es distinto de \p NULL). \date 03 de junio de 2011: Creación de la función. \date 25 de agosto de 2011: Adición del argumento de entrada \em version. */ int GeocParOmpPolil(char version[]); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polil vacía. \return Estructura \ref polil vacía. Los campos escalares se inicializan con el valor 0 y los vectoriales con \p NULL. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \date 26 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ polil* IniciaPolilVacia(void); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para la rutina de creación de una estructura \ref polil a partir de dos vectores que contienen las coordenadas de los vértices. Esta función calcula el número máximo de elementos que almacenarán los vectores de coordenadas de una estructura \ref polil y el número de polilíneas almacenadas en los vectores de trabajo. \param[in] nElem Número de elementos de los vectores de coordenadas originales. \param[in] posNanX Vector que almacena las posiciones de los elementos #GEOC_NAN en el vector \em x de coordenadas originales. \param[in] posNanY Vector que almacena las posiciones de los elementos #GEOC_NAN en el vector \em y de coordenadas originales. \param[in] nNanX Número de elementos del vector \em posNanX. \param[in] nNanY Número de elementos del vector \em posNanY. \param[out] nElemMax Número máximo de elementos que contendrán los vectores de coordenadas de los elementos de la estructura. \param[out] nPolil Número de polilíneas almacenadas en los vectores \em x e \em y de coordenadas originales. \return Variable de error. Tres posibilidades: - #GEOC_ERR_NO_ERROR: Si todo ha ido bien. - #GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL: Si los vectores \em x e \em y de coordenadas originales almacenan un número distinto de polilíneas, es decir, \em nNanX es distinto que \em nNanY. - #GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL: Si algunas polilíneas almacenadas en \em x e \em y son distintas, es decir, las posiciones almacenadas en \em posNanX son distintas de las almacenadas en \em posNanY. \note Esta función no comprueba si el número de elementos de los vectores \em posNanX y \em posNanY es congruente con los valores pasados en \em nNanX y \em nNanY. \date 03 de junio de 2011: Creación de la función. \date 13 de junio de 2011: Corrección de error que hacía que el argumento \em nElemMax que calculase mal si los argumentos \em nNanX y/o \em nNanY valían 0. \note Esta función todavía no está probada. */ int AuxCreaPolil1(const size_t nElem, const size_t* posNanX, const size_t* posNanY, const size_t nNanX, const size_t nNanY, size_t* nElemMax, size_t* nPolil); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para la rutina de creación de una estructura \ref polil a partir de dos vectores que contienen las coordenadas de los vértices. Esta función copia una serie de datos de dos vectores en otros dos. \param[in] x Vector que contiene las coordenadas X de los vértices a copiar. \param[in] y Vector que contiene las coordenadas Y de los vértices a copiar. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] xSal Vector de \em nElem elementos para almacenar los elementos copiados del vector \em x. \param[out] ySal Vector de \em nElem elementos para almacenar los elementos copiados del vector \em y. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y, \em xSal e \em ySal es congruente con los valores pasados en \em nElem, \em incX e \em incY. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void AuxCreaPolil2(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, double* xSal, double* ySal); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para las rutinas de creación de estructuras \ref polil a partir de dos vectores que contienen las coordenadas de los vértices. Esta función crea las polilíneas en el formato de almacenamiento de \ref polil a partir de los vectores de entrada. \param[in] x Vector que contiene las coordenadas X de los vértices de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices de trabajo. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] posNan Vector que almacena las posiciones de los elementos #GEOC_NAN en los vectores \em x e \em y. \param[in] nNan Número de elementos del vector \em posNan. \param[out] xSal Vector para almacenar las coordenadas X de los vértices de las polilíneas creadas. \param[out] ySal Vector para almacenar las coordenadas Y de los vértices de las polilíneas creadas. \param[out] posIni Vector para almacenar las posiciones de inicio de las polilíneas creadas. \param[out] nVert Vector para almacenar el número de vértices de las polilíneas creadas. \param[out] nPtos Número de posiciones con información almacenada en los vectores \em xSal e \em ySal. \param[out] nPolil Número de posiciones con información almacenada en los vectores \em posIni y \em nVert. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y y \em posNan es congruente con los valores pasados en \em nElem, \em incX, \em incY y \em nNan. \note Esta función asume que los vectores \em xSal, \em ySal, \em posIni y \em nVert tienen asignada suficiente memoria. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void AuxCreaPolil3(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, double* xSal, double* ySal, size_t* posIni, size_t* nVert, size_t* nPtos, size_t* nPolil); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polil a partir de dos vectores que contienen las coordenadas de los vértices de una o varias polilíneas. \param[in] x Vector que contiene las coordenadas X de los vértices de la polilínea o polilíneas de trabajo. Si hay varias polilíneas, han de estar separados por un valor #GEOC_NAN. \param[in] y Vector que contiene las coordenadas Y de los vértices de la polilínea o polilíneas de trabajo. Si hay varias polilíneas, han de estar separados por un valor #GEOC_NAN. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] idError Identificador de error. Varias posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL: Los vectores \em x e \em y contienen un número distinto de polilíneas. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL: Los vectores \em x e \em y contienen distintas polilíneas. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \return Estructura \ref polil con las polilíneas pasadas. Si ocurre algún error, se devuelve \p NULL y el motivo del fallo se codifica en la variable \em idError. \note Esta función está paralelizada con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \note Si los vectores \em x e \em y almacenan varias polilíneas, éstas se separan mediante valores #GEOC_NAN. Poner #GEOC_NAN en la primera posición y/o la última es opcional. \note Los posibles valores #GEOC_NAN han de estar en las mismas posiciones en \em x e \em y. \note Esta función no calcula los límites de las polilíneas, por lo que el campo polil::hayLim se inicializa a 0 y los campos polil::xMin, polil::xMax, polil::yMin y polil::yMax se inicializan a \p NULL. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ polil* CreaPolil(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, int* idError); /******************************************************************************/ /******************************************************************************/ /** \brief Enlaza el contenido de una estructura \ref polil a otra. \param[in] poliEnt Estructura \ref polil de entrada, que almacena los datos a enlazar. \param[out] poliSal Estructura \ref polil, cuyos campos serán enlazados a los de la estructura \em poliEnt. Esta estructura ha de estar, como mínimo, inicializada. Al término de la ejecución de la función, las estructuras \em poliEnt y \em poliSal comparten el mismo espacio de memoria en sus argumentos vectoriales. \note Esta función asume que la estructura de entrada \em poligEnt tiene memoria asignada. \note Esta función asume que la estructura de salida \em poligSal está, como mínimo, inicializada. \note Esta función libera la posible memoria asignada a los campos de \em poliSal antes de realizar el enlace. \date 19 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void EnlazaCamposPolil(polil* poliEnt, polil* poliSal); /******************************************************************************/ /******************************************************************************/ /** \brief Copia el contenido de una estructura \ref polil en otra. \param[in] poli Estructura \ref polil de entrada, que almacena los datos a copiar. \param[out] idError Identificador de error. Varias posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL: Los campos polil::x e polil::y de la polilínea de entrada contienenun número distinto de polilíneas. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL: Los campos polig::x e polig::y de la polilínea de entrada contienen distintas polilíneas. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \return Polilínea con los datos contenidos en \em poli copiados. Si ocurre algún error se devuelve \p NULL y la causa se almacena en el argumento \em idError. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \date 09 de julio de 2011: Creación de la función. \note Esta función todavía no está probada. */ polil* CopiaPolil(const polil* poli, int* idError); /******************************************************************************/ /******************************************************************************/ /** \brief Añade el contenido de una estructura \ref polil a otra. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se han añadido las polilíneas de la estructura \em anyade. \param[in] anyade Estructura cuyo contenido será añadido a \em poli. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función asume que la estructura de entrada \ref polil tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de las estructuras de entrada no se libera. \note Si la estructura \em poli guarda información de límites de las polilíneas almacenadas, esta información se calcula también para los nuevos datos (en realidad, si la estructura \em anyade ya los tiene calculados, simplemente se copian). \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ int AnyadePolilPolil(polil* poli, const polil* anyade); /******************************************************************************/ /******************************************************************************/ /** \brief Añade al contenido de una estructura \ref polil un conjunto de polilíneas definidas a partir de un listado con las coordenadas de sus vértices, de la misma forma que el utilizado en la función \ref CreaPolil. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se han añadido las polilíneas pasados en \em x e \em y. \param[in] x Vector que contiene las coordenadas X de los vértices de la polilínea o polilíneas a añadir. Si hay varias polilíneas, han de estar separadas por un valor #GEOC_NAN. \param[in] y Vector que contiene las coordenadas Y de los vértices de la polilínea o polilíneas a añadir. Si hay varias polilíneas, han de estar separadas por un valor #GEOC_NAN. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL: Los vectores \em x e \em y contienen un número distinto de polilíneas. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL: Los vectores \em x e \em y contienen distintas polilíneas. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de la estructura y los vectores de entrada no se libera. \note Si la estructura \em poli guarda información de límites de las polilíneas almacenadas, esta información se calcula también para los nuevos datos. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \note Si los vectores \em x e \em y almacenan varias polilíneas, éstas se separan mediante valores #GEOC_NAN. Poner #GEOC_NAN en la primera posición y/o la última es opcional. \note Los posibles valores #GEOC_NAN han de estar en las mismas posiciones en \em x e \em y. \note Esta función crea internamente una estructura \ref polil para luego añadirla a \em poli con la función \ref AnyadePolilPolil. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ int AnyadeDatosPolil(polil* poli, const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Libera la memoria asignada a una estructura \ref polil. \param[in] datos Estructura \ref polil. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void LibMemPolil(polil* datos); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula los límites de todas las polilíneas almacenados en una estructura \ref polil. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se han añadido los límites de las polilíneas almacenadas. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función está paralelizada con OpenMP. \note Esta función asume que la estructura de entrada \ref polil tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de la estructura de entrada no se libera. \date 03 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ int CalcLimitesPolil(polil* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica un factor de escala y una traslación (en este orden) a las coordenadas de todas las polilíneas almacenadas en una estructura \ref polil. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se ha aplicado un factor de escala y una traslación (en este orden) a las coordenadas de todas las polilíneas almacenadas y, si se indica, a los límites. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] aplicaLim Identificador para aplicar o no los factores de escala y las traslaciones a los límites de las polilíneas (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican los factores de escala ni las traslaciones a los límites. - Distinto de 0: Sí se aplican los factores de escala y las traslaciones a los límites, si estos están calculados en la estructura de entrada. \note Esta función está paralelizada con OpenMP. \note Primero se aplican los factores de escala y luego las traslaciones. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \date 03 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void EscalaYTrasladaPolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica una traslación y un factor de escala (en este orden) a las coordenadas de todas las polilíneas almacenadss en una estructura \ref polil. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se ha aplicado una traslación y un factor de escala (en este orden) a las coordenadas de todas las polilíneas almacenadas y, si se indica, a los límites. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] aplicaLim Identificador para aplicar o no las traslaciones y los factores de escala a los límites de las polilíneas (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican las traslaciones ni los factores de escala a los límites. - Distinto de 0: Sí se aplican las traslaciones y los factores de escala a los límites, si estos están calculados en la estructura de entrada. \note Esta función está paralelizada con OpenMP. \note Primero se aplican las traslaciones y luego los factores de escala. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \date 03 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void TrasladaYEscalaPolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica un factor de escala y una traslación (el orden de aplicación se ha de seleccionar) a las coordenadas de todas las polilíneas almacenadas en una estructura \ref polil. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, se ha aplicado un factor de escala y una traslación (orden a seleccionar) a las coordenadas de todas las polilíneas almacenadas y, si se indica, a los límites. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] orden Orden de aplicación de los factores de escala y traslación. Dos posibilidades: - 0: Primero se aplican los factores de escala y luego las traslaciones \f$x'=f\cdot x+t\f$. - Distinto de 0: Primero se aplican las traslaciones y luego los factores de escala \f$x'=(x+t)\cdot f\f$. \param[in] aplicaLim Identificador para aplicar o no los factores de escala y las traslaciones a los límites de las polilíneas (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican los factores de escala ni las traslaciones a los límites. - Distinto de 0: Sí se aplican los factores de escala y las traslaciones a los límites, si estos están calculados en la estructura de entrada. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \date 03 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void MuevePolil(polil* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int orden, const int aplicaLim); /******************************************************************************/ /******************************************************************************/ /** \brief Elimina vértices de las polilíneas almacenadas en una estructura \ref polil mediante un algoritmo inspirado en el de Douglas-Peucker. Se usa internamente la función \ref AligeraPolilinea. \param[in,out] poli Estructura \ref polil, que almacena una serie de polilíneas. Al término de la ejecución de la función, almacena el resultado de la aplicación a cada polilínea del algoritmo de aligerado de vértices implementado en la función \ref AligeraPolilinea. \param[in] tol Tolerancia para eliminar vértices, en las mismas unidades que las coordenadas de los vértices. Ver la ayuda de la función \ref AligeraPolilinea. \param[in] robusto Identificador para realizar o no un aligerado robusto. Ha de ser un elemento del tipo enumerado #GEOC_DPEUCKER_ROBUSTO. Varias posibilidades: - #GeocDPeuckerRobNo: No se aplica el algoritmo robusto. - #GeocDPeuckerRobSi: Se aplica el algoritmo robusto completo, que garantiza la no ocurrencia de auto intersecciones en la polilínea resultante. Internamente, primero se aplica el tratamiento robusto de la opción #GeocDPeuckerRobOrig y luego el de la opción #GeocDPeuckerRobAuto. - #GeocDPeuckerRobOrig: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos de la polilínea aligerada que se van creando no intersectarán con ninguno de los segmentos que forman los vértices que quedan por procesar de la polilínea original. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. - #GeocDPeuckerRobAuto: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos de la polilínea aligerada que se van creando no intersectarán con ninguno de los segmentos de la polilínea aligerada creados con anterioridad. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. \param[in] nPtosRobusto Número de puntos de la polilínea original a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobOrig. Si se pasa el valor 0, se utilizan todos los puntos hasta el final de la polilínea original. \param[in] nSegRobusto Número de segmentos de la polilínea aligerada a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobAuto. Si se pasa el valor 0, se utilizan todos los segmentos hasta el inicio de la polilínea aligerada. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función asume que \em poli está, como mínimo, inicializada. \note Si \em poli tiene límites calculados en la entrada, también los tendrá en la salida. \note Una polilínea aligerada sólo será válida si después de aplicarle la función \ref AligeraPolilinea mantiene un mínimo de 2 puntos que no sean el mismo (esto sólo puede ocurrir si se pasa un polígono -los vértices de inicio y final coinciden- y sólo quedan al final los extremos). Al término de la ejecución de esta función, el resultado puede ser una estructura \ref polil vacía. \date 09 de julio de 2011: Creación de la función. \date 10 de julio de 2011: Cambio del tipo del argumento \em robusto al tipo enumerado #GEOC_DPEUCKER_ROBUSTO. \date 31 de julio de 2011: Corregido error con índices a la hora de guardar los resultados y modificación para no tomar como válidas las polilíneas que se quedan en sólo dos vértices que sean el mismo. \todo Esta función todavía no está probada. */ int AligeraPolil(polil* poli, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime una línea de cabecera para una polilínea almacenada en una estructura \ref polil. \param[in] poli Estructura \ref polil. \param[in] indice Índice de la polilínea de trabajo en la estructura. \param[in] iniCab Cadena de texto con la que comenzará la cabecera. \param[in] impLim Identificador para imprimir o no los límites de coordenadas de la polilínea de trabajo. Dos posibles valores: - 0: No se imprimen. - Distinto de 0: Sí se imprimen. \param[in] formCoor Cadena de carácteres indicadora del formato para escribir las coordenadas de los límites. Este argumento sólo se usa internamente si se ha indicado la impresión de límites. \param[in] factorX Factor para multiplicar las coordenadas X de los vértices antes de imprimirlas. \param[in] factorY Factor para multiplicar las coordenadas Y de los vértices antes de imprimirlas. \param[in] idFich Identificador de fichero abierto para escribir. \note Esta función está paralelizada con OpenMP. \note La cabecera completa tiene el siguiente formato: iniCab númVert xMín xMáx yMín yMáx. \note Si la estructura no tiene información de límites y se indica que se impriman, los valores se calculan internamente. \note Esta función asume que \em poli es una estructura \ref polil correctamente almacenada. \note Esta función no comprueba si la estructura pasada tiene memoria asignada. \note Esta función no comprueba internamente la validez de los argumentos de formato. \note Esta función no comprueba internamente si el identificador pasado corresponde a un fichero abierto para escribir. \date 18 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void ImprimeCabeceraPolilFichero(const polil* poli, const size_t indice, const char iniCab[], const int impLim, const char formCoor[], const double factorX, const double factorY, FILE* idFich); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime una estructura \ref polil en un fichero. \param[in] poli Estructura \ref polil. \param[in] factorX Factor para multiplicar las coordenadas X de los vértices antes de imprimirlas. \param[in] factorY Factor para multiplicar las coordenadas Y de los vértices antes de imprimirlas. \param[in] iniNan Identificador para imprimir o no la marca de separación de polilíneas (\p NaN) delante de la primera polilínea. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] finNan Identificador para imprimir o no la marca de separación de polilíneas (\p NaN) delante de la última polilínea. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] formCoor Cadena de carácteres indicadora del formato de cada coordenada a imprimir. \param[in] impCabecera Identificador para imprimir o no una cabecera con información general por cada polilínea. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] iniCab Cadena de texto con la que comenzará la cabecera. \param[in] impLim Identificador para imprimir o no en la cabecera los límites de coordenadas de las polilíneas de trabajo. Dos posibles valores: - 0: No se imprimen. - Distinto de 0: Sí se imprimen. \param[in] idFich Identificador de fichero abierto para escribir. \note La cabecera completa tiene el siguiente formato: iniCab númVert xMín xMáx yMín yMáx. \note Si la estructura no tiene información de límites y se indica que se impriman, los valores se calculan internamente. \note Esta función asume que \em poli es una estructura \ref polil correctamente almacenada. \note Esta función no comprueba si la estructura pasada tiene memoria asignada. \note Esta función no comprueba internamente la validez de los argumentos de formato. \note Esta función no comprueba internamente si el identificador pasado corresponde a un fichero abierto para escribir. \date 03 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Adición de la capacidad de escritura de una cabecera y del uso de factores de escala independientes para las coordenadas X e Y. \date 22 de septiembre de 2011: Corregido bug que hacía que, dependiendo del compilador y/o los flags de optimización en la compilación, se imprimiesen mal (con un signo menos delante) los valores Not-a-Number. \note Esta función todavía no está probada. */ void ImprimePolilFichero(const polil* poli, const double factorX, const double factorY, const int iniNan, const int finNan, const char formCoor[], const int impCabecera, const char iniCab[], const int impLim, FILE* idFich); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/constantes.h000755 001750 001750 00000027761 12540021550 017720 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup anespec astro eop general geodesia geom gravim marea @{ \file constantes.h \brief Definición de constantes generales. \author José Luis García Pallero, jgpallero@gmail.com \date 02 de marzo de 2009 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _CONSTANTES_H_ #define _CONSTANTES_H_ /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \typedef geoc_char \brief Nombre del tipo \p char para almacenar números en \p libgeoc. Se declara este tipo para dotar de portabilidad a la biblioteca, debido a que en algunas implementaciones de C la declaración \p char a secas corresponde a un tipo \p unsigned \p char en lugar de a un \p signed \p char, que es el que necesita \p libgeoc cuando almacena un número en un \p char. En la implementación de \p gcc para PowerPC, por ejemplo, el tipo por defecto de un \p char es \p unsigned \p char, lo que hace que se produzcan errores al intentar almacenar números negativos. \date 02 de marzo de 2009: Creación del tipo. */ typedef signed char geoc_char; /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_PI \brief Constante \em PI. Tomada del fichero \p gsl_math.h, de la biblioteca GSL. \date 02 de marzo de 2009: Creación de la constante. */ #define GEOC_CONST_PI (3.14159265358979323846264338328) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_E \brief Constante \em e (base de los logaritmos naturales). Tomada del fichero \p gsl_math.h, de la biblioteca GSL. \date 03 de octubre de 2010: Creación de la constante. */ #define GEOC_CONST_E (2.71828182845904523536028747135) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_GR \brief Paso de grados centesimales a radianes. */ #define GEOC_CONST_GR ((GEOC_CONST_PI)/200.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_RG \brief Paso de radianes a grados centesimales. \date 02 de marzo de 2009: Creación de la constante. */ #define GEOC_CONST_RG (1.0/(GEOC_CONST_GR)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_DR \brief Paso de grados sexagesimales en formato decimal a radianes. \date 02 de marzo de 2009: Creación de la constante. */ #define GEOC_CONST_DR ((GEOC_CONST_PI)/180.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_RD \brief Paso de radianes a grados sexagesimales en formato decimal. \date 02 de marzo de 2009: Creación de la constante. */ #define GEOC_CONST_RD (1.0/(GEOC_CONST_DR)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_SIMUGAL \brief Paso de atracción gravitatoria en el SI (m/s^2) a microgales. \date 05 de noviembre de 2009: Creación de la constante. */ #define GEOC_CONST_SIMUGAL (1.0e8) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_MJD \brief Constante a sustraer a una fecha juliana (en días) para convertirla en fecha juliana modificada (MJD). \date 04 de octubre de 2009: Creación de la constante. */ #define GEOC_CONST_MJD (2400000.5) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_J2000 \brief Constante a sustraer a una fecha juliana (en días) para convertirla en fecha juliana referida a J2000. \date 01 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_J2000 (2451545.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_JISGPS \brief Fecha juliana del día de inicio de las semanas GPS: 6 de enero de 1980, 00:00:00 horas. \date 02 de marzo de 2010: Creación de la constante. */ #define GEOC_CONST_JISGPS (2444244.5) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_MIN_HORA \brief Número de minutos que contiene una hora. \date 19 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_MIN_HORA (60.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_SEG_HORA \brief Número de segundos que contiene una hora. \date 01 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_SEG_HORA (3600.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_SEG_MIN \brief Número de segundos que contiene un minuto \date 19 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_SEG_MIN (60.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_SEG_DIA \brief Número de segundos que contiene un día. \date 24 de octubre de 2009: Creación de la constante. */ #define GEOC_CONST_SEG_DIA (86400.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_HORAS_DIA \brief Número de horas que contiene un día. \date 01 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_HORAS_DIA (24.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_DIAS_SIGLO_JUL \brief Número de días que contiene un siglo juliano. \date 01 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_DIAS_SIGLO_JUL (36525.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_DIAS_SEMANA \brief Número de días que contiene una semana. \date 02 de marzo de 2010: Creación de la constante. */ #define GEOC_CONST_DIAS_SEMANA (7.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_DIAS_ANYO_NORM \brief Número de días que contiene un año normal. \date 02 de marzo de 2010: Creación de la constante. */ #define GEOC_CONST_DIAS_ANYO_NORM (365.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_DIAS_ANYO_BIS \brief Número de días que contiene un año bisiesto. \date 02 de marzo de 2010: Creación de la constante. */ #define GEOC_CONST_DIAS_ANYO_BIS ((GEOC_CONST_DIAS_ANYO_NORM)+1.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_CPD_RH \brief Paso de ciclos por día a radianes por hora. \date 20 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_CPD_RH (2.0*(GEOC_CONST_PI)/(GEOC_CONST_HORAS_DIA)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_RH_CPD \brief Paso de radianes por hora a ciclos por día. \date 20 de diciembre de 2009: Creación de la constante. */ #define GEOC_CONST_RH_CPD (1.0/(GEOC_CONST_CPD_RH)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_G \brief Constante de gravitación universal, en m^3/(kg*s^2). \date 04 de noviembre de 2009: Creación de la constante. */ #define GEOC_CONST_G (6.67428e-11) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_CONST_VRT \brief Velocidad de rotación de la Tierra, en radianes/s. \date 21 de enero de 2011: Creación de la constante. */ #define GEOC_CONST_VRT (7.292115e-5) /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/eucli.h000755 001750 001750 00000026421 12540021550 016630 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom interp @{ \file eucli.h \brief Declaración de funciones para la realización de cálculos de geometría euclídea. \author José Luis García Pallero, jgpallero@gmail.com \date 27 de octubre de 2009 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _EUCLI_H_ #define _EUCLI_H_ /******************************************************************************/ /******************************************************************************/ #include /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la distancia euclídea entre dos puntos en el plano. \param[in] x1 Coordenada X del punto inicial. \param[in] y1 Coordenada Y del punto inicial. \param[in] x2 Coordenada X del punto final. \param[in] y2 Coordenada Y del punto final. \return Distancia euclídea entre los dos puntos. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \date 27 de octubre de 2009: Creación de la función. \todo Esta función todavía no está probada. */ double Dist2D(const double x1, const double y1, const double x2, const double y2); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la distancia euclídea entre dos puntos en el plano y realiza la propagación de errores correspondiente. \param[in] x1 Coordenada X del punto inicial. \param[in] y1 Coordenada Y del punto inicial. \param[in] x2 Coordenada X del punto final. \param[in] y2 Coordenada Y del punto final. \param[in] varx1 Varianza de la coordenada X del punto inicial. \param[in] varx1y1 Covarianza entre las coordenadas X e Y del punto inicial. \param[in] vary1 Varianza de la coordenada Y del punto inicial. \param[in] varx2 Varianza de la coordenada X del punto final. \param[in] varx2y2 Covarianza entre las coordenadas X e Y del punto final. \param[in] vary2 Varianza de la coordenada Y del punto final. \param[out] dist Distancia euclídea entre los dos puntos. \param[out] varDist Varianza de la distancia calculada. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \note Las unidades de las matrices de varianza-covarianza han de ser congruentes con las de las coordenadas pasadas. \date 27 de octubre de 2009: Creación de la función. \todo Esta función todavía no está probada. */ void Dist2DVC(const double x1, const double y1, const double x2, const double y2, const double varx1, const double varx1y1, const double vary1, const double varx2, const double varx2y2, const double vary2, double* dist, double* varDist); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la distancia euclídea entre dos puntos en el espacio. \param[in] x1 Coordenada X del punto inicial. \param[in] y1 Coordenada Y del punto inicial. \param[in] z1 Coordenada Z del punto inicial. \param[in] x2 Coordenada X del punto final. \param[in] y2 Coordenada Y del punto final. \param[in] z2 Coordenada Z del punto final. \return Distancia euclídea entre los dos puntos. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \date 27 de octubre de 2009: Creación de la función. \todo Esta función todavía no está probada. */ double Dist3D(const double x1, const double y1, const double z1, const double x2, const double y2, const double z2); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la distancia euclídea entre dos puntos en el espacio y realiza la propagación de errores correspondiente. \param[in] x1 Coordenada X del punto inicial. \param[in] y1 Coordenada Y del punto inicial. \param[in] z1 Coordenada Z del punto inicial. \param[in] x2 Coordenada X del punto final. \param[in] y2 Coordenada Y del punto final. \param[in] z2 Coordenada Z del punto final. \param[in] varx1 Varianza de la coordenada X del punto inicial. \param[in] varx1y1 Covarianza entre las coordenadas X e Y del punto inicial. \param[in] varx1z1 Covarianza entre las coordenadas X y Z del punto inicial. \param[in] vary1 Varianza de la coordenada Y del punto inicial. \param[in] vary1z1 Covarianza entre las coordenadas Y y Z del punto inicial. \param[in] varz1 Varianza de la coordenada Z del punto inicial. \param[in] varx2 Varianza de la coordenada X del punto final. \param[in] varx2y2 Covarianza entre las coordenadas X e Y del punto final. \param[in] varx2z2 Covarianza entre las coordenadas X y Z del punto final. \param[in] vary2 Varianza de la coordenada Y del punto final. \param[in] vary2z2 Covarianza entre las coordenadas Y y Z del punto final. \param[in] varz2 Varianza de la coordenada Z del punto final. \param[out] dist Distancia euclídea entre los dos puntos. \param[out] varDist Varianza de la distancia calculada. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \note Las unidades de las matrices de varianza-covarianza han de ser congruentes con las de las coordenadas pasadas. \date 27 de octubre de 2009: Creación de la función. \todo Esta función todavía no está probada. */ void Dist3DVC(const double x1, const double y1, const double z1, const double x2, const double y2, const double z2, const double varx1, const double varx1y1, const double varx1z1, const double vary1, const double vary1z1, const double varz1, const double varx2, const double varx2y2, const double varx2z2, const double vary2, const double vary2z2, const double varz2, double* dist, double* varDist); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el ángulo formado por dos vectores en el plano. \param[in] x1 Coordenada X del primer vector. \param[in] y1 Coordenada Y del primer vector. \param[in] x2 Coordenada X del segundo vector. \param[in] y2 Coordenada Y del segundo vector. \return Ángulo formado por los dos vectores, en radianes. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \date 04 de julio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ double AnguloVecPlano(const double x1, const double y1, const double x2, const double y2); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la altura de un triángulo a partir de las coordenadas de sus vértices. \param[in] xVert Coordenada X del vértice a partir del cual se calculará la altura. \param[in] yVert Coordenada Y del vértice a partir del cual se calculará la altura. \param[in] xBase1 Coordenada X del primer punto de la base del triángulo. \param[in] yBase1 Coordenada Y del primer punto de la base del triángulo. \param[in] xBase2 Coordenada X del segundo punto de la base del triángulo. \param[in] yBase2 Coordenada Y del segundo punto de la base del triángulo. \return Altura del triángulo, dada como la longitud del segmento que, partiendo del vértice pasado, corta en ángulo recto a la base. \note Esta función asume que todas las coordenadas vienen dadas en las mismas unidades. \date 04 de julio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ double AlturaTriangulo(const double xVert, const double yVert, const double xBase1, const double yBase1, const double xBase2, const double yBase2); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/geocomp.h000644 001750 001750 00000023114 12540021550 017151 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \defgroup geocomp Módulo GEOC-OMP \ingroup anespec general geodesia geom geopot gravim mmcc \brief En este módulo se reúnen constantes y funciones para la obtención de información de la implementación de OpenMP usada. @{ \file geocomp.h \brief Declaración de macros y funciones para la obtención de información de la implementación de OpenMP usada. \author José Luis García Pallero, jgpallero@gmail.com \date 25 de agosto de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _GEOCOMP_H_ #define _GEOCOMP_H_ /******************************************************************************/ /******************************************************************************/ #include /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_1_0 \brief Valor (fecha YYYYMM) de la macro \p _OPENMP para la versión 1.0 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_1_0 (199810) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_2_0 \brief Valor (fecha YYYYMM) de la macro \p _OPENMP para la versión 2.0 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_2_0 (200203) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_2_5 \brief Valor (fecha YYYYMM) de la macro \p _OPENMP para la versión 2.5 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_2_5 (200505) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_3_0 \brief Valor (fecha YYYYMM) de la macro \p _OPENMP para la versión 3.0 de OpenMP. \date 22 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_3_0 (200805) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_3_1 \brief Valor (fecha YYYYMM) de la macro \p _OPENMP para la versión 3.1 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_3_1 (201107) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_1_0 \brief Cadena de texto identificadora de la versión 1.0 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_1_0 "1.0" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_2_0 \brief Cadena de texto identificadora de la versión 2.0 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_2_0 "2.0" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_2_5 \brief Cadena de texto identificadora de la versión 2.5 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_2_5 "2.5" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_3_0 \brief Cadena de texto identificadora de la versión 3.0 de OpenMP. \date 22 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_3_0 "3.0" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_3_1 \brief Cadena de texto identificadora de la versión 3.1 de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_3_1 "3.1" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_F_DESC \brief Fecha de versión de OpenMP desconocida. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_F_DESC (0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_V_DESC \brief Versión de OpenMP correspondiente a un valor desconocido de la macro \p _OPENMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_V_DESC "0.0" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_OMP_LON_CAD_VERS \brief Longitud de la cadena de texto que almacena la versión de OpenMP. \date 25 de agosto de 2011: Creación de la constante. */ #define GEOC_OMP_LON_CAD_VERS (10) /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la versión de OpenMP a partir del valor de la macro \p _OPENMP. \param[in] macro_OPENMP Valor de la macro \p _OPENMP. \param[out] version Versión de OpenMP correspondiente al valor de la macro. Si el argumento \em macro_OPENMP almacena un valor desconocido, se devuelve #GEOC_OMP_V_DESC. \note Esta función asume que \em version tiene asignada suficiente memoria: como mínimo, espacio para una cadena de #GEOC_OMP_LON_CAD_VERS carácteres. \date 25 de agosto de 2011: Creación de la función. */ void VersionOpenMP(const int macro_OPENMP, char version[]); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la fecha (el valor de la macro \p _OPENMP) de una versión de OpenMP dada. \param[in] version Cadena de versión de OpenMP, tal como es calculada por la función \ref VersionOpenMP. \return Fecha, en el formato YYYYMM, correspondiente a la versión. Este valor debería coincidir con la macro \p _OPENMP de la implementación de OpenMP usada. \note En caso de pasar una cadena de versión errónea o desconocida, la función devuelve #GEOC_OMP_F_DESC. \date 25 de agosto de 2011: Creación de la función. */ int FechaVersionOpenMP(const char version[]); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/errores.h000755 001750 001750 00000136375 12540021550 017222 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \defgroup errores Módulo ERRORES \ingroup anespec eop fichero geodesia geom general geopot gshhs marea matriz \ingroup mmcc orden snx texto \brief En este módulo se reúnen los ficheros necesarios para realizar el tratamiento de errores que puedan ocurrir en la biblioteca. @{ \file errores.h \brief Declaración de funciones y constantes para el tratamiento de errores. En el momento de la compilación ha de seleccionarse el comportamiento de la función \ref GeocError. Para realizar la selección es necesario definir las variables para el preprocesador \em ESCRIBE_MENSAJE_ERROR si se quiere que la función imprima un mensaje de error y/o \em FIN_PROGRAMA_ERROR si se quiere que la función termine la ejecución del programa en curso. Si no se define ninguna variable, la función no ejecuta ninguna acción. En \p gcc, las variables para el preprocesador se pasan como \em -DXXX, donde \em XXX es la variable a introducir. \author José Luis García Pallero, jgpallero@gmail.com \date 06 de marzo de 2009 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include #include /******************************************************************************/ /******************************************************************************/ #ifndef _ERRORES_H_ #define _ERRORES_H_ /******************************************************************************/ /******************************************************************************/ //GENERAL #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PLINEA \brief Palabra \em Línea para ser utilizada en el mensaje que imprime la macro #GEOC_ERROR. Esta constante se define porque el preprocesador del compilador \p pgcc no soporta letras con tilde escritas directamente en las órdenes a ejecutar por las macros. \date 10 de enero de 2011: Creación de la constante. */ #define GEOC_PLINEA "Línea" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_TIPO_ERR_NADA \brief Indicador de que la función \ref GeocError no hace nada. \date 09 de enero de 2011: Creación de la constante. */ #define GEOC_TIPO_ERR_NADA 0 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_TIPO_ERR_MENS_Y_EXIT \brief Indicador de que la función \ref GeocError imprime un mensaje descriptivo en la salida de error \em stderr y termina la ejecución del programa en curso. \date 09 de enero de 2011: Creación de la constante. */ #define GEOC_TIPO_ERR_MENS_Y_EXIT 1 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_TIPO_ERR_MENS \brief Indicador de que la función \ref GeocError imprime un mensaje descriptivo en la salida de error \em stderr y no termina la ejecución del programa en curso. \date 09 de enero de 2011: Creación de la constante. */ #define GEOC_TIPO_ERR_MENS 2 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_TIPO_ERR_EXIT \brief Indicador de que la función \ref GeocError termina la ejecución del programa en curso. \date 09 de enero de 2011: Creación de la constante. */ #define GEOC_TIPO_ERR_EXIT 3 /******************************************************************************/ /******************************************************************************/ /** \brief Indica el tipo de acción que realiza la función \ref GeocError. \return Cuatro posibles valores: - #GEOC_TIPO_ERR_NADA: La función \ref GeocError no hace nada. - #GEOC_TIPO_ERR_MENS_Y_EXIT: La función \ref GeocError imprime un mensaje descriptivo en la salida de error \em stderr y termina la ejecución del programa en curso. - #GEOC_TIPO_ERR_MENS: La función \ref GeocError imprime un mensaje descriptivo en la salida de error \em stderr y no detiene la ejecución del programa en curso. - #GEOC_TIPO_ERR_EXIT: La función \ref GeocError detiene la ejecución del programa en curso. \date 09 de enero de 2011: Creación de la función. */ int GeocTipoError(void); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime un mensaje en la salida de error \em stderr y/o sale del programa en ejecución. \param[in] mensaje Cadena de texto a imprimir. \param[in] funcion Nombre de la función desde donde se ha invocado a esta función. \note Si este fichero se compila con las variables para el preprocesador \em ESCRIBE_MENSAJE_ERROR y \em FIN_PROGRAMA_ERROR, esta función imprime el mensaje de error y termina la ejecución del programa en curso mediante la llamada a la función \em exit(EXIT_FAILURE), de la biblioteca estándar de C. \note Si este fichero se compila con la variable para el preprocesador \em ESCRIBE_MENSAJE_ERROR, esta función imprime el mensaje de error. \note Si este fichero se compila con la variable para el preprocesador \em FIN_PROGRAMA_ERROR, esta función termina la ejecución del programa en curso mediante la llamada a la función \em exit(EXIT_FAILURE), de la biblioteca estándar de C. \note Si este fichero se compila sin variables para el preprocesador, esta función no hace nada. \date 10 de enero de 2011: Creación de la función. */ void GeocError(const char mensaje[], const char funcion[]); /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERROR \brief Macro para imprimir un mensaje en la salida de error \em stderr y/o sale del programa en ejecución. \param[in] mensaje Cadena de texto a imprimir. \note Esta macro llama internamente a la función \ref GeocError. \note Esta macro pasa como argumento \em funcion a \ref GeocError la variable del preprocesador \em __func__, de C99. \date 10 de enero de 2011: Creación de la macro. */ #define GEOC_ERROR(mensaje) \ { \ if(GeocTipoError()!=GEOC_TIPO_ERR_NADA) \ { \ fprintf(stderr,"\n\n"); \ fprintf(stderr,"********************\n********************\n"); \ fprintf(stderr,GEOC_PLINEA" %d del fichero '%s'\n",__LINE__,__FILE__); \ GeocError(mensaje,(const char*)__func__); \ fprintf(stderr,"********************\n********************\n\n"); \ } \ else \ { \ GeocError(mensaje,(const char*)__func__); \ } \ } /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //GENERAL #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NO_ERROR \brief Indicador de que no ha ocurrido ningun error. \date 06 de marzo de 2009: Creación de la constante. */ #define GEOC_ERR_NO_ERROR 0 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_LECTURA_FICHERO \brief Indicador de que ha ocurrido un error en la lectura de un fichero. \date 06 de marzo de 2009: Creación de la constante. */ #define GEOC_ERR_LECTURA_FICHERO 1001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_ESCRITURA_FICHERO \brief Indicador de que ha ocurrido un error en escritura de un fichero. \date 20 de agosto de 2009: Creación de la constante. */ #define GEOC_ERR_ESCRITURA_FICHERO 1002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_QUEDAN_DATOS_EN_FICHERO \brief Indicador de que quedan datos por leer en un fichero. \date 06 de marzo de 2009: Creación de la constante. */ #define GEOC_ERR_QUEDAN_DATOS_EN_FICHERO 1003 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NO_QUEDAN_DATOS_EN_FICHERO \brief Indicador de que no quedan datos por leer en un fichero. \date 25 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_NO_QUEDAN_DATOS_EN_FICHERO 1004 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NO_HAY_DATOS_EN_FICHERO \brief Indicador de que no hay datos a leer en un fichero. \date 02 de diciembre de 2010: Creación de la constante. */ #define GEOC_ERR_NO_HAY_DATOS_EN_FICHERO 1005 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_LINEA_LARGA_EN_FICHERO \brief Indicador de que una línea de un fichero es demasiado larga. \date 23 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_LINEA_LARGA_EN_FICHERO 1006 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_LINEA_CORTA_EN_FICHERO \brief Indicador de que una línea de un fichero es demasiado corta. \date 23 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_LINEA_CORTA_EN_FICHERO 1007 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_ARG_ENTRADA_INCORRECTO \brief Indicador de que un argumento de entrada de una función es incorrecto. \date 06 de marzo de 2009: Creación de la constante. */ #define GEOC_ERR_ARG_ENTRADA_INCORRECTO 1008 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_ASIG_MEMORIA \brief Indicador de que ha ocurrido un error en la asignación de memoria. \date 06 de marzo de 2009: Creación de la constante. */ #define GEOC_ERR_ASIG_MEMORIA 1009 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_FUERA_DOMINIO \brief Indicador de que ha ocurrido un error porque un dato está fuera de dominio. \date 04 de octubre de 2009: Creación de la constante. */ #define GEOC_ERR_FUERA_DOMINIO 1010 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_FUERA_DOMINIO_MAYOR \brief Indicador de que ha ocurrido un error porque un dato está fuera de dominio. En este caso, el dato se sale del dominio por arriba (porque es demasiado grande). \date 26 de octubre de 2009: Creación de la constante. */ #define GEOC_ERR_FUERA_DOMINIO_MAYOR 1011 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_FUERA_DOMINIO_MENOR \brief Indicador de que ha ocurrido un error porque un dato está fuera de dominio. En este caso, el dato se sale del dominio por abajo (porque es demasiado pequeño). \date 26 de octubre de 2009: Creación de la constante. */ #define GEOC_ERR_FUERA_DOMINIO_MENOR 1012 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_INTERP \brief Indicador de que ha ocurrido un error en una interpolación. \date 15 de mayo de 2010: Creación de la constante. */ #define GEOC_ERR_INTERP 1013 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_INTERP_NO_DATO \brief Indicador de que no hay datos para realizar una interpolación. \date 30 de mayo de 2010: Creación de la constante. */ #define GEOC_ERR_INTERP_NO_DATO 1014 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_DIV_ENTRE_CERO \brief Indicador de que se ha realizado una división entre cero. \date 26 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_DIV_ENTRE_CERO 1015 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_DIM_MATRIZ \brief Indicador de dimensiones de una matriz erróneas. \date 02 de diciembre de 2010: Creación de la constante. */ #define GEOC_ERR_DIM_MATRIZ 1016 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_MATRIZ_SINGULAR \brief Indicador de matriz singular. \date 12 de marzo de 2011: Creación de la constante. */ #define GEOC_ERR_MATRIZ_SINGULAR 1017 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //EOP #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_EOP_ERRORES \brief Indicador de que ha ocurrido un error porque una estructura eop no contiene información de errores. \date 04 de octubre de 2009: Creación de la constante. */ #define GEOC_ERR_EOP_ERRORES 2001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_EOP_DOS_PUNTOS \brief Indicador de que ha ocurrido un error porque en una interpolación cuadrática sólo hay dos puntos disponibles. \date 12 de octubre de 2009: Creación de la constante. */ #define GEOC_ERR_EOP_DOS_PUNTOS 2002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_EOP_NO_DATOS \brief Indicador de que una estructura eop no contiene datos. \date 19 de junio de 2010: Creación de la constante. */ #define GEOC_ERR_EOP_NO_DATOS 2003 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //SINEX #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_LINEA_ILEGAL \brief Indicador de que una línea de un fichero SINEX no comienza por una de las cadenas permitidas (#GEOC_SNX_CAD_COMENTARIO, #GEOC_SNX_CAD_INI_CABECERA, #GEOC_SNX_CAD_INI_BLOQUE, #GEOC_SNX_CAD_FIN_BLOQUE o #GEOC_SNX_CAD_INI_DATOS). \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_LINEA_ILEGAL 3001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_LINEA_LARGA \brief Indicador de que una línea de un fichero SINEX es demasiado larga (más de #GEOC_SNX_LON_MAX_LIN_FICH carácteres). \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_LINEA_LARGA 3002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_LINEA_CORTA \brief Indicador de que una línea de un fichero SINEX es demasiado corta. \date 29 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_LINEA_CORTA 3003 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_NO_BLOQUES \brief Indicador de que en un fichero SINEX no hay bloques válidos. \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_NO_BLOQUES 3004 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_ID_BLOQUE_DISTINTO \brief Indicador de que en un fichero SINEX los identificadores de bloque tras las marcas de inicio y fin son distintos. \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_ID_BLOQUE_DISTINTO 3005 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BLOQUE_NO_INICIO \brief Indicador de que en un fichero SINEX un bloque no tiene identificador de inicio. \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_BLOQUE_NO_INICIO 3006 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BLOQUE_NO_FIN \brief Indicador de que en un fichero SINEX un bloque no tiene identificador de fin. \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_BLOQUE_NO_FIN 3007 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_NO_FIN_FICH \brief Indicador de que un fichero SINEX no tiene indicador de fin de fichero. \date 28 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_NO_FIN_FICH 3008 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_NO_ID_CABECERA \brief Indicador de que un fichero SINEX no tiene indicador cabecera. \date 29 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_NO_ID_CABECERA 3009 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_FORMATO_CABECERA \brief Indicador de que un fichero SINEX tiene una cabecera que no respeta el formato. \date 29 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_FORMATO_CABECERA 3010 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_CODFICH_INC \brief Indicador de que un fichero SINEX tiene un indicador de código de tipo de fichero incorrecto. \date 05 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_CODFICH_INC 3011 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_TIPODOC_INC \brief Indicador de que un fichero SINEX tiene un indicador de tipo de documento incorrecto. \date 05 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_TIPODOC_INC 3012 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_VERS_INC \brief Indicador de que un fichero SINEX tiene un indicador de versión incorrecto. \date 30 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_VERS_INC 3013 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_FECHA_INC \brief Indicador de que una fecha es incorrecta en un fichero SINEX. \date 30 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_FECHA_INC 3014 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_CODOBS_INC \brief Indicador de que el código de observación es incorrecto en un fichero SINEX. \date 30 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_CODOBS_INC 3015 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_CODCONSTR_INC \brief Indicador de que el código de constreñimiento es incorrecto en un fichero SINEX. \date 30 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_CODCONSTR_INC 3016 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_SOLCONT_INC \brief Indicador de que un código de solución contenida en un fichero SINEX es incorrecto. \date 31 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_SOLCONT_INC 3017 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_NSOLCONT_INC \brief Indicador de que un código de solución contenida en un fichero SINEX es incorrecto. \date 31 de diciembre de 2009: Creación de la constante. */ #define GEOC_ERR_SNX_NSOLCONT_INC 3018 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_FORM_LINEA_INC \brief Indicador de que una línea de un fichero SINEX tiene un formato incorrecto. \date 01 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_FORM_LINEA_INC 3019 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BFR_TIPOINF_INC \brief Indicador de que el código de tipo de información de un bloque FILE/REFERENCE de un fichero SINEX es incorrecto. \date 01 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BFR_TIPOINF_INC 3020 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BND_CODNUT_INC \brief Indicador de que el código de modelo de nutación de un bloque NUTATION/DATA de un fichero SINEX es incorrecto. \date 03 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BND_CODNUT_INC 3021 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BPD_CODPREC_INC \brief Indicador de que el código de modelo de precesión de un bloque PRECESSION/DATA de un fichero SINEX es incorrecto. \date 03 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BPD_CODPREC_INC 3022 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSII_GRADLATSEX_INC \brief Indicador de que un valor de grados sexagesimales de latitud de un bloque SITE/ID de un fichero SINEX es incorrecto. \date 15 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSII_GRADLATSEX_INC 3023 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSII_GRADLONSEX_INC \brief Indicador de que un valor de grados sexagesimales de longitud de un bloque SITE/ID de un fichero SINEX es incorrecto. \date 15 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSII_GRADLONSEX_INC 3024 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSII_MINSEX_INC \brief Indicador de que un valor de minutos sexagesimales de un bloque SITE/ID de un fichero SINEX es incorrecto. \date 15 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSII_MINSEX_INC 3025 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSII_SEGSEX_INC \brief Indicador de que un valor de segundos sexagesimales de un bloque SITE/ID de un fichero SINEX es incorrecto. \date 15 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSII_SEGSEX_INC 3026 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSE_CODSREX_INC \brief Indicador de que un código del sistema de referencia utilizado para definir la excentricidad de una antena de un bloque SITE/ECCENTRICITY de un fichero SINEX es incorrecto. \date 23 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSE_CODSREX_INC 3027 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_CODGNSS_INC \brief Indicador de que un código de constelación GNSS utilizado en un fichero SINEX es incorrecto. \date 28 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_CODGNSS_INC 3028 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSAP_CODFREC_INC \brief Indicador de que un código frecuencia de satélite GNSS de un bloque SATELLITE/PHASE_CENTER de un fichero SINEX es incorrecto. \date 28 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSAP_CODFREC_INC 3029 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSAP_TIPOPCV_INC \brief Indicador de que un código indicador de tipo de variación del centro de fase de un bloque SATELLITE/PHASE_CENTER de un fichero SINEX es incorrecto. \date 28 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSAP_TIPOPCV_INC 3030 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSAP_MODAPPCV_INC \brief Indicador de que un código indicador de modelo de aplicación de las variaciones del centro de fase de un bloque SATELLITE/PHASE_CENTER de un fichero SINEX es incorrecto. \date 28 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSAP_MODAPPCV_INC 3031 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_BSOES_IDPARAM_INC \brief Indicador de que un identificador de parámetro estadístico de un bloque SOLUTION/STATISTICS de un fichero SINEX es incorrecto. \date 28 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_BSOES_IDPARAM_INC 3032 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_IDUNID_INC \brief Indicador de que un identificador de unidades utilizado en un fichero SINEX es incorrecto. \date 29 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_IDUNID_INC 3033 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_TIPPAR_INC \brief Indicador de que un identificador de tipo de parámetro utilizado en un fichero SINEX es incorrecto. \date 29 de enero de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_TIPPAR_INC 3034 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_PTRIAN_INC \brief Indicador de que un identificador de parte triangular de una matriz simétrica utilizado en un fichero SINEX es incorrecto. \date 17 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_PTRIAN_INC 3035 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_TIPOMAT_INC \brief Indicador de que un identificador de tipo de matriz utilizado en un fichero SINEX es incorrecto. \date 17 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_TIPOMAT_INC 3036 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_SNX_POSMAT_INC \brief Indicador de que una posición en una matriz almacenada en un fichero SINEX es incorrecta. \date 17 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_SNX_POSMAT_INC 3037 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //GTS #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GTS_VERT_FHULL \brief Indicador de que un vértice de una nube de puntos está fuera del \em convex \em hull que la engloba. \date 09 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_GTS_VERT_FHULL 4001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GTS_VERT_FSUP \brief Indicador de que un vértice está fuera de una superficie. \date 22 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_GTS_VERT_FSUP 4002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GTS_VERT_DUPL \brief Indicador de que un vértice de una nube de puntos está duplicado. \date 09 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_GTS_VERT_DUPL 4003 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GTS_CONF_CONSTR \brief Indicador de que ha habido un conflicto con un constreñimiento en un proceso de triangulación. \date 09 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_GTS_CONF_CONSTR 4004 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //PMAREA #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PMAREA_NO_HAY_BLOQUE \brief Indicador de que no existe un bloque buscado en un fichero. \date 24 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_PMAREA_NO_HAY_BLOQUE 5001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PMAREA_LIN_FICH_INC \brief Indicador de que una línea de fichero de parámetros de marea es incorrecta. \date 25 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_PMAREA_LIN_FICH_INC 5002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PMAREA_DEF_BLOQUE_INC \brief Indicador de que una definición de bloque de parámetros de marea en un fichero es incorrecta. \date 25 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_PMAREA_DEF_BLOQUE_INC 5003 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PMAREA_LIM_FDOM \brief Indicador de que alguno de los límites de la malla está fuera de dominio. \date 25 de abril de 2010: Creación de la constante. */ #define GEOC_ERR_PMAREA_LIM_FDOM 5004 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //GEOPOT #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRADO_ORDEN_MAL \brief Indicador de que los grados y/u órdenes pasados a una función no son correctos. \date 25 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRADO_ORDEN_MAL 6001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRACE_LINFO_NO \brief Indicador de que no hay línea (o la que hay no es la primera) de información general de un fichero de un desarrollo del potencial de la Tierra en armónicos esféricos en formato de GRACE. \date 16 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRACE_LINFO_NO 6002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRACE_LINFO_REPE \brief Indicador de que la línea de información general de un fichero de un desarrollo del potencial de la Tierra en armónicos esféricos en formato de GRACE está repetida. \date 16 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRACE_LINFO_REPE 6003 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRACE_CAB_INCOMP \brief Indicador de cabecera incompleta en un fichero de un desarrollo del potencial de la Tierra en armónicos esféricos en formato de GRACE está repetida. \date 17 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRACE_CAB_INCOMP 6004 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRACE_MEZCLA_TIPO_COEF \brief Indicador de que en un fichero de un desarrollo del potencial de la Tierra en armónicos esféricos en formato de GRACE hay definiciones de coeficientes de distintas versiones. \date 23 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRACE_MEZCLA_TIPO_COEF 6005 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GEOPOT_GRACE_NLINEAS_DATOS_MAL \brief Indicador de que en un fichero de un desarrollo del potencial de la Tierra en armónicos esféricos en formato de GRACE no coinciden el número de líneas de datos leídas en dos pasadas distintas sobre el fichero. \date 24 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_GEOPOT_GRACE_NLINEAS_DATOS_MAL 6006 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //NUMLOVE #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NUMLOVE_NO_HAY_BLOQUE \brief Indicador de que no existe un bloque buscado en un fichero. \date 29 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_NUMLOVE_NO_HAY_BLOQUE 7001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NUMLOVE_DEF_BLOQUE_INC \brief Indicador de que una línea de fichero de números de Love es incorrecta. \date 29 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_NUMLOVE_DEF_BLOQUE_INC 7002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_NUMLOVE_LIN_FICH_INC \brief Indicador de que una definición de bloque de números de Love en un fichero es incorrecta. \date 29 de noviembre de 2010: Creación de la constante. */ #define GEOC_ERR_NUMLOVE_LIN_FICH_INC 7003 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //GSHHS #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GSHHS_VERS_ANTIGUA \brief Indicador de que la versión de un fichero de GSHHS es antigua. \date 16 de abril de 2011: Creación de la constante. */ #define GEOC_ERR_GSHHS_VERS_ANTIGUA 8001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_GSHHS_CREA_POLI \brief Indicador de que ha ocurrido un error de tipo #GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG o #GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG al crear una estructura \ref polig o \ref polil \date 19 de junio de 2011: Creación de la constante. */ #define GEOC_ERR_GSHHS_CREA_POLI 8002 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //POLIG #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG \brief Indicador de que dos vectores de coordenadas no contienen el mismo número de polígonos. \date 27 de mayo de 2011: Creación de la constante. */ #define GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG 9001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG \brief Indicador de que dos vectores de coordenadas no contienen los mismos polígonos. \date 27 de mayo de 2011: Creación de la constante. */ #define GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG 9002 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //POLIL #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL \brief Indicador de que dos vectores de coordenadas no contienen el mismo número de polilíneas. \date 03 de junio de 2011: Creación de la constante. */ #define GEOC_ERR_POLIL_VEC_DISTINTO_NUM_POLIL 10001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL \brief Indicador de que dos vectores de coordenadas no contienen las mismas polilíneas. \date 03 de junio de 2011: Creación de la constante. */ #define GEOC_ERR_POLIL_VEC_DISTINTAS_POLIL 10002 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ //PROYEC #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PROYEC_INI_PROJ \brief Indicador de que ha ocurrido un error en la inicialización de una proyección de PROJ.4. \date 31 de mayo de 2011: Creación de la constante. */ #define GEOC_ERR_PROYEC_INI_PROJ 11001 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PROYEC_NO_INV_PROJ \brief Indicador de que una proyección cartográfica de PROJ.4 no tiene paso inverso. \date 31 de mayo de 2011: Creación de la constante. */ #define GEOC_ERR_PROYEC_NO_INV_PROJ 11002 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ERR_PROYEC_PROJ_ERROR \brief Indicador de que ha ocurrido un error al proyectar un punto con PROJ.4. \date 31 de mayo de 2011: Creación de la constante. */ #define GEOC_ERR_PROYEC_PROJ_ERROR 11003 /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/recpolil.h000755 001750 001750 00000055757 12540021550 017356 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file recpolil.h \brief Definición de estructuras y declaración de funciones para el recorte de polilíneas por medio de polígonos. \author José Luis García Pallero, jgpallero@gmail.com \date 04 de junio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _RECPOLIL_H_ #define _RECPOLIL_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include"libgeoc/errores.h" #include"libgeoc/eucli.h" #include"libgeoc/geocnan.h" #include"libgeoc/greiner.h" #include"libgeoc/polig.h" #include"libgeoc/polil.h" #include"libgeoc/ptopol.h" #include"libgeoc/segmento.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_RECPOLIL_BUFFER_PTOS \brief Número de puntos para ir asignando memoria en bloques para las polilíneas de salida en la funcion \ref Paso2Recpolil. Ha de ser un número mayor o igual a 2. \date 04 de junio de 2011: Creación de la constante. */ #define GEOC_RECPOLIL_BUFFER_PTOS 100 /******************************************************************************/ /******************************************************************************/ /** \enum GEOC_OP_BOOL_POLIL \brief Operación booleana entre polilínea y polígono. \date 04 de junio de 2011: Creación del tipo. */ enum GEOC_OP_BOOL_POLIL { /** \brief Polilínea interior al polígono. */ GeocOpBoolDentro=111, /** \brief Polilínea exterior al polígono. */ GeocOpBoolFuera=112 }; /******************************************************************************/ /******************************************************************************/ /** \struct _vertPolilClip \brief Estructura de definición de un vértice de una polilínea usada en operaciones de recorte. La polilínea se almacena en memoria como una lista doblemente enlazada de vértices. \date 04 de junio de 2011: Creación de la estructura. */ typedef struct _vertPolilClip { /** \brief Coordenada X del vértice. */ double x; /** \brief Coordenada Y del vértice. */ double y; /** \brief Vértice anterior. */ struct _vertPolilClip* anterior; /** \brief Vértice siguiente. */ struct _vertPolilClip* siguiente; /** \brief Indicador de punto de la polilínea original. Dos posibilidades: - 0: No es un punto de la polilínea original. - Distinto de 0: Sí es un punto de la polilínea original. */ char orig; /** \brief Posición del vértice con respecto al polígono de recorte. Tres posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera del polígono. - #GEOC_PTO_BORDE_POLIG: El punto está en el borde o en un vértice del polígono. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro del polígono. */ char pos; /** \brief Distancia, en tanto por uno, de un nodo de intersección con respecto al primer vértice del segmento que lo contiene. */ double alfa; }vertPolilClip; /******************************************************************************/ /******************************************************************************/ /** \brief Crea un vértice de tipo \ref _vertPolilClip y lo inserta entre otros dos. \param[in] x Coordenada X del vértice. \param[in] y Coordenada Y del vértice. \param[in] anterior Vértice anterior (puede ser \p NULL). \param[in] siguiente Vértice siguiente (puede ser \p NULL). \param[in] orig Campo _vertPolilClip::orig. \param[in] pos Campo _vertPolilClip::pos. \param[in] alfa Campo _vertPolilClip::alfa. \return Puntero al nuevo vértice creado. Si se devuelve \p NULL, ha ocurrido un error de asignación de memoria. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPolilClip* CreaVertPolilClip(const double x, const double y, vertPolilClip* anterior, vertPolilClip* siguiente, const char orig, const char pos, const double alfa); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una polilínea, como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] x Vector de coordenadas X de los nodos de la polilínea. \param[in] y Vector de coordenadas Y de los nodos de la polilínea. \param[in] nCoor Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \return Puntero al primer vértice de la lista. Si se devuelve \p NULL, ha ocurrido un error de asignación de memoria. \note Esta función asume que el argumento \em nCoor es mayor que 0. \note Si en los vectores de coordenadas \em x e \em y hay valores #GEOC_NAN, éstos no se tienen en cuenta a la hora de la creación de la estructura de salida. \note Que los vectores de coordenadas \em x e \em y admitan vértices con coordenadas (#GEOC_NAN,#GEOC_NAN) no quiere decir que éstos sean separadores de múltiples polilíneas. \em x e \em y \b *SÓLO* deben almacenar una única polilínea. \note Esta función asigna el valor 0 a todos los campos _vertPolilClip::pos de los elementos creados. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPolilClip* CreaPolilClip(const double* x, const double* y, const size_t nCoor, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Libera la memoria asignada a una polilínea almacenada como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] poli Puntero al primer elemento de la polilínea. \note Esta función no comprueba si hay vértices de la polilínea anteriores al vértice de entrada, por lo que si se quiere liberar toda la memoria asignada a una polilínea, el vértice pasado ha de ser el primero de la lista. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void LibMemPolilClip(vertPolilClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Elimina los vértices no originales de una polilínea almacenada como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] poli Puntero al primer elemento de la polilínea. \return Puntero al primer elemento de la polilínea original. Si se devuelve \p NULL, ninguno de los vértices pertenecía a la polilínea original. \note Los vértices eliminados por esta función son todos aquéllos cuyo campo _vertPolilClip::orig sea igual a 0. \note Aunque se supone que el primer vértice de una polilínea siempre es un vértice original, si no lo es, la variable de entrada queda modificada. Por tanto, siempre es recomendable capturar la variable de salida, que garantiza la posición del primer elemento. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPolilClip* ReiniciaPolilClip(vertPolilClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el siguiente vértice original en una polilínea. \param[in] vert Puntero al vértice a partir del cual se ha de buscar. \return Puntero al siguiente vértice original en la polilínea. Si se devuelve \p NULL, se ha llegado al final. \note Los vértices no originales son todos aquéllos cuyo campo _vertPolilClip::orig es distinto de 0. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPolilClip* SiguienteVertOrigPolilClip(vertPolilClip* vert); /******************************************************************************/ /******************************************************************************/ /** \brief Inserta un vértice de tipo \ref _vertPolilClip entre otros dos, atendiendo al campo _vertPolilClip::alfa. \param[in] ins Vértice a insertar. \param[in] extremoIni Extremo inicial del segmento donde se insertará \em ins. \param[in] extremoFin Extremo final del segmento donde se insertará \em ins. \note Esta función asume que todos los elementos pasados tienen memoria asignada. \note Si entre \em extremoIni y \em extremoFin hay más vértices, \em ins se insertará de tal modo que los campos _vertPolilClip::alfa queden ordenados de menor a mayor. \note Si el campo _vertPolilClip::alfa de \em ins tiene el mismo valor que el de \em extremoIni, \em ins se insertará justo a continuación de \em extremoIni. \note Si el campo _vertPolilClip::alfa de \em ins tiene el mismo valor que el de \em extremoFin, \em ins se insertará justo antes de \em extremoIni. \date 04 de junio de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void InsertaVertPolilClip(vertPolilClip* ins, vertPolilClip* extremoIni, vertPolilClip* extremoFin); /******************************************************************************/ /******************************************************************************/ /** \brief Cuenta el número de vértices originales que hay en una polilínea almacenada como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] poli Polilínea, almacenado como una lista doblemente enlazada de elementos \ref _vertPolilClip. Sólo se tienen en cuenta los vértices originales de la polilínea, que son todos aquéllos cuyo campo _vertPolilClip::orig es distinto de 0. \return Número de vértices originales almacenados. \note Esta función no comprueba si la variable \em poli es una polilínea correctamente almacenada. \date 04 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ size_t NumeroVertOrigPolilClip(vertPolilClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Cuenta el número total de vértices que hay en una polilínea almacenada como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] poli Polilínea, almacenado como una lista doblemente enlazada de elementos \ref _vertPolilClip. Se tienen en cuenta todos los vértices. \return Número total de vértices almacenados. \note Esta función no comprueba si la variable \em poli es una polilínea correctamente almacenada. \date 04 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ size_t NumeroVertPolilClip(vertPolilClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza el paso número 1 del algoritmo de recorte de polilíneas, que consiste en el cálculo de los puntos de intersección de la polilínea de trabajo con el polígono de recorte. Este paso está inspirado en el primer paso del algoritmo de Greiner-Hormann. \param[in,out] poli Polilínea de trabajo, representada como una lista doblemente enlazada de elementos \ref _vertPolilClip. Al término de la ejecución de la función se le han añadido los puntos de intersección con el polígono de recorte y se han asignado los valores correctos al campo _vertPolilClip::pos de cada vértice. \param[in] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[out] nIntersec Número de intersecciones (intersecciones propiamente dichas y puntos en el borde del polígono) calculadas. \return Variable de estado. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si las variables \em polil y \em poliRec son estructuras correctamente almacenadas. \note El polígono \em poliRec puede provenir de una operación booleana previa entre polígonos, ya que sólo se recorrerán sus vértices originales, que serán aquéllos cuyo campo _vertPoliClip::interseccion valga 0. \date 06 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ int Paso1Recpolil(vertPolilClip* poli, vertPoliClip* poliRec, size_t* nIntersec); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza el paso número 2 del algoritmo de recorte de polilíneas, que consiste en la generación de lss polilíneas resultado. \param[in] poli Polilínea a recortar, representada como una lista doblemente enlazada de elementos \ref _vertPolilClip, tal y como sale de la función \ref Paso1Recpolil. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIL. \return Estructura \ref polil con las polilíneas resultado de la operación. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si la variable \em polil es una polilínea correctamente almacenada. \date 06 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ polil* Paso2Recpolil(vertPolilClip* poli, const enum GEOC_OP_BOOL_POLIL op); /******************************************************************************/ /******************************************************************************/ /** \brief Recorta una polilínea según un polígono de recorte. \param[in,out] poli Polilínea de trabajo, representada como una lista doblemente enlazada de elementos \ref _vertPolilClip. Al término de la ejecución de la función se le han añadido los puntos de intersección con el polígono de recorte y se han asignado los valores correctos al campo _vertPolilClip::pos de cada vértice. \param[in] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIL. Varias posibilidades: - #GeocOpBoolDentro: Calcula la porción de \em poli que está dentro \em poliRec. - #GeocOpBoolFuera: Calcula la porción de \em poli que está fuera \em poliRec. \param[out] nIntersec Número de intersecciones calculadas. \return Estructura \ref polil con las polilíneas resultado de la operación. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si las variables \em poli y \em poliRec son estructuras correctamente almacenadas. \note Esta función no comprueba internamente si \em op pertenece al tipo enumerado #GEOC_OP_BOOL_POLIL. Si se introduce un valor no perteneciente al tipo, se realiza la operación #GeocOpBoolDentro. \note Esta función asume que los puntos de borde pertenecen al interior del polígono de recorte. \note Esta función asume que los puntos de borde sólo pertenecen al exterior del polígono de recorte cuando son principio o final de polilínea recortada. \date 06 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ polil* RecortaPolil(vertPolilClip* poli, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIL op, size_t* nIntersec); /******************************************************************************/ /******************************************************************************/ /** \brief Recorta múltiples polilíneas según múltiples polígonos de recorte. \param[in] poli Estructura \ref polil que almacena las polilíneas de trabajo. \param[in] poliRec Estructura \ref polig que almacena los polígonos de recorte. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIL. Varias posibilidades: - #GeocOpBoolDentro: Calcula la porción de las polilíneas almacenadas en \em poli que están dentro de los polígonos almacenados en \em poliRec. - #GeocOpBoolFuera: Calcula la porción de las polilíneas almacenadas en \em poli que están fuera de los polígonos almacenados en \em poliRec. \param[out] nIntersec Número total de intersecciones calculadas entre todas las polilíneas con todos los polígonos. \return Estructura \ref polil con las polilíneas resultado de las operaciones. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función realiza la operación \em op con todas las combinaciones posibles de polilíneas y polígonos. Es decir, se recorren todas las polilíneas y con cada una de ellas se realiza la operación \em op con cada polígono almacenado en \em poliRec. \note Esta función no comprueba si las variables \em poli y \em poliRec son estructuras correctamente almacenadas. \note Esta función no comprueba internamente si \em op pertenece al tipo enumerado #GEOC_OP_BOOL_POLIL. Si se introduce un valor no perteneciente al tipo, se realiza la operación #GeocOpBoolDentro. \note Esta función asume que los puntos de borde pertenecen al interior de los polígonos de recorte. \note Esta función asume que los puntos de borde sólo pertenecen al exterior de los polígonos de recorte cuando son principio o final de polilínea recortada. \date 06 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ polil* RecortaPolilMult(const polil* poli, const polig* poliRec, const enum GEOC_OP_BOOL_POLIL op, size_t* nIntersec); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polil a partir de todos los vértices de una polilínea almacenada como una lista doblemente enlazada de elementos \ref _vertPolilClip. \param[in] poli Polilínea de trabajo, representada como una lista doblemente enlazada de elementos \ref _vertPolilClip. El puntero pasado ha de apuntar al primer elemento de la polilínea (no se controla internamente). \return Estructura \ref polil que representa la polilínea. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si la variable \em poli es una polilínea correctamente almacenada. \note Esta función realiza una copia en memoria de las coordenadas de los vértices de la estructura \em poli a la estructura de salida. \date 06 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ polil* CreaPolilPolilClip(vertPolilClip* poli); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/ventorno.h000755 001750 001750 00000011746 12540021550 017405 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup anespec general @{ \file ventorno.h \brief Definición de variables de entorno y declaración de funciones para su control. \author José Luis García Pallero, jgpallero@gmail.com \date 31 de marzo de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _VENTORNO_H_ #define _VENTORNO_H_ /******************************************************************************/ /******************************************************************************/ #include #include /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ENV_NOM_VAR_PILOMBS \brief Nombre de la variable de entorno para imprimir o no pasos intermedios en la ejecución de la función \ref AnalisisLombSig. \date 31 de marzo de 2011: Creación de la constante. */ #define GEOC_ENV_NOM_VAR_PILOMBS "GEOC_ENV_PILOMBS" /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ENV_VAL_REF_PILOMBS \brief Valor de referencia de la variable de entorno #GEOC_ENV_NOM_VAR_PILOMBS. \date 31 de marzo de 2011: Creación de la constante. */ #define GEOC_ENV_VAL_REF_PILOMBS "0" /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si una variable de entorno está definida y es igual a un valor. \param[in] var Nombre de la variable de entorno a comprobar. \param[in] valRef Valor de referencia de la variable de entorno. \return Tres posibilidades: - Menor que 0: La variable de entorno no está definida. - 0: La variable de entorno existe, pero tiene un valor distinto a \em valRef. - Mayor que 0: La variable de entorno existe y tiene el mismo valor que \em valRef. \date 31 de marzo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ int VarEnvValRef(const char* var, const char* valRef); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/greiner.h000755 001750 001750 00000130124 12540021550 017156 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file greiner.h \brief Definición de estructuras y declaración de funciones para el recorte de polígonos mediante el algoritmo de Greiner-Hormann (http://davis.wpi.edu/~matt/courses/clipping/). \author José Luis García Pallero, jgpallero@gmail.com \date 14 de mayo de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _GREINER_H_ #define _GREINER_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include #include #include"libgeoc/errores.h" #include"libgeoc/eucli.h" #include"libgeoc/geocnan.h" #include"libgeoc/polig.h" #include"libgeoc/ptopol.h" #include"libgeoc/segmento.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_GREINER_FAC_EPS_PERTURB \brief Factor de escala para el cálculo de la cantidad mínima de perturbación para un valor. Esta variable se usa en la función \ref CantPerturbMin. A base de hacer pruebas he visto que es desaconsejable un valor por debajo de 10.0. \date 22 de mayo de 2011: Creación de la constante. */ #define GEOC_GREINER_FAC_EPS_PERTURB 10.0 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_GREINER_BUFFER_PTOS \brief Número de puntos para ir asignando memoria en bloques para los polígonos de salida en la funcion \ref Paso3Greiner. Ha de ser un número mayor o igual a 2. \date 23 de mayo de 2011: Creación de la constante. */ #define GEOC_GREINER_BUFFER_PTOS 100 /******************************************************************************/ /******************************************************************************/ /** \enum GEOC_OP_BOOL_POLIG \brief Operación booleana entre polígonos. \date 21 de mayo de 2011: Creación del tipo. */ enum GEOC_OP_BOOL_POLIG { /** \brief Intersección entre polígonos. */ GeocOpBoolInter=111, /** \brief Unión de polígonos. */ GeocOpBoolUnion=112, /** \brief Unión exclusiva de polígonos. */ GeocOpBoolXor=113, /** \brief Operación A-B. */ GeocOpBoolAB=114, /** \brief Operación B-A. */ GeocOpBoolBA=115 }; /******************************************************************************/ /******************************************************************************/ /** \struct _vertPoliClip \brief Estructura de definición de un vértice de un polígono usado en operaciones de recorte. El polígono se almacena en memoria como una lista doblemente enlazada de vértices. \date 14 de mayo de 2011: Creación de la estructura. */ typedef struct _vertPoliClip { /** \brief Coordenada X del vértice. */ double x; /** \brief Coordenada Y del vértice. */ double y; /** \brief Coordenada X perturbada del vértice. */ double xP; /** \brief Coordenada Y perturbada del vértice. */ double yP; /** \brief Vértice anterior. */ struct _vertPoliClip* anterior; /** \brief Vértice siguiente. */ struct _vertPoliClip* siguiente; /** \brief Enlace al mismo nodo, perteneciente a otro polígono. Los puntos de intersección pertenecen tanto al polígono de recorte como al recortado. */ struct _vertPoliClip* vecino; /** \brief Indicador de primer punto de polígono. Dos posibilidades: - 0: No es el primer punto del polígono. - Distinto de 0: Sí es el primer punto del polígono. */ char ini; /** \brief Indicador de punto de intersección. Dos posibilidades: - 0: No es un punto de intersección. - Distinto de 0: Sí es un punto de intersección. */ char interseccion; /** \brief Indicador de punto de entrada al interior del otro polígono. Dos posibilidades: - 0: No es un punto de entrada, es de salida. - Distinto de 0: Sí es un punto de entrada. */ char entrada; /** \brief Indicador de punto visitado. Dos posibilidades: - 0: No ha sido visitado. - Distinto de 0: Sí ha sido visitado. */ char visitado; /** \brief Distancia, en tanto por uno, de un nodo de intersección con respecto al primer vértice del segmento que lo contiene. */ double alfa; }vertPoliClip; /******************************************************************************/ /******************************************************************************/ /** \brief Crea un vértice de tipo \ref _vertPoliClip y lo inserta entre otros dos. \param[in] x Coordenada X del vértice. \param[in] y Coordenada Y del vértice. \param[in] anterior Vértice anterior (puede ser \p NULL). \param[in] siguiente Vértice siguiente (puede ser \p NULL). \param[in] vecino Campo _vertPoliClip::vecino (puede ser \p NULL). \param[in] ini Campo _vertPoliClip::ini. \param[in] interseccion Campo _vertPoliClip::interseccion. \param[in] entrada Campo _vertPoliClip::entrada. \param[in] visitado Campo _vertPoliClip::visitado. \param[in] alfa Campo _vertPoliClip::alfa. \return Puntero al nuevo vértice creado. Si se devuelve \p NULL, ha ocurrido un error de asignación de memoria. \date 18 de mayo de 2011: Creación de la función. \date 21 de mayo de 2011: Eliminación del algumento \em siguientePoli y adición del argumento \em ini. \todo Esta función todavía no está probada. */ vertPoliClip* CreaVertPoliClip(const double x, const double y, vertPoliClip* anterior, vertPoliClip* siguiente, vertPoliClip* vecino, const char ini, const char interseccion, const char entrada, const char visitado, const double alfa); /******************************************************************************/ /******************************************************************************/ /** \brief Crea un polígono, como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] x Vector de coordenadas X de los nodos del polígono. \param[in] y Vector de coordenadas Y de los nodos del polígono. \param[in] nCoor Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \return Puntero al primer vértice de la lista. Si se devuelve \p NULL, ha ocurrido un error de asignación de memoria. \note Esta función asume que el argumento \em nCoor es mayor que 0. \note En la lista de salida que representa al polígono, el primer vértice siempre se repite al final. Si en los vectores \em x e \em y el último elemento no es igual que el primero, igualmente se crea en la lista de salida. \note Si en los vectores de coordenadas \em x e \em y hay valores #GEOC_NAN, éstos no se tienen en cuenta a la hora de la creación de la estructura de salida. \note Que los vectores de coordenadas \em x e \em y admitan vértices con coordenadas (#GEOC_NAN,#GEOC_NAN) no quiere decir que éstos sean separadores de múltiples polígonos. \em x e \em y \b *SÓLO* deben almacenar un único polígono. \date 18 de mayo de 2011: Creación de la función. \date 24 de mayo de 2011: Adición del soporte de coordenadas (#GEOC_NAN,#GEOC_NAN) en los vectores de entrada. \todo Esta función todavía no está probada. */ vertPoliClip* CreaPoliClip(const double* x, const double* y, const size_t nCoor, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Libera la memoria asignada a un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] poli Puntero al primer elemento del polígono. \note Esta función no comprueba si hay vértices del polígono anteriores al vértice de entrada, por lo que si se quiere liberar toda la memoria asignada a un polígono, el vértice pasado ha de ser el primero de la lista. \note Esta función \b *NO* trabaja con listas circulares. \date 18 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void LibMemPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Elimina los vértices no originales de un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] poli Puntero al primer elemento del polígono. \return Puntero al primer elemento del polígono original. Si se devuelve \p NULL, ninguno de los vértices pertenecía al polígono original. \note Esta función asume que el primero y el último vértices originales del polígono pasado tienen las mismas coordenadas. \note Los vértices eliminados por esta función son todos aquéllos cuyo campo _vertPoliClip::interseccion sea distinto de 0. \note Aunque se supone que el primer vértice de un polígono siempre es un vértice original, si no lo es, la variable de entrada queda modificada. Por tanto, siempre es recomendable capturar la variable de salida, que garantiza la posición del primer elemento. \note Las coordenadas de todos los vértices originales vuelven a ser la de inicio, es decir, los campos _vertPoliClip::xP e _vertPoliClip::yP se sobreescriben con los valores almacenados en _vertPoliClip::x e _vertPoliClip::y. \note Esta función \b *NO* trabaja con listas circulares. \date 18 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* ReiniciaPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Reinicia los vértices de un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip para poder volver a calcular otra operación booleana sin tener que recalcular las intersecciones. Esta función devuelve todos los campos _vertPoliClip::visitado a 0 y los campos _vertPoliClip::entrada a 0. \param[in] poli Puntero al primer elemento del polígono. \return Puntero al primer elemento del polígono original. Si se devuelve \p NULL, quiere decir qie el argumento de entrada valía \p NULL. \note Esta función \b *NO* trabaja con listas circulares. \date 30 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* ReiniciaVerticesPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el siguiente vértice original en un polígono. \param[in] vert Puntero al vértice a partir del cual se ha de buscar. \return Puntero al siguiente vértice original en el polígono. Si se devuelve \p NULL, se ha llegado al final. \note Esta función asume que el primero y el último vértices originales del polígono pasado tienen las mismas coordenadas. \note Los vértices no originales son todos aquéllos cuyo campo _vertPoliClip::interseccion es distinto de 0. \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* SiguienteVertOrigPoliClip(vertPoliClip* vert); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el siguiente vértice que sea una intersección no visitada en un polígono. \param[in] vert Puntero al vértice a partir del cual se ha de buscar. \return Puntero al siguiente vértice que sea una intersección no visitada en el polígono. Si se devuelve \p NULL, se ha llegado al final. \note Esta función asume que el primero y el último vértices originales del polígono pasado tienen las mismas coordenadas. \note Los vértices intersección no visitados son todos aquéllos cuyo campo _vertPoliClip::visitado es 0. \note Esta función asume que el vértice inicial del polígono, aquél cuyo campo _vertPoliClip::ini vale 1, es un vértice original. \note Esta función puede trabajar con listas circulares y no circulares. \date 21 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* SiguienteIntersecNoVisitadaPoliClip(vertPoliClip* vert); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el último vértice de un polígono almacenado como una lista doblemente enlazada de vértives \ref _vertPoliClip. \param[in] poli Puntero al primer elemento del polígono. \return Puntero al último vértice del polígono, que es aquél cuyo campo _vertPoliClip::siguiente apunta a \p NULL. Si se devuelve \p NULL, significa que el argumento pasado en \em poli vale \p NULL. \note Esta función \b *NO* trabaja con listas circulares. \date 21 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* UltimoVertPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Inserta un vértice de tipo \ref _vertPoliClip entre otros dos, atendiendo al campo _vertPoliClip::alfa. \param[in] ins Vértice a insertar. \param[in] extremoIni Extremo inicial del segmento donde se insertará \em ins. \param[in] extremoFin Extremo final del segmento donde se insertará \em ins. \note Esta función asume que todos los elementos pasados tienen memoria asignada. \note Si entre \em extremoIni y \em extremoFin hay más vértices, \em ins se insertará de tal modo que los campos _vertPoliClip::alfa queden ordenados de menor a mayor. \note Si el campo _vertPoliClip::alfa de \em ins tiene el mismo valor que el de \em extremoIni, \em ins se insertará justo a continuación de \em extremoIni. \note Si el campo _vertPoliClip::alfa de \em ins tiene el mismo valor que el de \em extremoFin, \em ins se insertará justo antes de \em extremoIni. \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void InsertaVertPoliClip(vertPoliClip* ins, vertPoliClip* extremoIni, vertPoliClip* extremoFin); /******************************************************************************/ /******************************************************************************/ /** \brief Convierte una lista doblemente enlazada de elementos \ref _vertPoliClip en una lista doblemente enlazada circular. \param[in,out] poli Vértice inicial del polígono, almacenado como lista doblemente enlazada, pero no cerrada. Al término de la ejecución de la función la lista se ha cerrado, por medio de un enlace del penúltimo elemento (el último es el primero repetido) con el primero. \return Puntero al último elemento del polígono original que, al ser el primer elemento repetido, queda almacenado en memoria pero no neferenciado por el polígono. Si el valor devuelto es \p NULL quiere decir que el argumento de entrada era \p NULL. \note Esta función \b *NO* trabaja con listas circulares. \date 21 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ vertPoliClip* CierraPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Convierte una lista doblemente enlazada circular de elementos \ref _vertPoliClip en una lista doblemente enlazada simple. \param[in,out] poli Vértice inicial del polígono, almacenado como lista doblemente enlazada circular. Al término de la ejecución de la función la lista ha recuperado su condición de doblemente enlazada sin cerrar. \param[in] ultimo Puntero al último elemento de la lista doblemente enlazada original. Este argumento ha de ser el valor devuelto por la función \ref CierraPoliClip. \note Esta función asume que los elementos pasados tienen memoria asignada. \note Esta función sólo trabaja con listas circulares. \date 21 de mayo de 2011: Creación de la función. \todo Esta función todavía no está probada. */ void AbrePoliClip(vertPoliClip* poli, vertPoliClip* ultimo); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en un polígono de un número arbitrario de lados. Esta función puede no dar resultados correctos para puntos en los bordes y/o los vértices del polígono. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] poli Polígono, almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Sólo se tienen en cuenta los vértices originales del polígono, que son todos aquéllos cuyo campo _vertPoliClip::interseccion es distinto de 0. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera del polígono. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro del polígono. \note El código de esta función ha sido adaptado de la función \ref PtoEnPoligono. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función no detecta el caso de que el punto de trabajo esté en el borde o en un vértice del polígono. En este caso, el test puede dar el punto dentro o fuera, indistintamente (el chequeo del mismo punto con el mismo polígono siempre dará el mismo resultado). \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoliClip(const double x, const double y, vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en un polígono de un número arbitrario de lados. Esta función puede no dar resultados correctos para puntos en los bordes del polígono. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] poli Polígono, almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Sólo se tienen en cuenta los vértices originales del polígono, que son todos aquéllos cuyo campo _vertPoliClip::interseccion es distinto de 0. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera del polígono. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro del polígono. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice del polígono. \note El código de esta función ha sido adaptado de la función \ref PtoEnPoligonoVertice. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función utiliza en uno de sus pasos la función \ref PtoEnPoliClip y se comporta igual que ella en el caso de puntos en el borde. \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoliClipVertice(const double x, const double y, vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Cuenta el número de vértices originales que hay en un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] poli Polígono, almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Sólo se tienen en cuenta los vértices originales del polígono, que son todos aquéllos cuyo campo _vertPoliClip::interseccion es distinto de 0. \return Número de vértices originales almacenados. El último vértice, que es igual al primero, también se cuenta. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ size_t NumeroVertOrigPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Cuenta el número total de vértices que hay en un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] poli Polígono, almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Se tienen en cuenta todos los vértices. \return Número total de vértices almacenados. El último vértice, que debe ser igual al primero, también se cuenta. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función \b *NO* trabaja con listas circulares. \date 19 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ size_t NumeroVertPoliClip(vertPoliClip* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la cantidad mínima a añadir a un número para que el valor de la suma sea distinto del número original. \param[in] x Número a perturbar. \param[in] factor Factor para ir multiplicando el valor a añadir a \em x mientras no sea suficiente para producir una perturbación detectable. Un buen valor para este argumento es #GEOC_GREINER_FAC_EPS_PERTURB. \return Cantidad mínima a añadir a \em x para que el valor de la suma sea distinto de \em x. \note Esta función no comprueba internamente si \em factor es menor o igual que 1, lo que daría lugar a que la función entrase en un bucle infinito. \note Como valor inicial de la cantidad a añadir se toma el producto de \em factor por la constante \p DBL_EPSILON, perteneciente al fichero \p float.h de C estándar. \date 22 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ double CantPerturbMin(const double x, const double factor); /******************************************************************************/ /******************************************************************************/ /** \brief Modifica un número la cantidad mínima para que sea distinto del número original. \param[in] x Número a perturbar. \param[in] factor Factor para el cálculo de la cantidad perturbadora mínima. Ver la documentación de la función \ref CantPerturbMin para obtener más detalles. Un buen valor para este argumento es #GEOC_GREINER_FAC_EPS_PERTURB. \return Número perturbado. \note La perturbación de \em x se realiza de la siguiente manera: - Se calcula la cantidad mínima perturbadora \p perturb con la función \ref CantPerturbMin. - Se calcula un número seudoaleatorio con la función de C estándar rand() (el generador de números seudoaleatorios se inicializa con la orden srand((unsigned int)time(NULL));). - Se comprueba la paridad del número seudoaleatorio generado para obtener la variable \p signo, de tal forma que: - Si el número seudoaleatorio es par: \p signo vale 1.0. - Si el número seudoaleatorio es impar: \p signo vale -1.0. - Se perturba \em x como xPerturb=x+signo*perturb. \date 22 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ double PerturbaPuntoMin(const double x, const double factor); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza el paso número 1 del algoritmo de Greiner-Hormann, que consiste en el cálculo de los puntos de intersección entre los dos polígonos de trabajo. \param[in,out] poliBas Polígono base, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función se le han añadido los puntos de intersección. \param[in,out] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función se le han añadido los puntos de intersección. \param[in] facPer Factor para el posible cálculo de la perturbación de las coordenadas de algunos vértices. Este valor es usado internamente por la función \ref PerturbaPuntoMin (ver su documentación). Un buen valor para este argumento es #GEOC_GREINER_FAC_EPS_PERTURB. \param[out] nIntersec Número de intersecciones calculadas. \param[out] nPerturb Número de puntos perturbados en el proceso. \return Variable de estado. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si las variables \em poliBas y \em poliRec son polígonos correctamente almacenados. \note En el caso de tener que perturbar algún vértice, sólo se modifican los de \em poliRec, dejando las coordenadas del polígono base inalteradas. \date 22 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int Paso1Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const double facPer, size_t* nIntersec, size_t* nPerturb); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza el paso número 2 del algoritmo de Greiner-Hormann, que consiste en la asignación de los puntos de intersección como entrada o salida. \param[in,out] poliBas Polígono base, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función los puntos de intersección han sido marcados como entrada o salida. \param[in,out] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función los puntos de intersección han sido marcados como entrada o salida. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIG, excepto la unión exclusiva \p xor. En el caso de indicar la operación de unión exclusiva \p xor, se realiza una intersección y \b *NO* se avisa del argumento incorrecto. \note Esta función no comprueba si las variables \em poliBas y \em poliRec son polígonos correctamente almacenados. \date 22 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ void Paso2Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIG op); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza el paso número 3 del algoritmo de Greiner-Hormann, que consiste en la generación de los polígonos resultado. \param[in,out] poliBas Polígono base, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip, tal y como sale de la función \ref Paso2Greiner. Al término de la ejecución de la función los puntos visitados han sido marcados en el campo _vertPoliClip::visitado. \param[in,out] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip, tal y como sale de la función \ref Paso2Greiner. Al término de la ejecución de la función los puntos visitados han sido marcados en el campo _vertPoliClip::visitado. \return Estructura \ref polig con los polígonos resultado de la operación. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si las variables \em poliBas y \em poliRec son polígonos correctamente almacenados. \date 22 de mayo de 2011: Creación de la función. \date 29 de mayo de 2011: Cambio de la variable de salida por la estructura \ref polig. \todo Esta función no está probada. */ polig* Paso3Greiner(vertPoliClip* poliBas, vertPoliClip* poliRec); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza una operación booleana entre dos polígonos mediante el algoritmo de Greiner-Hormann. \param[in,out] poliBas Polígono base, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función se han añadido los puntos de intersección con \em poliRec. \param[in,out] poliRec Polígono de recorte, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. Al término de la ejecución de la función se han añadido los puntos de intersección con \em poliRec. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIG. Varias posibilidades: - #GeocOpBoolInter: Realiza la intersección entre \em poliBas y \em poliRec. - #GeocOpBoolUnion: Realiza la unión entre \em poliBas y \em poliRec. - #GeocOpBoolXor: Realiza la unión exclusiva entre \em poliBas y \em poliRec. - #GeocOpBoolAB: Realiza la sustracción \em poliBas-poliRec. - #GeocOpBoolBA: Realiza la sustracción \em poliRec-poliBas. \param[in] facPer Factor para el posible cálculo de la perturbación de las coordenadas de algunos vértices. Este valor es usado internamente por la función \ref Paso1Greiner (ver su documentación). Un buen valor para este argumento es #GEOC_GREINER_FAC_EPS_PERTURB. \param[out] nIntersec Número de intersecciones calculadas. \param[out] nPerturb Número de puntos perturbados en el proceso. \return Estructura \ref polig con los polígonos resultado de la operación. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si las variables \em poliBas y \em poliRec son polígonos correctamente almacenados. \note Esta función no comprueba internamente si \em op pertenece al tipo enumerado #GEOC_OP_BOOL_POLIG. Si se introduce un valor no perteneciente al tipo, se realiza la operación #GeocOpBoolInter. \note En el caso de tener que perturbar algún vértice, sólo se modifican los de \em poliRec, dejando las coordenadas de \em poliBase inalteradas. \note Si \em facPer es menor o igual que 1, se sustituye internamente su valor por #GEOC_GREINER_FAC_EPS_PERTURB (ver documentación de la función \ref CantPerturbMin). \note Esta función realiza la unión exclusiva #GeocOpBoolXor mediante la unión de las operaciones individuales #GeocOpBoolAB y #GeocOpBoolBA. Esta última unión simplemente es el almacenamiento en la estructura de salida de los resultados de #GeocOpBoolAB y #GeocOpBoolBA. En ningún momento se realiza la operación booleana #GeocOpBoolUnion entre los resultados de #GeocOpBoolAB y #GeocOpBoolBA. \date 22 de mayo de 2011: Creación de la función. \date 29 de mayo de 2011: Cambio de la variable de salida por la estructura \ref polig. \date 30 de mayo de 2011: Adición de la capacidad de calcular la operación unión exclusiva \p xor. \todo Esta función no está probada. */ polig* PoliBoolGreiner(vertPoliClip* poliBas, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIG op, const double facPer, size_t* nIntersec, size_t* nPerturb); /******************************************************************************/ /******************************************************************************/ /** \brief Realiza una operación booleana entre múltiples polígonos mediante el algoritmo de Greiner-Hormann. \param[in] poliBas Estructura \ref polig que almacena los polígonos base. \param[in] poliRec Estructura \ref polig que almacena los polígonos de recorte. \param[in] op Identificador de la operación a realizar. Ha de ser un elemento del tipo enumerado #GEOC_OP_BOOL_POLIG. Varias posibilidades: - #GeocOpBoolInter: Realiza la intersección entre los polígonos almacenados en \em poliBas y los almacenados en \em poliRec. - #GeocOpBoolUnion: Realiza la unión entre los polígonos almacenados en \em poliBas y los almacenados en \em poliRec. - #GeocOpBoolXor: Realiza la unión exclusiva entre los polígonoa almacenados en \em poliBas y los almacenados en \em poliRec. - #GeocOpBoolAB: Realiza la sustracción entre todos los polígonos \em poliBas-poliRec. - #GeocOpBoolBA: Realiza la sustracción entre todos los polígonos \em poliRec-poliBas. \param[in] facPer Factor para el posible cálculo de la perturbación de las coordenadas de algunos vértices. Este valor es usado internamente por la función \ref Paso1Greiner (ver su documentación). Un buen valor para este argumento es #GEOC_GREINER_FAC_EPS_PERTURB. \param[out] nIntersec Número total de intersecciones calculadas entre todas los polígonos. \param[out] nPerturb Número total de puntos perturbados en el proceso. \return Estructura \ref polig con los polígonos resultado de las operaciones. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función realiza la operación \em op con todas las combinaciones posibles de polígonos. Es decir, se recorren todos los polígonos almacenados en \em poliBas y con cada uno de ellos se realiza la operación \em op con cada polígono almacenado en \em poliRec. \note Esta función no comprueba si las variables \em poliBas y \em poliRec son polígonos correctamente almacenados. \note Esta función no comprueba internamente si \em op pertenece al tipo enumerado #GEOC_OP_BOOL_POLIG. Si se introduce un valor no perteneciente al tipo, se realiza la operación #GeocOpBoolInter. \note En el caso de tener que perturbar algún vértice, sólo se modifican los correspondientes a \em poliRec, dejando las coordenadas de los polígonos de \em poliBase inalteradas. \note Si \em facPer es menor o igual que 1, se sustituye internamente su valor por #GEOC_GREINER_FAC_EPS_PERTURB (ver documentación de la función \ref CantPerturbMin). \note Esta función realiza la unión exclusiva #GeocOpBoolXor mediante la unión de las operaciones individuales #GeocOpBoolAB y #GeocOpBoolBA. Esta última unión simplemente es el almacenamiento en la estructura de salida de los resultados de #GeocOpBoolAB y #GeocOpBoolBA. En ningún momento se realiza la operación booleana #GeocOpBoolUnion entre los resultados de #GeocOpBoolAB y #GeocOpBoolBA. \date 07 de junio de 2011: Creación de la función. \todo Esta función no está probada. */ polig* PoliBoolGreinerMult(const polig* poliBas, const polig* poliRec, const enum GEOC_OP_BOOL_POLIG op, const double facPer, size_t* nIntersec, size_t* nPerturb); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polig a partir de todos los vértices de un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip. \param[in] poli Polígono de trabajo, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. El puntero pasado ha de apuntar al primer elemento del polígono (no se controla internamente). \param[in] coorOrig Identificador para copiar las coordenadas originales o perturbadas. Dos posibilidades: - 0: Se copiarán las coordenadas perturbadas _vertPoliClip::xP e _vertPoliClip::yP. - Distinto de 0: Se copiarán las coordenadas originales _vertPoliClip::x e _vertPoliClip::y. \return Estructura \ref polig que representa el polígono. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función \b *NO* trabaja con listas circulares. \note Esta función realiza una copia en memoria de las coordenadas de los vértices de la estructura \em poli a la estructura de salida. \date 29 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ polig* CreaPoligPoliClip(vertPoliClip* poli, const int coorOrig); /******************************************************************************/ /******************************************************************************/ /** \brief Añade los vértices de un polígono almacenado como una lista doblemente enlazada de elementos \ref _vertPoliClip a una estructura \ref polig previamente creada. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se han añadido los polígonos de la estructura \em anyade. \param[in] anyade Polígono a añadir, representado como una lista doblemente enlazada de elementos \ref _vertPoliClip. El puntero pasado ha de apuntar al primer elemento del polígono (no se controla internamente). \param[in] coorOrig Identificador para copiar las coordenadas originales o perturbadas. Dos posibilidades: - 0: Se copiarán las coordenadas perturbadas _vertPoliClip::xP e _vertPoliClip::yP. - Distinto de 0: Se copiarán las coordenadas originales _vertPoliClip::x e _vertPoliClip::y. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función no comprueba si la variable \em poli es un polígono correctamente almacenado. \note Esta función no comprueba si la variable \em anyade es un polígono correctamente almacenado. \note Esta función \b *NO* trabaja con listas circulares. \note Esta función realiza una copia en memoria de las coordenadas de los vértices de la estructura \em poli a la estructura de salida. \note Esta función crea internamente una estructura \ref polig para luego añadirla a \em poli con la función \ref AnyadePoligPolig. \date 29 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int AnyadePoligClipPolig(polig* poli, vertPoliClip* anyade, const int coorOrig); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/fgeneral.h000755 001750 001750 00000103305 12540021550 017307 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup eop general geom geopot matriz @{ \file fgeneral.h \brief Declaración de macros y funciones de utilidad general. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 25 de septiembre de 2009 \version 1.0 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _FGENERAL_H_ #define _FGENERAL_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include #include #include"libgeoc/constantes.h" #include"libgeoc/errores.h" #include"libgeoc/geocomp.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SIGNO \brief Macro para determinar el signo de un escalar. \param[in] a Un número. \return Signo del dato de entrada. Dos posibilidades: - -1.0: El dato pasado es negativo. - 1.0: El dato pasado es positivo o 0.0. \date 10 de junio de 2011: Creación de la macro. */ #define GEOC_SIGNO(a) ((a)>=0.0 ? 1.0 : -1.0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_MAX \brief Macro para seleccionar el valor máximo entre dos escalares. \param[in] a Un número. \param[in] b Otro número. \return El mayor de los dos argumentos de entrada. \date 25 de septiembre de 2009: Creación de la macro. */ #define GEOC_MAX(a,b) ((a)>(b) ? (a) : (b)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_MIN \brief Macro para seleccionar el valor mínimo entre dos escalares. \param[in] a Un número. \param[in] b Otro número. \return El menor de los dos argumentos de entrada. \date 25 de septiembre de 2009: Creación de la macro. */ #define GEOC_MIN(a,b) ((a)<(b) ? (a) : (b)) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PARI \brief Macro para comprobar si un número de tipo entero es par. \param[in] a Un número. \return Dos posibilidades: - 0: El número es impar. - 1: El número es par. \note Esta macro usa el operador \b % de C para calcular el resto de la división del número pasado entre 2, por lo que el argumento de entrada ha de ser de tipo entero: \p char, \p short, \p int, \p long o \p long \p long (con los identificadores \p signed o \p undigned). \date 15 de marzo de 2011: Creación de la macro. */ #define GEOC_PARI(a) ((a)%2 ? 0 : 1) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_ES_CERO \brief Macro para comprobar si un número puede considerarse cero con una cierta tolerancia. \param[in] num Número a comprobar. \param[in] tol Tolerancia. Ha de ser un número \b POSITIVO. \return Dos posibilidades: - 0: \em num es distinto de 0, tal que \f$num<=-tol\f$ o \f$num>=tol\f$. - 1: \em num es 0, tal que \f$ -tol < num < tol\f$. \note Para que esta macro funcione correctamente, \em tol ha de ser un número \b POSITIVO. \date 13 de marzo de 2010: Creación de la macro. \todo Esta macro todavía no está probada. */ #define GEOC_ES_CERO(num,tol) (((num)>(-(tol)))&&((num)<(tol)) ? 1 : 0) /******************************************************************************/ /******************************************************************************/ /** \def GEOC_DBL \brief Macro para realizar una conversión explícita a tipo de dato \p double. \param[in] a Un número. \return Órdenes para la conversión explícita del dato pasado a \p double. \date 19 de junio de 2011: Creación de la macro. */ #define GEOC_DBL(a) ((double)(a)) /******************************************************************************/ /******************************************************************************/ /** \brief Indica si hay alguna función compilada en paralelo con OpenMP en el fichero \ref fgeneral.c. \param[out] version Cadena identificadora de la versión de OpenMP utilizada. Este argumento sólo se utiliza si su valor de entrada es distinto de \p NULL y si hay alguna función compilada con OpenMP. \return Dos posibles valores: - 0: No hay ninguna función compilada en paralelo con OpenMP. - Distinto de 0: Sí hay alguna función compilada en paralelo con OpenMP. \note Esta función asume que el argumento \em version tiene suficiente memoria asignada (si es distinto de \p NULL). \date 22 de agosto de 2011: Creación de la función. \date 25 de agosto de 2011: Adición del argumento de entrada \em version. */ int GeocParOmpFgeneral(char version[]); /******************************************************************************/ /******************************************************************************/ /** \brief Mete un ángulo en el dominio \f$]-2*\pi,2*\pi[\f$. \param[in] angulo Valor angular, en radianes. \return Valor angular de entrada, en el dominio \f$]-2*\pi,2*\pi[\f$, en radianes. \note Esta función elimina todas las vueltas completas a la circunferencia que hacen que el posible valor de entrada esté fuera de los límites del dominio de salida. \date 10 de junio de 2011: Creación de la función. */ double PonAnguloDominio(const double angulo); /******************************************************************************/ /******************************************************************************/ /** \brief Busca en una lista de coordenadas de una polilínea en una dimensión las posiciones de inicio y fin del segmento que encierra a un punto dado. \param[in] valor Coordenada del punto de trabajo, contenido en el segmento a buscar. \param[in] lista Lista con las coordenadas de la polilínea. \param[in] nDatos Número de elementos de la lista de coordenadas pasadas. \param[in] incDatos Posiciones de separación entre cada elemento de \em lista. Ha de ser un número positivo. \param[out] posInicio Posición en \em lista de la coordenada inicial del segmento buscado. \param[out] posFin Posición en \em lista de la coordenada final del segmento buscado. \note Para convertir las posiciones devueltas por la función en las posiciones reales del array en memoria, han de ser multiplicadas por el valor \em incDatos. \note En las siguientes notas, cuando se habla de la longitud o el número de elementos de \em lista quiere decir el número de datos de trabajo, no todas las posiciones almacenadas en memoria. \note Esta función no comprueba internamente si la longitud de \em lista es congruente con el valor \em nDatos. \note Esta función supone que \em lista contiene un número de elementos >= 2. \note Esta función supone que los elementos almacenados en \em lista están ordenados de menor a mayor. \note Esta función supone que \em lista[0] <= \em valor >= \em lista[nDatos-1]. \note Si algún elemento de \em lista es igual a \em valor, su posición será el punto de inicio del segmento calculado, excepto si el elemento de \em lista es el último, en cuyo caso será el punto final. \date 06 de diciembre de 2010: Creación de la función. */ void BuscaSegmento1DInc(const double valor, const double* lista, const size_t nDatos, const size_t incDatos, size_t* posInicio, size_t* posFin); /******************************************************************************/ /******************************************************************************/ /** \brief Busca en una lista de coordenadas de una polilínea en una dimensión las posiciones de inicio y fin del segmento que encierra a un punto dado. \param[in] valor Coordenada del punto de trabajo, contenido en el segmento a buscar. \param[in] lista Lista con las coordenadas de la polilínea. \param[in] nDatos Número de elementos de la lista de coordenadas pasadas. \param[out] posInicio Posición en \em lista de la coordenada inicial del segmento buscado. \param[out] posFin Posición en \em lista de la coordenada final del segmento buscado. \note Esta función no comprueba internamente si la longitud de \em lista es congruente con el valor \em nDatos. \note Esta función supone que \em lista contiene un número de elementos >= 2. \note Esta función supone que los elementos almacenados en \em lista están ordenados de menor a mayor. \note Esta función supone que \em lista[0] <= \em valor >= \em lista[nDatos-1]. \note Si algún elemento de \em lista es igual a \em valor, su posición será el punto de inicio del segmento calculado, excepto si el elemento de \em lista es el último, en cuyo caso será el punto final. \date 11 de octubre de 2009: Creación de la función. */ void BuscaSegmento1D(const double valor, const double* lista, const size_t nDatos, size_t* posInicio, size_t* posFin); /******************************************************************************/ /******************************************************************************/ /** \brief Busca las posiciones fila y columna del elemento de una matriz correspondiente a la esquina NW del cuadrado que encierra a un punto dado. \param[in] xPto Coordenada X del punto de trabajo. \param[in] yPto Coordenada Y del punto de trabajo. \param[in] xMin Coordenada X mínima (esquina W) de los puntos almacenados en la matriz. \param[in] xMax Coordenada X máxima (esquina E) de los puntos almacenados en la matriz. \param[in] yMin Coordenada Y mínima (esquina S) de los puntos almacenados en la matriz. \param[in] yMax Coordenada Y máxima (esquina N) de los puntos almacenados en la matriz. \param[in] pasoX Paso de malla (valor absoluto) en la dirección X. \param[in] pasoY Paso de malla (valor absoluto) en la dirección Y. \param[out] fil Fila del elemento NW del cuadrado que encierra al punto de trabajo. \param[out] col Columna del elemento NW del cuadrado que encierra al punto de trabajo. \note Esta función no comprueba internamente si las coordenadas del punto de trabajo son congruentes con los límites de la matriz. \note Esta función asume que los pasos de malla son congruentes con los límites de la malla (supone que el cálculo del número de nodos es un número entero o del tipo X.9... o X.0...). \note Esta función asume que \em xMin < \em xMax y que \em yMin < \em yMax. \note Esta función asume que \em pasoX y \em pasoY han sido introducidos en valor absoluto. \date 15 de mayo de 2010: Creación de la función. \date 25 de septiembre de 2011: Corrección de error que hacía que se calculase una fila de más en determinados casos. \todo Esta función no está probada. */ void BuscaPosNWEnMalla(const double xPto, const double yPto, const double xMin, const double xMax, const double yMin, const double yMax, const double pasoX, const double pasoY, size_t* fil, size_t* col); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de mínimo valor en una lista de tipo \p double. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de mínimo valor. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 22 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ double Minimo(const double* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de máximo valor en una lista de tipo \p double. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de máximo valor. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 22 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ double Maximo(const double* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de mínimo valor absoluto en una lista de tipo \p double. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de mínimo valor absoluto. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 22 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ double MinimoAbs(const double* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de máximo valor absoluto en una lista de tipo \p double. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de máximo valor absoluto. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 22 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ double MaximoAbs(const double* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de mínimo valor en una lista de tipo \p size_t. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de mínimo valor. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 24 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ size_t MinimoSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca el elemento de máximo valor en una lista de tipo \p size_t. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \return Elemento de máximo valor. \note Esta función se puede ejecutar en paralelo con OpenMP, versión 3.1 o superior (se detecta automáticamente en la compilación). \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \date 24 de agosto de 2011: Creación de la función. \todo Esta función todavía no está probada con OpenMP. */ size_t MaximoSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos); /******************************************************************************/ /******************************************************************************/ /** \brief Busca las posiciones que ocupan en una lista de tipo \p double los elementos de menor y mayor valor. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \param[out] posMin Posición en \em lista del elemento de menor valor. \param[out] posMax Posición en \em lista del elemento de mayor valor. \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \note Si hay varios elementos en la lista que se corresponden con el valor menor o mayor, la posición devuelta es la correspondiente al primer elemento a partir del inicio. \note Las posiciones devueltas lo son atendiendo al parámetro \em nDatos, por lo que para obtener las posiciones reales del elemento en memoria han de ser multiplicadas por el valor \em incDatos. \date 27 de octubre de 2009: Creación de la función. \date 29 de mayo de 2011: Adición del argumento de entrada \em incDatos. */ void MinMax(const double* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax); /******************************************************************************/ /******************************************************************************/ /** \brief Busca las posiciones que ocupan en una lista los elementos de menor y mayor valor absoluto. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \param[out] posMin Posición en \em lista del elemento de menor valor absoluto. \param[out] posMax Posición en \em lista del elemento de mayor valor absoluto. \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \note Si hay varios elementos en la lista que se corresponden con el valor menor o mayor, la posición devuelta es la correspondiente al primer elemento a partir del inicio. \note Las posiciones devueltas lo son atendiendo al parámetro \em nDatos, por lo que para obtener las posiciones reales del elemento en memoria han de ser multiplicadas por el valor \em incDatos. \date 27 de octubre de 2009: Creación de la función. \date 29 de mayo de 2011: Adición del argumento de entrada \em incDatos. */ void MinMaxAbs(const double* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax); /******************************************************************************/ /******************************************************************************/ /** \brief Busca las posiciones que ocupan en una lista de tipo \p size_t los elementos de menor y mayor valor. \param[in] lista Lista de valores. \param[in] nDatos Número de elementos de la lista de valores. \param[in] incDatos Posiciones de separación entre los elementos del vector \em lista. Este argumento siempre ha de ser un número positivo. \param[out] posMin Posición en \em lista del elemento de menor valor. \param[out] posMax Posición en \em lista del elemento de mayor valor. \note Esta función no comprueba internamente si la longitud de \em lista es congruente con los valores de \em nDatos e \em incDatos. \note Esta función supone que \em lista contiene un número de elementos >= 1. \note Si hay varios elementos en la lista que se corresponden con el valor menor o mayor, la posición devuelta es la correspondiente al primer elemento a partir del inicio. \note Las posiciones devueltas lo son atendiendo al parámetro \em nDatos, por lo que para obtener las posiciones reales del elemento en memoria han de ser multiplicadas por el valor \em incDatos. \date 08 de enero de 2010: Creación de la función. \date 29 de mayo de 2011: Adición del argumento de entrada \em incDatos. */ void MinMaxSizeT(const size_t* lista, const size_t nDatos, const size_t incDatos, size_t* posMin, size_t* posMax); /******************************************************************************/ /******************************************************************************/ /** \brief Asigna memoria para una matriz bidimensional en estilo C. \param[in] fil Número de filas de la matriz. \param[in] col Número de columnas de la matriz. \return Puntero a la matriz creada. Si ocurre algún error de asignación de memoria, se devuelve NULL. \note La memoria asignada no se inicializa a ningún valor. \note Los datos se almacenan en ROW MAJOR ORDER de forma contigua en memoria. \note Esta función no controla si alguna de las dimensiones pasadas es 0. \date 14 de enero de 2010: Creación de la función. \date 02 de diciembre de 2010: Reprogramación de la función para que los datos se almacenen en memoria de forma contigua. */ double** AsigMemMatrizC(const size_t fil, const size_t col); /******************************************************************************/ /******************************************************************************/ /** \brief Libera memoria de una matriz bidimensional en estilo C. \param[in] matriz Puntero al espacio de memoria a liberar. \date 14 de enero de 2010: Creación de la función. \date 27 de febrero de 2010: Corregido bug que hacía que la función diese error si se le pasaba un puntero a NULL. */ void LibMemMatrizC(double** matriz); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula las posiciones de comienzo de elementos repetidos en un vector. - Para un vector de datos [1,2,2,3,4,4] se devuelve el vector de posiciones [0,1,3,4]. - Para un vector de datos [1,2,2,3,4] se devuelve el vector de posiciones [0,1,3,4]. - Para un vector de datos [1,1,1,1,1] se devuelve el vector de posiciones [0]. - Para un vector de datos [1] se devuelve el vector de posiciones [0]. \param[in] datos Vector de datos. \param[in] nDatos Número de elementos de \em datos. No puede ser 0. \param[in] incDatos Posiciones de separación entre los elementos del vector \em datos. Este argumento siempre ha de ser un número positivo. \param[out] nRepe Número de elementos del vector de posiciones de comienzo de elementos repetidos devuelto por la función. \return Vector, de \em nRepe elementos, que almacena las posiciones de comienzo de elementos repetidos en el vector \em datos. Las posiciones devueltas no tienen en cuenta el argumento \em incDatos, luego no son posiciones en el array realmente almacenado en memoria. Los índices comienzan en 0. Si ocurre un error de asignación de memoria se devuelve \p NULL. \note Esta función no comprueba internamente el vector pasado contiene suficiente memoria. \note Esta función no comprueba internamente si las dimensiones del vector pasado son congruentes con el espacio almacenado en memoria. \note Esta función no comprueba internamente si el argumento \em nDatos es igual a 0. \note Para calcular con los valores de salida las posiciones reales en el vector \em datos es necesario tener en cuenta el argumento \em incDatos. \date 02 de febrero de 2011: Creación de la función. */ size_t* PosRepeEnVector(const double* datos, const size_t nDatos, const size_t incDatos, size_t* nRepe); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el número de elementos repetidos en un vector a partir de la salida de la función \ref PosRepeEnVector. - Para un vector de datos [1,2,2,3,4,4], donde la función \ref PosRepeEnVector devuelve el vector de posiciones [0,1,3,4], esta función devuelve el vector [1,2,1,2]. - Para un vector de datos [1,2,2,3,4], donde la función \ref PosRepeEnVector devuelve el vector de posiciones [0,1,3,4], esta función devuelve el vector [1,2,1,1]. - Para un vector de datos [1,1,1,1,1], donde la función \ref PosRepeEnVector devuelve el vector de posiciones [0], esta función devuelve el vector [5]. - Para un vector de datos [1], donde la función \ref PosRepeEnVector devuelve el vector de posiciones [0], esta función devuelve el vector [1]. \param[in] pos Vector de posiciones devuelto por la función \ref PosRepeEnVector. \param[in] nPos Número de elementos de \em pos. No puede ser 0. \param[in] nElemVecOrig Número de elementos del vector de datos original. \return Vector, de \em nPos elementos, que almacena el número de elementos repetidos a partir de cada posición (incluida ésta) almacenada en el vector \em pos. Si ocurre un error de asignación de memoria se devuelve \p NULL. \note Esta función no comprueba internamente el vector pasado contiene suficiente memoria. \note Esta función no comprueba internamente si las dimensiones del vector pasado son congruentes con el espacio almacenado en memoria. \note Esta función no comprueba internamente si el argumento \em nPos es igual a 0. \date 02 de febrero de 2011: Creación de la función. */ size_t* NumElemRepeEnVector(const size_t* pos, const size_t nPos, const size_t nElemVecOrig); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica un factor de escala y una traslación (en este orden) a los elementos de un vector. \param[in,out] vector Vector de datos. Al término de la ejecución de la función, se ha aplicado un factor de escala y una traslación (en este orden) a los elementos del vector. \param[in] nElem Número de elementos de \em vector. \param[in] inc Posiciones de separación entre los elementos del vector \em vector. Este argumento siempre ha de ser un número positivo. \param[in] escala Factor de escala a aplicar. \param[in] traslada Traslación a aplicar. \note Primero se aplica el factor de escala y luego la traslación. \note Esta función asume que el vector de entrada \em vector tiene memoria asignada. \date 18 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void EscalaYTrasladaVector(double* vector, const size_t nElem, const size_t inc, const double escala, const double traslada); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica una traslación y un factor de escala (en este orden) a los elementos de un vector. \param[in,out] vector Vector de datos. Al término de la ejecución de la función, se ha aplicado una traslación y un factor de escala (en este orden) a los elementos del vector. \param[in] nElem Número de elementos de \em vector. \param[in] inc Posiciones de separación entre los elementos del vector \em vector. Este argumento siempre ha de ser un número positivo. \param[in] escala Factor de escala a aplicar. \param[in] traslada Traslación a aplicar. \note Primero se aplica la traslación y luego el factor de escala. \note Esta función asume que el vector de entrada \em vector tiene memoria asignada. \date 18 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void TrasladaYEscalaVector(double* vector, const size_t nElem, const size_t inc, const double escala, const double traslada); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/segmento.h000755 001750 001750 00000035556 12540021550 017361 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom @{ \file segmento.h \brief Declaración de funciones para la realización de cálculos con segmentos. \author José Luis García Pallero, jgpallero@gmail.com \date 22 de abril de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _SEGMENTO_H_ #define _SEGMENTO_H_ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/fgeneral.h" #include"libgeoc/ptopol.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_NO_INTERSEC \brief Identificador de que dos segmentos no se cortan. \date 14 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_NO_INTERSEC 0 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_INTERSEC \brief Identificador de que dos segmentos se cortan en un punto, pero no son colineales. \date 14 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_INTERSEC 1 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN \brief Identificador de que dos segmentos se cortan en un punto, el cual es un extremo que está encima del otro segmento, pero no son colineales. \date 14 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN 2 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_INTERSEC_EXTREMO_COLIN \brief Identificador de que dos segmentos tienen un punto común y son colineales. \date 14 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_INTERSEC_EXTREMO_COLIN 3 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_INTERSEC_MISMO_SEG \brief Identificador de que dos segmentos tienen todos sus puntos extremos en común. \date 21 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_INTERSEC_MISMO_SEG 4 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_SEG_INTERSEC_COLIN \brief Identificador de que dos segmentos tienen más de un punto en común. \date 14 de mayo de 2011: Creación de la constante. */ #define GEOC_SEG_INTERSEC_COLIN 5 /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la posición relativa de un punto con respecto a una recta en el plano. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] xIni Coordenada X del punto inicial del segmento que define la recta. \param[in] yIni Coordenada Y del punto inicial del segmento que define la recta. \param[in] xFin Coordenada X del punto final del segmento que define la recta. \param[in] yFin Coordenada Y del punto final del segmento que define la recta. \return Varias posibilidades: - Menor que 0: El punto está a la derecha de la recta. - 0: El punto pertenece a la recta. - Mayor que 0: El punto está a la izquierda de la recta. \note Para la definición de derecha e izquierda, se considera que el sentido de la recta es aquél que se define del punto de inicio al punto final del segmento de trabajo. \note El resultado de esta función no es robusto, es decir, puede dar resultados incorrectos debido a errores de redondeo (salvo que todas las coordenadas pasadas sean números enteros). \note El código de esta función ha sido tomado de la función orient2dfast(), de http://www.cs.cmu.edu/afs/cs/project/quake/public/code/predicates.c \date 20 de abril de 2010: Creación de la función. \date 14 de mayo de 2011: Cambio de nombre a la función. */ double PosPtoRecta2D(const double x, const double y, const double xIni, const double yIni, const double xFin, const double yFin); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si tres puntos (A, B, C) del plano son colineales. \param[in] xA Coordenada X del punto A. \param[in] yA Coordenada Y del punto A. \param[in] xB Coordenada X del punto B. \param[in] yB Coordenada Y del punto B. \param[in] xC Coordenada X del punto C. \param[in] yC Coordenada Y del punto C. \return Dos posibilidades: - 0: Los puntos no son colineales. - Distinto de 0: Los puntos son colineales. \note Esta función utiliza internamente la función \ref PtoComunSegmParalelos2D, que no es robusta. En consecuencia, los resultados de esta función tampoco lo son. \note Estafunción sirve de apoyo para \ref PtoComunSegmParalelos2D. \date 14 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int TresPuntosColineales2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está situado entre dos puntos (pero no es igual a ninguno de ellos) en el plano. Se asume que los tres puntos con colineales. \param[in] x Coordenada X del punto a comprobar. \param[in] y Coordenada Y del punto a comprobar. \param[in] xA Coordenada X del primer punto del segmento. \param[in] yA Coordenada Y del primer punto del segmento. \param[in] xB Coordenada X del segundo punto del segmento. \param[in] yB Coordenada Y del segundo punto del segmento. \return Dos posibilidades: - 0: El punto de trabajo no está situado entre los dos puntos dato o es igual a alguno de ellos. - Distinto de 0: El punto de trabajo sí está situado entre los dos puntos dato. \note Esta función sirve de apoyo para \ref PtoComunSegmParalelos2D. \date 14 de mayo de 2011: Creación de la función. \todo Esta función no está probada. */ int PuntoEntreDosPuntos2DColin(const double x, const double y, const double xA, const double yA, const double xB, const double yB); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula un punto común entre dos segmentos paralelos AB y CD. \param[in] xA Coordenada X del punto A. \param[in] yA Coordenada Y del punto A. \param[in] xB Coordenada X del punto B. \param[in] yB Coordenada Y del punto B. \param[in] xC Coordenada X del punto C. \param[in] yC Coordenada Y del punto C. \param[in] xD Coordenada X del punto D. \param[in] yD Coordenada Y del punto D. \param[out] x Coordenada X del punto común. \param[out] y Coordenada Y del punto común. \return Dos posibilidades: - #GEOC_SEG_NO_INTERSEC: Los segmentos no tienen ningún punto en común. - #GEOC_SEG_INTERSEC_EXTREMO_COLIN: Los segmentos tienen un extremo común y son colineales. - #GEOC_SEG_INTERSEC_MISMO_SEG: Los dos segmentos son idénticos. - #GEOC_SEG_INTERSEC_COLIN: Los segmentos tienen más de un punto en común. \note Esta función sirve de apoyo para \ref IntersecSegmentos2D. \note Esta función utiliza internamente la función \ref TresPuntosColineales2D, que no es robusta. En consecuencia, los resultados de esta función tampoco lo son. \note Si los segmentos se tocan en los dos extremos (son el mismo segmento), las coordenadas devueltas son siempre las del vértice A. \note Si los segmentos tienen más de un punto en común, pero no son el mismo segmento, las coordenadas de salida siempre son las de un punto extremo de un segmento. Este punto extremo se intentará que sea uno de los puntos iniciales de algún segmento, anque si no lo es, será uno de los finales. El orden de preferencia de las coordenadas de salida es: A, C, B, D. \date 14 de mayo de 2011: Creación de la función. \date 21 de mayo de 2011: Adición de nuevos valores de salida: #GEOC_SEG_INTERSEC_EXTREMO_COLIN y #GEOC_SEG_INTERSEC_MISMO_SEG. \todo Esta función no está probada. */ int PtoComunSegmParalelos2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC, const double xD, const double yD, double* x, double* y); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula la intersección de dos segmentos AB y CD en el plano. \param[in] xA Coordenada X del punto A. \param[in] yA Coordenada Y del punto A. \param[in] xB Coordenada X del punto B. \param[in] yB Coordenada Y del punto B. \param[in] xC Coordenada X del punto C. \param[in] yC Coordenada Y del punto C. \param[in] xD Coordenada X del punto D. \param[in] yD Coordenada Y del punto D. \param[out] x Coordenada X del punto común. \param[out] y Coordenada Y del punto común. \return Cinco posibilidades: - #GEOC_SEG_NO_INTERSEC: Los segmentos no tienen ningún punto en común. - #GEOC_SEG_INTERSEC: Los segmentos se cortan en un punto. - #GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN: El extremo de un segmento toca al otro segmento, pero los segmentos no son colineales. - #GEOC_SEG_INTERSEC_EXTREMO_COLIN: Los segmentos tienen un extremo común y son colineales. - #GEOC_SEG_INTERSEC_MISMO_SEG: Los dos segmentos son idénticos. - #GEOC_SEG_INTERSEC_COLIN: Los segmentos tienen más de un punto en común. \note Esta función utiliza internamente la función \ref PtoComunSegmParalelos2D, que no es robusta. En consecuencia, los resultados de esta función tampoco lo son. \note Si los segmentos se tocan en los dos extremos (son el mismo segmento), las coordenadas devueltas son siempre las del vértice A. \note Si los segmentos tienen más de un punto en común, pero no son el mismo segmento, las coordenadas de salida siempre son las de un punto extremo de un segmento. Este punto extremo se intentará que sea uno de los puntos iniciales de algún segmento, anque si no lo es, será uno de los finales. El orden de preferencia de las coordenadas de salida es: A, C, B, D. \date 14 de mayo de 2011: Creación de la función. \date 21 de mayo de 2011: Adición de un nuevo valor de salida: #GEOC_SEG_INTERSEC_MISMO_SEG. \date 06 de julio de 2011: Adición de chequeo rápido al principio de la función para descartar que los segmentos no tienen ningún punto en común. */ int IntersecSegmentos2D(const double xA, const double yA, const double xB, const double yB, const double xC, const double yC, const double xD, const double yD, double* x, double* y); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/polig.h000755 001750 001750 00000170303 12540021550 016640 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file polig.h \brief Definición de estructuras y declaración de funciones para el trabajo con polígonos. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 20 de abril de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _POLIG_H_ #define _POLIG_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include #include"libgeoc/dpeucker.h" #include"libgeoc/errores.h" #include"libgeoc/fgeneral.h" #include"libgeoc/geocnan.h" #include"libgeoc/geocomp.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \struct polig \brief Estructura contenedora de los vértices que definen el contorno de uno o varios polígono. \date 20 de abril de 2011: Creación de la estructura. \date 26 de mayo de 2011: Reorganización total de la estructura. \date 28 de mayo de 2011: Adición de los campos polig::hayArea, polig::area, polig::hayLim, polig::xMin, polig::xMax, polig::yMin e polig::yMax. */ typedef struct { /** \brief Número de elementos de los vectores de coordenadas. */ size_t nElem; /** \brief Vector de polig::nElem elementos, que almacena las coordenadas X de los vértices del polígono (o los polígonos), así como los separadores entre polígonos. La primera coordenada de cada polígono se repite al final. */ double* x; /** \brief Vector de polig::nElem elementos, que almacena las coordenadas Y de los vértices del polígono (o los polígonos), así como los separadores entre polígonos. La primera coordenada de cada polígono se repite al final. */ double* y; /** \brief Número de polígonos almacenados. */ size_t nPolig; /** \brief Vector de polig::nPolig elementos, que almacena las posiciones en los vectores \em x e \em y de inicio de cada polígono almacenado. */ size_t* posIni; /** \brief Vector de polig::nPolig elementos, que almacena el número de vértices de cada polígono almacenado. El último vértice de cada polígono, que es el primero repetido, también entra en la cuenta. */ size_t* nVert; /** \brief Identificador de si la estructura contiene información acerca de los límites del rectángulo que encierra a cada polígono almacenado. Dos posibilidades: - 0: La estructura no contiene información de los límites. - Distinto de 0: La estructura sí contiene información de los límites. */ int hayLim; /** \brief Vector de polig::nPolig elementos, que almacena la coordenada X mínima de cada polígono almacenado. Este campo sólo contiene información si el campo polig::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* xMin; /** \brief Vector de polig::nPolig elementos, que almacena la coordenada X máxima de cada polígono almacenado. Este campo sólo contiene información si el campo polig::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* xMax; /** \brief Vector de polig::nPolig elementos, que almacena la coordenada Y mínima de cada polígono almacenado. Este campo sólo contiene información si el campo polig::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* yMin; /** \brief Vector de polig::nPolig elementos, que almacena la coordenada Y máxima de cada polígono almacenado. Este campo sólo contiene información si el campo polig::hayLim es distinto de 0; si no, es igual a \p NULL. */ double* yMax; /** \brief Identificador de si la estructura contiene información acerca de la superficie de los polígonos almacenados. Dos posibilidades: - 0: La estructura no contiene información de superficie. - Distinto de 0: La estructura sí contiene información de superficie. */ int hayArea; /** \brief Vector de polig::nPolig elementos, que almacena la superficie de cada polígono almacenado. Este campo sólo contiene información si el campo polig::hayArea es distinto de 0; si no, es igual a \p NULL. La superficie almacenada sólo es correcta si el polígono es simple, esto es, si sus lados no se cortan entre ellos mismos. El área de los polígono puede ser negativa o positiva, de tal forma que: - Si es negativa: Los vértices de polígono están ordenados en el sentido de las agujas del reloj. - Si es positiva: Los vértices de polígono están ordenados en sentido contrario al de las agujas del reloj. */ double* area; }polig; /******************************************************************************/ /******************************************************************************/ /** \brief Indica si hay alguna función compilada en paralelo con OpenMP en el fichero \ref polig.c. \param[out] version Cadena identificadora de la versión de OpenMP utilizada. Este argumento sólo se utiliza si su valor de entrada es distinto de \p NULL y si hay alguna función compilada con OpenMP. \return Dos posibles valores: - 0: No hay ninguna función compilada en paralelo con OpenMP. - Distinto de 0: Sí hay alguna función compilada en paralelo con OpenMP. \note Esta función asume que el argumento \em version tiene suficiente memoria asignada (si es distinto de \p NULL). \date 27 de mayo de 2011: Creación de la función. \date 25 de agosto de 2011: Adición del argumento de entrada \em version. */ int GeocParOmpPolig(char version[]); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polig vacía. \return Estructura \ref polig vacía. Los campos escalares se inicializan con el valor 0 y los vectoriales con \p NULL. Si se devuelve \p NULL ha ocurrido un error de asignación de memoria. \date 26 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ polig* IniciaPoligVacio(void); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para la rutina de creación de una estructura \ref polig a partir de dos vectores que contienen las coordenadas de los vértices. Esta función calcula el número máximo de elementos que almacenarán los vectores de coordenadas de una estructura \ref polig y el número de polígonos almacenados en los vectores de trabajo. \param[in] nElem Número de elementos de los vectores de coordenadas originales. \param[in] posNanX Vector que almacena las posiciones de los elementos #GEOC_NAN en el vector \em x de coordenadas originales. \param[in] posNanY Vector que almacena las posiciones de los elementos #GEOC_NAN en el vector \em y de coordenadas originales. \param[in] nNanX Número de elementos del vector \em posNanX. \param[in] nNanY Número de elementos del vector \em posNanY. \param[out] nElemMax Número máximo de elementos que contendrán los vectores de coordenadas de los elementos de la estructura. \param[out] nPolig Número de polígonos almacenados en los vectores \em x e \em y de coordenadas originales. \return Variable de error. Tres posibilidades: - #GEOC_ERR_NO_ERROR: Si todo ha ido bien. - #GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG: Si los vectores \em x e \em y de coordenadas originales almacenan un número distinto de polígonos, es decir, \em nNanX es distinto que \em nNanY. - #GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG: Si algunos polígonos almacenados en \em x e \em y son distintos, es decir, las posiciones almacenadas en \em posNanX son distintas de las almacenadas en \em posNanY. \note Esta función no comprueba si el número de elementos de los vectores \em posNanX y \em posNanY es congruente con los valores pasados en \em nNanX y \em nNanY. \date 26 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ int AuxCreaPolig1(const size_t nElem, const size_t* posNanX, const size_t* posNanY, const size_t nNanX, const size_t nNanY, size_t* nElemMax, size_t* nPolig); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para la rutina de creación de una estructura \ref polig a partir de dos vectores que contienen las coordenadas de los vértices. Esta función copia una serie de datos de dos vectores en otros dos. \param[in] x Vector que contiene las coordenadas X de los vértices a copiar. \param[in] y Vector que contiene las coordenadas Y de los vértices a copiar. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] xSal Vector para almacenar los elementos copiados del vector \em x. Ha de tener la suficiente memoria asignada para copiar \em nElem elementos más un posible elemento adicional, que es el primer elemento de \em x, si éste no se repite al final. \param[out] ySal Vector para almacenar los elementos copiados del vector \em y. Ha de tener la suficiente memoria asignada para copiar \em nElem elementos más un posible elemento adicional, que es el primer elemento de \em y, si éste no se repite al final. \param[out] nCopias Número de elementos copiados en los vectores \em xSal e \em ySal, incluido el primer punto repetido al final, si se copia. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y, \em xSal e \em ySal es congruente con los valores pasados en \em nElem, \em incX e \em incY. \date 26 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ void AuxCreaPolig2(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, double* xSal, double* ySal, size_t* nCopias); /******************************************************************************/ /******************************************************************************/ /** \brief Función auxiliar para las rutinas de creación de estructuras \ref polig a partir de dos vectores que contienen las coordenadas de los vértices. Esta función crea los polígonos en el formato de almacenamiento de \ref polig a partir de los vectores de entrada. \param[in] x Vector que contiene las coordenadas X de los vértices de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices de trabajo. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] posNan Vector que almacena las posiciones de los elementos #GEOC_NAN en los vectores \em x e \em y. \param[in] nNan Número de elementos del vector \em posNan. \param[out] xSal Vector para almacenar las coordenadas X de los vértices de los polígonos creados. \param[out] ySal Vector para almacenar las coordenadas Y de los vértices de los polígonos creados. \param[out] posIni Vector para almacenar las posiciones de inicio de los polígonos creados. \param[out] nVert Vector para almacenar el número de vértices de los polígonos creados. \param[out] nPtos Número de posiciones con información almacenada en los vectores \em xSal e \em ySal. \param[out] nPolig Número de posiciones con información almacenada en los vectores \em posIni y \em nVert. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y y \em posNan es congruente con los valores pasados en \em nElem, \em incX, \em incY y \em nNan. \note Esta función asume que los vectores \em xSal, \em ySal, \em posIni y \em nVert tienen asignada suficiente memoria. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ void AuxCreaPolig3(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, double* xSal, double* ySal, size_t* posIni, size_t* nVert, size_t* nPtos, size_t* nPolig); /******************************************************************************/ /******************************************************************************/ /** \brief Crea una estructura \ref polig a partir de dos vectores que contienen las coordenadas de los vértices de uno o varios polígonos. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono o polígonos de trabajo. Si hay varios polígonos, han de estar separados por un valor #GEOC_NAN. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono o polígonos de trabajo. Si hay varios polígonos, han de estar separados por un valor #GEOC_NAN. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] idError Identificador de error. Varias posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG: Los vectores \em x e \em y contienen un número distinto de polígonos. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG: Los vectores \em x e \em y contienen distintos polígonos. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \return Estructura \ref polig con los polígonos pasados. Si ocurre algún error, se devuelve \p NULL y el motivo del fallo se codifica en la variable \em idError. \note Esta función está paralelizada con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \note Si los vectores \em x e \em y almacenan varios polígonos, éstos se separan mediante valores #GEOC_NAN. Poner #GEOC_NAN en la primera posición y/o la última es opcional. \note Los posibles valores #GEOC_NAN han de estar en las mismas posiciones en \em x e \em y. \note Para los polígonos, es opcional repetir las coordenadas del primer vértice al final del listado del resto de vértices. \note Esta función no calcula los límites de los polígonos ni su área, por lo que los campos polig::hayLim y polig::hayArea se inicializan a 0 y los campos polig::xMin, polig::xMax, polig::yMin, polig::yMax y polig::area se inicializan a \p NULL. \date 26 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ polig* CreaPolig(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, int* idError); /******************************************************************************/ /******************************************************************************/ /** \brief Enlaza el contenido de una estructura \ref polig a otra. \param[in] poliEnt Estructura \ref polig de entrada, que almacena los datos a enlazar. \param[out] poliSal Estructura \ref polig, cuyos campos serán enlazados a los de la estructura \em poliEnt. Esta estructura ha de estar, como mínimo, inicializada. Al término de la ejecución de la función, las estructuras \em poliEnt y \em poliSal comparten el mismo espacio de memoria en sus argumentos vectoriales. \note Esta función asume que la estructura de entrada \em poligEnt tiene memoria asignada. \note Esta función asume que la estructura de salida \em poligSal está, como mínimo, inicializada. \note Esta función libera la posible memoria asignada a los campos de \em poliSal antes de realizar el enlace. \date 19 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void EnlazaCamposPolig(polig* poliEnt, polig* poliSal); /******************************************************************************/ /******************************************************************************/ /** \brief Copia el contenido de una estructura \ref polig en otra. \param[in] poli Estructura \ref polig de entrada, que almacena los datos a copiar. \param[out] idError Identificador de error. Varias posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG: Los campos polig::x e polig::y del polígono de entrada contienen un número distinto de polígonos. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG: Los campos polig::x e polig::y del polígono de entrada contienen distintos polígonos. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \return Polígono con los datos contenidos en \em poli copiados. Si ocurre algún error se devuelve \p NULL y la causa se almacena en el argumento \em idError. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \date 09 de julio de 2011: Creación de la función. \note Esta función todavía no está probada. */ polig* CopiaPolig(const polig* poli, int* idError); /******************************************************************************/ /******************************************************************************/ /** \brief Añade el contenido de una estructura \ref polig a otra. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se han añadido los polígonos de la estructura \em anyade. \param[in] anyade Estructura cuyo contenido será añadido a \em poli. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función asume que la estructura de entrada \ref polig tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de las estructuras de entrada no se libera. \note Si la estructura \em poli guarda información de superficie y límites de los polígonos almacenados, esta información se calcula también para los nuevos datos (en realidad, si la estructura \em anyade ya los tiene calculados, simplemente se copian). \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ int AnyadePoligPolig(polig* poli, const polig* anyade); /******************************************************************************/ /******************************************************************************/ /** \brief Añade al contenido de una estructura \ref polig un conjunto de polígonos definidos a partir de un listado con las coordenadas de sus vértices, de la misma forma que el utilizado en la función \ref CreaPolig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se han añadido los polígonos pasados en \em x e \em y. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono o polígonos a añadir. Si hay varios polígonos, han de estar separados por un valor #GEOC_NAN. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono o polígonos a añadir. Si hay varios polígonos, han de estar separados por un valor #GEOC_NAN. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. - #GEOC_ERR_POLIG_VEC_DISTINTO_NUM_POLIG: Los vectores \em x e \em y contienen un número distinto de polígonos. No contienen el mismo número de identificadores #GEOC_NAN. - #GEOC_ERR_POLIG_VEC_DISTINTOS_POLIG: Los vectores \em x e \em y contienen distintos polígonos. Los marcadores #GEOC_NAN no están colocados en las mismas posiciones. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de la estructura y los vectores de entrada no se libera. \note Si la estructura \em poli guarda información de superficie y límites de los polígonos almacenados, esta información se calcula también para los nuevos datos. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \note Si los vectores \em x e \em y almacenan varios polígonos, éstos se separan mediante valores #GEOC_NAN. Poner #GEOC_NAN en la primera posición y/o la última es opcional. \note Los posibles valores #GEOC_NAN han de estar en las mismas posiciones en \em x e \em y. \note Para los polígonos, es opcional repetir las coordenadas del primer vértice al final del listado del resto de vértices. \note Esta función crea internamente una estructura \ref polig para luego añadirla a \em poli con la función \ref AnyadePoligPolig. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ int AnyadeDatosPolig(polig* poli, const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Libera la memoria asignada a una estructura \ref polig. \param[in] datos Estructura \ref polig. \date 20 de abril de 2011: Creación de la estructura. \date 26 de mayo de 2011: Reescritura de la función para el trabajo con la nueva versión de la estructura. \note Esta función todavía no está probada. */ void LibMemPolig(polig* datos); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula los límites de todos los polígonos almacenados en una estructura \ref polig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se han añadido los límites de los polígonos almacenados. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función está paralelizada con OpenMP. \note Esta función asume que la estructura de entrada \ref polig tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de la estructura de entrada no se libera. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ int CalcLimitesPolig(polig* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula los límites de un polígono a partir de las coordenadas de sus vértices. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono de trabajo. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono de trabajo. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] xMin Coordenada X mímina del polígono. \param[out] xMax Coordenada X máxima del polígono. \param[out] yMin Coordenada Y mímina del polígono. \param[out] yMax Coordenada Y máxima del polígono. \note Esta función está paralelizada con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ void LimitesPoligono(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY, double* xMin, double* xMax, double* yMin, double* yMax); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula los límites de una serie de polígonos a partir de las coordenadas de sus vértices, almacenadas en vectores en el formato de la estructura \ref polig. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono de trabajo, tal y como se almacenan en una estructura \ref polig. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono de trabajo, tal y como se almacenan en una estructura \ref polig. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] posIni Vector de \em nPolig elementos, que almacena las posiciones de inicio de los polígonos de trabajo. \param[in] nVert Vector de \em nPolig elementos, que almacena el número de vértices de los polígonos de trabajo. \param[in] nPolig Número de polígonos de trabajo. \param[in] restaPosIni Número de posiciones a restar a los valores almacenados en \em posIni, de tal forma que los índices de los vértices se refieran al inicio pasado mediante los punteros \em x e \em y. \param[out] xMin Vector de \em nPolig elementos para almacenar las coordenadas X mínimas calculadas de los polígonos. \param[out] xMax Vector de \em nPolig elementos para almacenar las coordenadas X máximas calculadas de los polígonos. \param[out] yMin Vector de \em nPolig elementos para almacenar las coordenadas Y mínimas calculadas de los polígonos. \param[out] yMax Vector de \em nPolig elementos para almacenar las coordenadas Y máximas calculadas de los polígonos. \note Esta función está paralelizada con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y, \em posIni, \em nVert, \em xMin, \em xMax, \em yMin e \em yMax es congruente con los valores pasados de \em incX, \em incY, \em nPolig y \em restaPoliIni. \note Esta función no comprueba si las coordenadas almacenadas en los vectores \em x e \em y están en el formato de la estructura \ref polig. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ void LimitesPoligonosPolig(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posIni, const size_t* nVert, const size_t nPolig, const size_t restaPosIni, double* xMin, double* xMax, double* yMin, double* yMax); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el área de todos los polígonos almacenados en una estructura \ref polig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se han añadido las superficies de los polígonos almacenados. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función asume que la estructura de entrada \ref polig tiene memoria asignada. \note En caso de error de asignación de memoria, la memoria de la estructura de entrada no se libera. \date 29 de mayo de 2011: Creación de la función. \date 01 de agosto de 2011: Corregido error que hacía que se calculasen mal las superficies debido a un incorrecto uso del argumento \em restaPosIni de la función \ref AreaPoligonosSimplesPolig. \note Esta función todavía no está probada. */ int CalcAreaPolig(polig* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el área de un polígono simple (sin intersecciones consigo mismo) a partir de las coordenadas de sus vértices. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono de trabajo. Las coordenadas del primer punto pueden repetirse o no al final, indistintamente. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono de trabajo. Las coordenadas del primer punto pueden repetirse o no al final, indistintamente. \param[in] nElem Número de elementos de los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \return Superficie del polígono de trabajo. Dos posibilidades: - Número negativo: Los vértices del polígono están ordenados en el sentido de las agujas del reloj. - Número positivo: Los vértices del polígono están ordenados en el sentido contrario al de las agujas del reloj. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados de \em nElem, \em incX e \em incY. \note El algoritmo implementado es el correspondiente a la ecuación 21.4.20 del Numerical Recipes, tercera edición, página 1127. Este algoritmo trabaja con vectores de coordenadas en los que el primer punto no se repite al final. Esta función comprueba internamente si el primer punto se repite al final de los vectores pasados y actua en consecuencia para proporcionar un resultado correcto. \date 29 de mayo de 2011: Creación de la función. \date 23 de junio de 2011: Adición de la capacidad de trabajar con vectores de coordenadas en los que se repite el primer punto al final. \note Esta función todavía no está probada. */ double AreaPoligonoSimple(const double* x, const double* y, const size_t nElem, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el área de una serie de polígonos simples (sin intersecciones consigo mismo) a partir de las coordenadas de sus vértices, almacenadas en vectores en el formato de la estructura \ref polig. \param[in] x Vector que contiene las coordenadas X de los vértices del polígono de trabajo, tal y como se almacenan en una estructura \ref polig. \param[in] y Vector que contiene las coordenadas Y de los vértices del polígono de trabajo, tal y como se almacenan en una estructura \ref polig. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[in] posIni Vector de \em nPolig elementos, que almacena las posiciones de inicio de los polígonos de trabajo. \param[in] nVert Vector de \em nPolig elementos, que almacena el número de vértices de los polígonos de trabajo. \param[in] nPolig Número de polígonos de trabajo. \param[in] restaPosIni Número de posiciones a restar a los valores almacenados en \em posIni, de tal forma que los índices de los vértices se refieran al inicio pasado mediante los punteros \em x e \em y. \param[out] area Vector de \em nPolig elementos para almacenar las superficies calculadas de los polígonos. Los valores pueden ser positivos o negativos: - Número negativo: Los vértices del polígono están ordenados en el sentido de las agujas del reloj. - Número positivo: Los vértices del polígono están ordenados en el sentido contrario al de las agujas del reloj. \note Esta función está paralelizada con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em x, \em y, \em posIni, \em nVert y \em area es congruente con los valores pasados de \em incX, \em incY, \em nPolig y \em restaPoliIni. \note Esta función no comprueba si las coordenadas almacenadas en los vectores \em x e \em y están en el formato de la estructura \ref polig. \date 29 de mayo de 2011: Creación de la función. \note Esta función todavía no está probada. */ void AreaPoligonosSimplesPolig(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posIni, const size_t* nVert, const size_t nPolig, const size_t restaPosIni, double* area); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica un factor de escala y una traslación (en este orden) a las coordenadas de todos los polígonos almacenados en una estructura \ref polig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se ha aplicado un factor de escala y una traslación (en este orden) a las coordenadas de todos los polígonos almacenados y, si se indica, a los límites y las superficies. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] aplicaLim Identificador para aplicar o no los factores de escala y las traslaciones a los límites de los polígonos (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican los factores de escala ni las traslaciones a los límites. - Distinto de 0: Sí se aplican los factores de escala y las traslaciones a los límites, si estos están calculados en la estructura de entrada. \param[in] aplicaArea Identificador para aplicar o no los factores de escala (que se aplican como un único factor \em escalaX*escalaY) a las áreas de los polígonos (sólo si están previemente calculadas). Dos posibilidades: - 0: No se aplican los factores a las áreas. - Distinto de 0: Sí se aplican los factores a las áreas, si estas están calculadas en la estructura de entrada. \note Esta función está paralelizada con OpenMP. \note Primero se aplican los factores de escala y luego las traslaciones. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \note A las áreas sólo se aplican los factores de escala, ya que son invariantes ante traslaciones. \note A las áreas, los factores de escala se aplican como uno solo, igual a \em escalaX*escalaY, para que éstas queden correctamente expresadas en las nuevas unidades a las que da lugar el escalado. \date 02 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void EscalaYTrasladaPolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim, const int aplicaArea); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica una traslación y un factor de escala (en este orden) a las coordenadas de todos los polígonos almacenados en una estructura \ref polig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se ha aplicado una traslación y un factor de escala (en este orden) a las coordenadas de todos los polígonos almacenados y, si se indica, a los límites y las superficies. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] aplicaLim Identificador para aplicar o no las traslaciones y los factores de escala a los límites de los polígonos (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican las traslaciones ni los factores de escala a los límites. - Distinto de 0: Sí se aplican las traslaciones y los factores de escala a los límites, si estos están calculados en la estructura de entrada. \param[in] aplicaArea Identificador para aplicar o no los factores de escala (que se aplican como un único factor \em escalaX*escalaY) a las áreas de los polígonos (sólo si están previemente calculadas). Dos posibilidades: - 0: No se aplican los factores a las áreas. - Distinto de 0: Sí se aplican los factores a las áreas, si estas están calculadas en la estructura de entrada. \note Esta función está paralelizada con OpenMP. \note Primero se aplican las traslaciones y luego los factores de escala. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \note A las áreas sólo se aplican los factores de escala, ya que son invariantes ante traslaciones. \note A las áreas, los factores de escala se aplican como uno solo, igual a \em escalaX*escalaY, para que éstas queden correctamente expresadas en las nuevas unidades a las que da lugar el escalado. \date 02 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void TrasladaYEscalaPolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int aplicaLim, const int aplicaArea); /******************************************************************************/ /******************************************************************************/ /** \brief Aplica un factor de escala y una traslación (el orden de aplicación se ha de seleccionar) a las coordenadas de todos los polígonos almacenados en una estructura \ref polig. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, se ha aplicado un factor de escala y una traslación (orden a seleccionar) a las coordenadas de todos los polígonos almacenados y, si se indica, a los límites y las superficies. \param[in] escalaX Factor de escala a aplicar a las coordenadas X. \param[in] escalaY Factor de escala a aplicar a las coordenadas Y. \param[in] trasladaX Traslación a aplicar a las coordenadas X. \param[in] trasladaY Traslación a aplicar a las coordenadas Y. \param[in] orden Orden de aplicación de los factores de escala y traslación. Dos posibilidades: - 0: Primero se aplican los factores de escala y luego las traslaciones \f$x'=f\cdot x+t\f$. - Distinto de 0: Primero se aplican las traslaciones y luego los factores de escala \f$x'=(x+t)\cdot f\f$. \param[in] aplicaLim Identificador para aplicar o no los factores de escala y las traslaciones a los límites de los polígonos (sólo si están previemente calculados). Dos posibilidades: - 0: No se aplican los factores de escala ni las traslaciones a los límites. - Distinto de 0: Sí se aplican los factores de escala y las traslaciones a los límites, si estos están calculados en la estructura de entrada. \param[in] aplicaArea Identificador para aplicar o no los factores de escala (que se aplican como un único factor \em escalaX*escalaY) a las áreas de los polígonos (sólo si están previemente calculadas). Dos posibilidades: - 0: No se aplican los factores a las áreas. - Distinto de 0: Sí se aplican los factores a las áreas, si estas están calculadas en la estructura de entrada. \note Esta función asume que la estructura de entrada \em poli tiene memoria asignada. \note A las áreas sólo se aplican los factores de escala, ya que son invariantes ante traslaciones. \note A las áreas, los factores de escala se aplican como uno solo, igual a \em escalaX*escalaY, para que éstas queden correctamente expresadas en las nuevas unidades a las que da lugar el escalado. \date 02 de junio de 2011: Creación de la función. \date 18 de junio de 2011: Distinción entre factores de escala y traslaciones para las coordenadas X e Y. \note Esta función todavía no está probada. */ void MuevePolig(polig* poli, const double escalaX, const double escalaY, const double trasladaX, const double trasladaY, const int orden, const int aplicaLim, const int aplicaArea); /******************************************************************************/ /******************************************************************************/ /** \brief Elimina vértices de los polígonos almacenados en una estructura \ref polig mediante un algoritmo inspirado en el de Douglas-Peucker. Se usa internamente la función \ref AligeraPolilinea. \param[in,out] poli Estructura \ref polig, que almacena una serie de polígonos. Al término de la ejecución de la función, almacena el resultado de la aplicación a cada polígono del algoritmo de aligerado de vértices implementado en la función \ref AligeraPolilinea. \param[in] tol Tolerancia para eliminar vértices, en las mismas unidades que las coordenadas de los vértices. Ver la ayuda de la función \ref AligeraPolilinea. \param[in] robusto Identificador para realizar o no un aligerado robusto. Ha de ser un elemento del tipo enumerado #GEOC_DPEUCKER_ROBUSTO. Varias posibilidades: - #GeocDPeuckerRobNo: No se aplica el algoritmo robusto. - #GeocDPeuckerRobSi: Se aplica el algoritmo robusto completo, que garantiza la no ocurrencia de auto intersecciones en el polígono resultante. Internamente, primero se aplica el tratamiento robusto de la opción #GeocDPeuckerRobOrig y luego el de la opción #GeocDPeuckerRobAuto. - #GeocDPeuckerRobOrig: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos del polígono aligerado que se van creando no intersectarán con ninguno de los segmentos que forman los vértices que quedan por procesar del polígono original. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. - #GeocDPeuckerRobAuto: Se aplica un algoritmo semi robusto que consiste en garantizar que los segmentos del polígono aligerado que se van creando no intersectarán con ninguno de los segmentos del polígono aligerado creados con anterioridad. En casos muy especiales, este algoritmo puede seguir dando lugar a auto intersecciones. \param[in] nPtosRobusto Número de puntos del polígono original a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobOrig. Si se pasa el valor 0, se utilizan todos los puntos hasta el final del polígono original. \param[in] nSegRobusto Número de segmentos del polígono aligerado a utilizar en el caso de tratamiento robusto con las opciones #GeocDPeuckerRobSi o #GeocDPeuckerRobAuto. Si se pasa el valor 0, se utilizan todos los segmentos hasta el inicio del polígono aligerado. \return Variable de error. Dos posibilidades: - #GEOC_ERR_NO_ERROR: Todo ha ido bien. - #GEOC_ERR_ASIG_MEMORIA: Ha ocurrido un error de asignación de memoria. \note Esta función asume que \em poli está, como mínimo, inicializado. \note Si \em poli tiene límites y/o áreas calculadas en la entrada, también los tendrá en la salida. \note Un polígono aligerado sólo será válido si después de aplicarle la función \ref AligeraPolilinea mantiene un mínimo de 3 puntos no alineados por lo que, al término de la ejecución de esta función, el resultado puede ser una estructura \ref polig vacía. \date 09 de julio de 2011: Creación de la función. \date 10 de julio de 2011: Cambio del tipo del argumento \em robusto al tipo enumerado #GEOC_DPEUCKER_ROBUSTO. \date 31 de julio de 2011: Corregido error con índices a la hora de guardar los resultados y comprobación de que los polígonos de salida no estén compuestos por tres puntos alineados. \todo Esta función todavía no está probada. */ int AligeraPolig(polig* poli, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime una línea de cabecera para un polígono almacenado en una estructura \ref polig. \param[in] poli Estructura \ref polig. \param[in] indice Índice del polígono de trabajo en la estructura. \param[in] iniCab Cadena de texto con la que comenzará la cabecera. \param[in] impLim Identificador para imprimir o no los límites de coordenadas del polígono de trabajo. Dos posibles valores: - 0: No se imprimen. - Distinto de 0: Sí se imprimen. \param[in] formCoor Cadena de carácteres indicadora del formato para escribir las coordenadas de los límites. Este argumento sólo se usa internamente si se ha indicado la impresión de límites. \param[in] impArea Identificador para imprimir o no la superficie del polígono de trabajo. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] formArea Cadena de carácteres indicadora del formato para escribir el valor de la superficie. Este argumento sólo se usa internamente si se ha indicado la impresión de la superficie del polígono. \param[in] factorX Factor para multiplicar las coordenadas X de los vértices antes de imprimirlas. \param[in] factorY Factor para multiplicar las coordenadas Y de los vértices antes de imprimirlas. \param[in] repitePrimerPunto Identificador para tener o no en cuenta el primer vértice del polígono repetido al final del listado de coordenadas para el cálculo del número de vértices del polígono. Dos posibles valores: - 0: No se repite, luego no se tiene en cuenta. - Distinto de 0: Sí se repite, luego sí se tiene en cuenta. \param[in] idFich Identificador de fichero abierto para escribir. \note Esta función está paralelizada con OpenMP. \note La cabecera completa tiene el siguiente formato: iniCab númVert área xMín xMáx yMín yMáx. \note Si la estructura no tiene información de límites y/o áreas y se indica que se impriman, los valores se calculan internamente. \note Esta función asume que \em poli es una estructura \ref polig correctamente almacenada. \note Esta función no comprueba si la estructura pasada tiene memoria asignada. \note Esta función no comprueba internamente la validez de los argumentos de formato. \note Esta función no comprueba internamente si el identificador pasado corresponde a un fichero abierto para escribir. \date 18 de junio de 2011: Creación de la función. \note Esta función todavía no está probada. */ void ImprimeCabeceraPoligFichero(const polig* poli, const size_t indice, const char iniCab[], const int impLim, const char formCoor[], const int impArea, const char formArea[], const double factorX, const double factorY, const int repitePrimerPunto, FILE* idFich); /******************************************************************************/ /******************************************************************************/ /** \brief Imprime una estructura \ref polig en un fichero. \param[in] poli Estructura \ref polig. \param[in] factorX Factor para multiplicar las coordenadas X de los vértices antes de imprimirlas. \param[in] factorY Factor para multiplicar las coordenadas Y de los vértices antes de imprimirlas. \param[in] repitePrimerPunto Identificador para repetir o no el primer vértice del polígono al final del listado de coordenadas. Dos posibles valores: - 0: No se repite. - Distinto de 0: Sí se repite. \param[in] iniNan Identificador para imprimir o no la marca de separación de polígonos (\p NaN) delante del primer polígono. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] finNan Identificador para imprimir o no la marca de separación de polígonos (\p NaN) detrás del último polígono. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] formCoor Cadena de carácteres indicadora del formato de cada coordenada a imprimir. \param[in] impCabecera Identificador para imprimir o no una cabecera con información general por cada polígono. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] iniCab Cadena de texto con la que comenzará la cabecera. \param[in] impLim Identificador para imprimir o no en la cabecera los límites de coordenadas de los polígonos de trabajo. Dos posibles valores: - 0: No se imprimen. - Distinto de 0: Sí se imprimen. \param[in] impArea Identificador para imprimir o no en la cabecera la superficie de los polígonos de trabajo. Dos posibles valores: - 0: No se imprime. - Distinto de 0: Sí se imprime. \param[in] formArea Cadena de carácteres indicadora del formato para escribir el valor de la superficie. Este argumento sólo se usa internamente si se ha indicado la impresión de la superficie de los polígonos. \param[in] idFich Identificador de fichero abierto para escribir. \note La cabecera completa tiene el siguiente formato: iniCab númVert área xMín xMáx yMín yMáx. \note Si la estructura no tiene información de límites y/o áreas y se indica que se impriman, los valores se calculan internamente. \note Esta función asume que \em poli es una estructura \ref polig correctamente almacenada. \note Esta función no comprueba si la estructura pasada tiene memoria asignada. \note Esta función no comprueba internamente la validez de los argumentos de formato. \note Esta función no comprueba internamente si el identificador pasado corresponde a un fichero abierto para escribir. \date 26 de mayo de 2011: Creación de la función. \date 30 de mayo de 2011: Adición del argumento de entrada \em factor. \date 18 de junio de 2011: Adición de la capacidad de escritura de una cabecera y del uso de factores de escala independientes para las coordenadas X e Y. \date 22 de septiembre de 2011: Corregido bug que hacía que, dependiendo del compilador y/o los flags de optimización en la compilación, se imprimiesen mal (con un signo menos delante) los valores Not-a-Number. \note Esta función todavía no está probada. */ void ImprimePoligFichero(const polig* poli, const double factorX, const double factorY, const int repitePrimerPunto, const int iniNan, const int finNan, const char formCoor[], const int impCabecera, const char iniCab[], const int impLim, const int impArea, const char formArea[], FILE* idFich); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/ptopol.h000755 001750 001750 00000155056 12540021550 017053 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom gshhs @{ \file ptopol.h \brief Declaración de funciones para la realización de chequeos de inclusión de puntos en polígonos. En el momento de la compilación ha de seleccionarse el tipo de dato que se utilizará en los cálculos intermedios de las funciones \ref PtoEnPoligonoVerticeBorde y \ref PtoEnPoligonoVerticeBordeDouble. Si los puntos de trabajo están muy alejados de los polígonos pueden darse casos de resultados erróneos. Sería conveniente que los cálculos internedios se hiciesen en variables de 64 bits, pero el tipo long int suele ser de 4 bytes en procesadores de 32 bits. Para seleccionar este tipo como long long int, lo que en procesadores de 32 bits equivale a una variable de 64 bits, es necesario definir la variable para el preprocesador \em PTOPOL_BORDE_LONG_64. En procesadores de 64 bits no es necesario (aunque puede utilizarse), ya que el tipo long int tiene una longitud de 64 bits. Si no se define la variable, se usará un tipo long int para los cálculos intermedios. En \p gcc, las variables para el preprocesador se pasan como \em -DXXX, donde \em XXX es la variable a introducir. El uso del tipo long long int en procesadores de 32 bits puede hacer que las funciones se ejecuten hasta 10 veces más lentamente que si se utiliza el tipo long int. Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. \author José Luis García Pallero, jgpallero@gmail.com \note Este fichero contiene funciones paralelizadas con OpenMP. \date 05 de abril de 2010 \section Licencia Licencia Copyright (c) 2009-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _PTOPOL_H_ #define _PTOPOL_H_ /******************************************************************************/ /******************************************************************************/ #include #include #include"libgeoc/errores.h" #include"libgeoc/geocnan.h" #include"libgeoc/geocomp.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PTO_FUERA_POLIG \brief Identificador de punto fuera de un polígono. \date 12 de abril de 2011: Creación de la constante. */ #define GEOC_PTO_FUERA_POLIG 0 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PTO_DENTRO_POLIG \brief Identificador de punto dentro de un polígono. \date 12 de abril de 2011: Creación de la constante. */ #define GEOC_PTO_DENTRO_POLIG 1 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PTO_VERTICE_POLIG \brief Identificador de punto que es un vértice de un polígono. \date 12 de abril de 2011: Creación de la constante. */ #define GEOC_PTO_VERTICE_POLIG 2 /******************************************************************************/ /******************************************************************************/ /** \def GEOC_PTO_BORDE_POLIG \brief Identificador de punto que está en el borde de un polígono. \date 12 de abril de 2011: Creación de la constante. */ #define GEOC_PTO_BORDE_POLIG 3 /******************************************************************************/ /******************************************************************************/ /** \typedef ptopol_long \brief Nombre del tipo long int o long long int para utilizar en los cálculos intermedios de las funciones \ref PtoEnPoligonoVerticeBorde y \ref PtoEnPoligonoVerticeBordeDouble. Si los puntos de trabajo están muy alejados de los polígonos pueden darse casos de resultados erróneos. Sería conveniente que los cálculos internedios se hiciesen en variables de 64 bits, pero el tipo long int suele ser de 4 bytes en procesadores de 32 bits. Mediante la variable del preprocesador PTOPOL_BORDE_LONG_64 indicamos que este tipo sea long long int, lo que en procesadores de 32 bits equivale a una variable de 64 bits. \note Este tipo de dato sólo es para uso interno en el fichero \ref ptopol.c. No se recomienda su uso fuera de él, ya que habría que tener el cuenta la variable del preprocesador cada vez que se incluyera este fichero (\ref ptopol.h) en un programa u otro fichero. \date 19 de abril de 2011: Creación del tipo. */ #if defined(PTOPOL_BORDE_LONG_64) typedef long long int ptopol_long; #else typedef long int ptopol_long; #endif /******************************************************************************/ /******************************************************************************/ /** \brief Indica si hay alguna función compilada en paralelo con OpenMP en el fichero \ref ptopol.c. \return Dos posibles valores: - 0: No hay ninguna función compilada en paralelo con OpenMP. - Distinto de 0: Sí hay alguna función compilada en paralelo con OpenMP. \note Esta función asume que el argumento \em version tiene suficiente memoria asignada (si es distinto de \p NULL). \date 13 de abril de 2011: Creación de la función. \date 25 de agosto de 2011: Adición del argumento de entrada \em version. */ int GeocParOmpPtopol(char version[]); /******************************************************************************/ /******************************************************************************/ /** \brief Indica si se está utilizando el tipo log long int para la realización de cálculos intermedios en las funciones de chequeo de puntos en polígonos que son capaces de detectar si un punto está en el borde. \return Dos posibles valores: - 0: No se está utilizando log long int. - Distinto de 0: Sí se está utilizando log long int. \date 19 de abril de 2011: Creación de la función. */ int GeocLongLongIntPtopol(void); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en un rectángulo. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] xMin Coordenada X mínima del rectángulo. \param[in] xMax Coordenada X máxima del rectángulo. \param[in] yMin Coordenada Y mínima del rectángulo. \param[in] yMax Coordenada Y máxima del rectángulo. \return Varias posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera del rectángulo. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro del rectángulo. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice del rectángulo. - #GEOC_PTO_BORDE_POLIG: El punto pertenece a la frontera del rectángulo, pero no es un vértice. \note Esta función asume que \em xMinEsta función puede dar resultados incorrectos para puntos muy alejados de los polígonos de trabajo. Para intentar mitigar este efecto, puede seleccionarse mediante una variable del preprocesador la precisión de algunas variables intermedias. Para más información se recomienda leer el encabezado de este fichero. \note Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. \date 06 de abril de 2010: Creación de la función. \date 10 de abril de 2011: Adición de los argumentos de entrada \em incX e \em incY. \date 12 de abril de 2011: Las variables de salida son ahora constantes simbólicas. \date 18 de abril de 2011: Reescritura de la función, siguiendo la página 244 del libro de O'Rourke. La versión anterior la había adaptado del código de la web de O'Rourke, y lo había hecho mal. \todo Esta función no está probada. */ int PtoEnPoligonoVerticeBorde(const long x, const long y, const long* coorX, const long* coorY, const size_t N, const size_t incX, const size_t incY); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en un polígono de un número arbitrario de lados. Esta función trata correctamente los puntos situados en los bordes y/o los vértices del polígono. Trabaja con datos de tipo real, que convierte a enteros (por redondeo o truncamiento) intermamente, mediante la aplicación de un factor de escala. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] coorX Vector que contiene las coordenadas X de los vértices del polígono. Sólo puede contener un polígono. \param[in] coorY Vector que contiene las coordenadas Y de los vértices del polígono. Sólo puede contener un polígono. \param[in] N Número de elementos que contienen los vectores \em coorX y \em coorY. \param[in] incX Posiciones de separación entre los elementos del vector \em coorX. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em coorY. Este argumento siempre ha de ser un número positivo. \param[in] factor Factor de multiplicación para aplicar a las coordenadas del punto de trabajo y de los vértices del polígono, con el fin de aumentar su resolución antes de convertirlas en valores de tipo entero (\p long \p int). El uso de factores muy grandes puede provocar resultados erróneos. Ver la nota al final de la documentación de esta función. \param[in] redondeo Identificador de redondeo o truncamiento en la conversión interna de variables de tipo \p double en variables de tipo \p long \p int. Dos posibilidades: - 0: La conversión se hace por truncamiento. - Distinto de 0: La conversión se hace por redondeo. \return Varias posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera del polígono. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro del polígono. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice del polígono. - #GEOC_PTO_BORDE_POLIG: El punto pertenece a la frontera del polígono, pero no es un vértice. \note Esta función no comprueba si el número de elementos de los vectores \em coorX y \em coorY es congruente con los valores pasados en \em N, \em incX e \em incY. Tampoco comprueba si \em N es un valor mayor o igual a 3, que es el número mínimo de vértices que ha de tener un polígono. \note El polígono ha de ser único, sin huecos. Es opcional repetir las coordenadas del primer punto al final del listado. \note Los vértices del polígono pueden listarse en sentido dextrógiro o levógiro. \note El código de esta función es el mismo que el de la función \ref PtoEnPoligonoVerticeBorde, salvo que convierte internamente varias variables intermedias de tipo \p double a tipo \p long \p int, que es el tipo de datos necesario para detectar correctamente si un punto pertenece al borde de un polígono. \note Las variables se redondean internamente con la orden (long)(round(factor*variable)), y se truncan con la orden (long)(factor*variable). \note Esta función puede dar resultados incorrectos para puntos muy alejados de los polígonos de trabajo. Para intentar mitigar este efecto, puede seleccionarse mediante una variable del preprocesador la precisión de algunas variables intermedias. Para más información se recomienda leer el encabezado de este fichero. \note Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. En este caso nos referimos a las coordenadas una vez aplicado el factor de escala \em factor. \date 10 de abril de 2011: Creación de la función. \date 11 de abril de 2011: Adición del argumento de entrada \em redondeo. \date 12 de abril de 2011: Las variables de salida son ahora constantes simbólicas. \date 18 de abril de 2011: Reescritura de la función, siguiendo la página 244 del libro de O'Rourke. La versión anterior la había adaptado del código de la web de O'Rourke, y lo había hecho mal. \todo Esta función no está probada. */ int PtoEnPoligonoVerticeBordeDouble(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const double factor, const int redondeo); /******************************************************************************/ /******************************************************************************/ /** \brief Busca valores #GEOC_NAN es uno o dos vectores de datos. Esta función está pensada para el chequeo en paralelo de la inclusión de puntos en polígonos. \param[in] x Vector que contiene las coordenadas X de los vértices de una serie de polígonos, tal y como entraría en la definición de múltiples elementos (pero sin huecos) para la función \ref PtoEnPoligono. La marca de separación entre polígonos ha de ser #GEOC_NAN. \param[in] y Vector que contiene las coordenadas Y de los vértices de una serie de polígonos, tal y como entraría en la definición de múltiples elementos (pero sin huecos) para la función \ref PtoEnPoligono. La marca de separación entre polígonos ha de ser #GEOC_NAN. Este argumento puede valer NULL, en cuyo caso sólo se trabajará con el vector \em x. \param[in] N Número de elementos que contienen los vectores \em x e \em y. \param[in] incX Posiciones de separación entre los elementos del vector \em x. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em y. Este argumento siempre ha de ser un número positivo. \param[out] nNan Número de valores #GEOC_NAN encontrados, que es el número de elementos del vector de salida. \return Varias posibilidades: - Si todo ha ido bien, vector que contiene las posiciones en el vector o vectores originales donde se almacena el valor #GEOC_NAN. Si se trabaja con los vectores \em x e \em y, la posición sólo se extrae si ambos vectores contienen #GEOC_NAN para una misma posición. - NULL: Pueden haber ocurrido dos cosas: - Si \em nNan vale 0, en los datos de entrada no hay ningún valor #GEOC_NAN. - Si \em nNan es mayor que 0, ha ocurrido un error interno de asignación de memoria. \note Esta función no comprueba si el número de elementos de los vectores \em x e \em y es congruente con los valores pasados en \em N, \em incX e \em incY. \note Las posiciones de los elementos #GEOC_NAN encontradas se refieren al número de elementos \em N de los vectores de trabajo. Para encontrar la posición real en memoria es necesario tener en cuenta las variables \em incX e \em incY. \date 13 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ size_t* BuscaGeocNanEnVectores(const double* x, const double* y, const size_t N, const size_t incX, const size_t incY, size_t* nNan); /******************************************************************************/ /******************************************************************************/ /** \brief Extrae los parámetros de inicio y número de elementos de un polígono en una lista de polígonos separados por un indicador. Esta función está pensada para el chequeo en paralelo de la inclusión de puntos en polígonos. \param[in] posInd Vector que contiene las posiciones de los indicadores en el vector original. Este argumento es el vector que devuelve la función \ref BuscaGeocNanEnVectores. \param[in] indPosInd Índice en el vector de posiciones de indicadores del indicador que da comienzo al polígono de trabajo. \param[in] incX Posiciones de separación entre los elementos del vector original que almacena las coordenadas X del listado de polígonos. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector original que almacena las coordenadas Y del listado de polígonos. Este argumento siempre ha de ser un número positivo. \param[out] iniX Posición de inicio de la coordenada X del polígono de trabajo en el vector original que almacena las coordenadas X del listado de polígonos. Para encontrar la posición real en memoria es necesario tener en cuenta la variable \em incX. \param[out] iniY Posición de inicio de la coordenada Y del polígono de trabajo en el vector original que almacena las coordenadas Y del listado de polígonos. Para encontrar la posición real en memoria es necesario tener en cuenta la variable \em incY. \param[out] nElem Número de elementos que conforman el polígono de trabajo. \note Esta función no comprueba si el vector \em posInd contiene datos. \note Esta función asume que el vector \em posInd contiene un número \b *PAR* de datos. \note Esta función asume que el argumento \em indPosInd no es la última posición del vector \em posInd. \date 13 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ void DatosPoliIndividualEnVecInd(const size_t* posInd, const size_t indPosInd, const size_t incX, const size_t incY, size_t* iniX, size_t* iniY, size_t* nElem); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en una serie de polígonos individuales de un número arbitrario de lados. Esta función puede no dar resultados correctos para puntos en los bordes y/o los vértices del polígono. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] coorX Vector que contiene las coordenadas X de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] coorY Vector que contiene las coordenadas Y de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] N Número de elementos que contienen los vectores \em coorX y \em coorY. \param[in] incX Posiciones de separación entre los elementos del vector \em coorX. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em coorY. Este argumento siempre ha de ser un número positivo. \param[in] posNan Vector que almacena las posiciones en los vectores \em coorX y \em coorY de los elementos #GEOC_NAN, que separan los polígonos individuales. Este vector es la salida de la función \ref BuscaGeocNanEnVectores. \param[in] nNan Número de elementos del vector \em posNan. \param[out] poli Número del polígono en que está incluido el punto de trabajo. Si hay varios polígonos que contienen al punto de trabajo no se puede asegurar cuál de ellos será el indicado en este argumento. Este argumento sólo tiene sentido si el valor retornado por la función es distinto de #GEOC_PTO_FUERA_POLIG. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera de todos los polígonos listados. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro de, al menos, un polígono de entre los listados. \note Esta función se puede ejecutar en paralelo con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em coorX y \em coorY es congruente con los valores pasados en \em N, \em incX e \em incY. Tampoco comprueba si \em N es un valor mayor o igual a 3, que es el número mínimo de vértices que ha de tener un polígono. \note Esta función no comprueba si el número de elementos del vector \em posNan es congruente con el valor pasado en \em nNan. \note Esta función no detecta el caso de que el punto de trabajo esté en el borde o en un vértice del polígono. En este caso, el test puede dar el punto dentro o fuera, indistintamente (el chequeo del mismo punto con el mismo polígono siempre dará el mismo resultado). \note La estructura de los vectores de coordenadas es la misma que la de la función \ref PtoEnPoligono. Las marcas de comienzo y final de los listados, así como las de separación entre polígonos han de ser valores #GEOC_NAN. \note Aunque los vectores \em coorX y \em coorY sólo contengan un polígono, los elementos primero y último han de ser #GEOC_NAN. \note Los huecos en los polígonos no serán tenidos en cuenta, serán tratados como polígonos individuales. \date 14 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoligonoInd(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, size_t* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en una serie de polígonos individuales de un número arbitrario de lados. Esta función puede no dar resultados correctos para puntos en los bordes del polígono. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] coorX Vector que contiene las coordenadas X de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] coorY Vector que contiene las coordenadas Y de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] N Número de elementos que contienen los vectores \em coorX y \em coorY. \param[in] incX Posiciones de separación entre los elementos del vector \em coorX. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em coorY. Este argumento siempre ha de ser un número positivo. \param[in] posNan Vector que almacena las posiciones en los vectores \em coorX y \em coorY de los elementos #GEOC_NAN, que separan los polígonos individuales. Este vector es la salida de la función \ref BuscaGeocNanEnVectores. \param[in] nNan Número de elementos del vector \em posNan. \param[out] poli Número del polígono en que está incluido el punto de trabajo. Si hay varios polígonos que contienen al punto de trabajo no se puede asegurar cuál de ellos será el indicado en este argumento. Este argumento sólo tiene sentido si el valor retornado por la función es distinto de #GEOC_PTO_FUERA_POLIG. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera de todos los polígonos listados. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro de, al menos, un polígono de entre los listados. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice de, al menos, un polígono de entre los listados. \note Esta función se puede ejecutar en paralelo con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em coorX y \em coorY es congruente con los valores pasados en \em N, \em incX e \em incY. Tampoco comprueba si \em N es un valor mayor o igual a 3, que es el número mínimo de vértices que ha de tener un polígono. \note Esta función no comprueba si el número de elementos del vector \em posNan es congruente con el valor pasado en \em nNan. \note Esta función no detecta el caso de que el punto de trabajo esté en el borde del polígono. En este caso, el test puede dar el punto dentro o fuera, indistintamente (el chequeo del mismo punto con el mismo polígono siempre dará el mismo resultado). \note La estructura de los vectores de coordenadas es la misma que la de la función \ref PtoEnPoligono. Las marcas de comienzo y final de los listados, así como las de separación entre polígonos han de ser valores #GEOC_NAN. \note Aunque los vectores \em coorX y \em coorY sólo contengan un polígono, los elementos primero y último han de ser #GEOC_NAN. \note Los huecos en los polígonos no serán tenidos en cuenta, serán tratados como polígonos individuales. \date 14 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoligonoVerticeInd(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, size_t* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en una serie de polígonos individuales de un número arbitrario de lados. Esta función trata correctamente los puntos situados en los bordes y/o los vértices del polígono, pero sólo trabaja con datos de tipo entero. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] coorX Vector que contiene las coordenadas X de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] coorY Vector que contiene las coordenadas Y de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] N Número de elementos que contienen los vectores \em coorX y \em coorY. \param[in] incX Posiciones de separación entre los elementos del vector \em coorX. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em coorY. Este argumento siempre ha de ser un número positivo. \param[in] posNan Vector que almacena las posiciones en los vectores \em coorX y \em coorY de los elementos #GEOC_NAN, que separan los polígonos individuales. Este vector es la salida de la función \ref BuscaGeocNanEnVectores. \param[in] nNan Número de elementos del vector \em posNan. \param[out] poli Número del polígono en que está incluido el punto de trabajo. Si hay varios polígonos que contienen al punto de trabajo no se puede asegurar cuál de ellos será el indicado en este argumento. Este argumento sólo tiene sentido si el valor retornado por la función es distinto de #GEOC_PTO_FUERA_POLIG. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera de todos los polígonos listados. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro de, al menos, un polígono de entre los listados. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice de, al menos, un polígono de entre los listados. - #GEOC_PTO_BORDE_POLIG: El punto pertenece a la frontera de, al menos, un polígono de entre los listados, pero no es un vértice. \note Esta función se puede ejecutar en paralelo con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em coorX y \em coorY es congruente con los valores pasados en \em N, \em incX e \em incY. Tampoco comprueba si \em N es un valor mayor o igual a 3, que es el número mínimo de vértices que ha de tener un polígono. \note Esta función no comprueba si el número de elementos del vector \em posNan es congruente con el valor pasado en \em nNan. \note La estructura de los vectores de coordenadas es la misma que la de la función \ref PtoEnPoligono. Las marcas de comienzo y final de los listados, así como las de separación entre polígonos han de ser valores #GEOC_NAN. \note Aunque los vectores \em coorX y \em coorY sólo contengan un polígono, los elementos primero y último han de ser #GEOC_NAN. \note Los huecos en los polígonos no serán tenidos en cuenta, serán tratados como polígonos individuales. \note Esta función puede dar resultados incorrectos para puntos muy alejados de los polígonos de trabajo. Para intentar mitigar este efecto, puede seleccionarse mediante una variable del preprocesador la precisión de algunas variables intermedias. Para más información se recomienda leer el encabezado de este fichero. \note Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. \date 14 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoligonoVerticeBordeInd(const long x, const long y, const long* coorX, const long* coorY, const size_t N, const size_t incX, const size_t incY, const size_t* posNan, const size_t nNan, size_t* poli); /******************************************************************************/ /******************************************************************************/ /** \brief Comprueba si un punto está contenido en una serie de polígonos individuales de un número arbitrario de lados. Esta función trata correctamente los puntos situados en los bordes y/o los vértices del polígono. Trabaja con datos de tipo real, que convierte a enteros (por redondeo o truncamiento) intermamente, mediante a aplicación de un factor de escala. \param[in] x Coordenada X del punto de trabajo. \param[in] y Coordenada Y del punto de trabajo. \param[in] coorX Vector que contiene las coordenadas X de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] coorY Vector que contiene las coordenadas Y de los vértices de los elementos. Puede contener varios polígonos, pero no huecos (si los hay, serán tratados como otros polígonos). \param[in] N Número de elementos que contienen los vectores \em coorX y \em coorY. \param[in] incX Posiciones de separación entre los elementos del vector \em coorX. Este argumento siempre ha de ser un número positivo. \param[in] incY Posiciones de separación entre los elementos del vector \em coorY. Este argumento siempre ha de ser un número positivo. \param[in] factor Factor de multiplicación para aplicar a las coordenadas del punto de trabajo y de los vértices de los polígonos, con el fin de aumentar su resolución antes de convertirlas en valores de tipo entero (\p long \p int). El uso de factores muy grandes puede provocar resultados erróneos. Ver la nota al final de la documentación de esta función. \param[in] redondeo Identificador de redondeo o truncamiento en la conversión interna de variables de tipo \p double en variables de tipo \p long \p int. Dos posibilidades: - 0: La conversión se hace por truncamiento. - Distinto de 0: La conversión se hace por redondeo. \param[in] posNan Vector que almacena las posiciones en los vectores \em coorX y \em coorY de los elementos #GEOC_NAN, que separan los polígonos individuales. Este vector es la salida de la función \ref BuscaGeocNanEnVectores. \param[in] nNan Número de elementos del vector \em posNan. \param[out] poli Número del polígono en que está incluido el punto de trabajo. Si hay varios polígonos que contienen al punto de trabajo no se puede asegurar cuál de ellos será el indicado en este argumento. Este argumento sólo tiene sentido si el valor retornado por la función es distinto de #GEOC_PTO_FUERA_POLIG. \return Dos posibilidades: - #GEOC_PTO_FUERA_POLIG: El punto está fuera de todos los polígonos listados. - #GEOC_PTO_DENTRO_POLIG: El punto está dentro de, al menos, un polígono de entre los listados. - #GEOC_PTO_VERTICE_POLIG: El punto es un vértice de, al menos, un polígono de entre los listados. - #GEOC_PTO_BORDE_POLIG: El punto pertenece a la frontera de, al menos, un polígono de entre los listados, pero no es un vértice. \note Esta función se puede ejecutar en paralelo con OpenMP. \note Esta función no comprueba si el número de elementos de los vectores \em coorX y \em coorY es congruente con los valores pasados en \em N, \em incX e \em incY. Tampoco comprueba si \em N es un valor mayor o igual a 3, que es el número mínimo de vértices que ha de tener un polígono. \note Esta función no comprueba si el número de elementos del vector \em posNan es congruente con el valor pasado en \em nNan. \note Las variables se redondean internamente con la orden (long)(round(factor*variable)), y se truncan con la orden (long)(factor*variable). \note La estructura de los vectores de coordenadas es la misma que la de la función \ref PtoEnPoligono. Las marcas de comienzo y final de los listados, así como las de separación entre polígonos han de ser valores #GEOC_NAN. \note Aunque los vectores \em coorX y \em coorY sólo contengan un polígono, los elementos primero y último han de ser #GEOC_NAN. \note Los huecos en los polígonos no serán tenidos en cuenta, serán tratados como polígonos individuales. \note Esta función puede dar resultados incorrectos para puntos muy alejados de los polígonos de trabajo. Para intentar mitigar este efecto, puede seleccionarse mediante una variable del preprocesador la precisión de algunas variables intermedias. Para más información se recomienda leer el encabezado de este fichero. \note Con cálculos internos de 32 bits las coordenadas de los vértices del polígono no han de estar más lejos de las de los puntos de trabajo de unas 40000 unidades. Con cálculos de 64 bits, los polígonos pueden estar alejados de los puntos de trabajo unas 3000000000 unidades, lo que corresponde a coordenadas Y UTM ajustadas al centímetro. Con esto podríamos chequear un punto en un polo con respecto a un polígono en el ecuador en coordenadas UTM expresadas en centímetros. En este caso nos referimos a las coordenadas una vez aplicado el factor de escala \em factor. \date 14 de abril de 2011: Creación de la función. \todo Esta función no está probada. */ int PtoEnPoligonoVerticeBordeDoubleInd(const double x, const double y, const double* coorX, const double* coorY, const size_t N, const size_t incX, const size_t incY, const double factor, const int redondeo, const size_t* posNan, const size_t nNan, size_t* poli); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/libgeoc/calctopo.h000644 001750 001750 00000010050 12540021550 017317 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geodesia geom @{ \file calctopo.h \brief Declaración de funciones para cálculos de topografía. \author José Luis García Pallero, jgpallero@gmail.com \date 05 de julio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #ifndef _CALCTOPO_H_ #define _CALCTOPO_H_ /******************************************************************************/ /******************************************************************************/ #include #include"libgeoc/constantes.h" /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus extern "C" { #endif /******************************************************************************/ /******************************************************************************/ /** \brief Calcula el acimut topográfico entre dos puntos. \param[in] x1 Coordenada X del primer punto. \param[in] y1 Coordenada y del primer punto. \param[in] x2 Coordenada X del segundo punto. \param[in] y2 Coordenada y del segundo punto. \return Acimut del primer al segundo punto, en radianes. \date 05 de julio de 2011: Creación de la función. \todo Esta función todavía no ha sido probada. */ double AcimutTopografico(const double x1, const double y1, const double x2, const double y2); /******************************************************************************/ /******************************************************************************/ #ifdef __cplusplus } #endif /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/geocnan.c000755 001750 001750 00000020452 12540021550 015526 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geocnan geom matriz gshhs @{ \file geocnan.c \brief Definición de funciones para el trabajo con constantes Not-a-Number. \author José Luis García Pallero, jgpallero@gmail.com \date 26 de mayo de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2010-2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/geocnan.h" /******************************************************************************/ /******************************************************************************/ double GeocNan(void) { //devolvemos el valor de NaN //le calculamos el valor absoluto porque, en algunos sistemas, al imprimir //un valor GEOC_NAN normal, éste sale con un signo negativo delante //aclaración a 22 de septiembre de 2011: parecía que con lo del fabs() //estaba solucionado el asunto del signo negativo, pero no es así //la impresión con signo negativo parece que depende de los flags de //optimización al compilar y de los propios compiladores //no obstante, se mantiene el fabs() return fabs(GEOC_NAN); } /******************************************************************************/ /******************************************************************************/ int EsGeocNan(const double valor) { //comparamos y salimos de la función return valor!=valor; } /******************************************************************************/ /******************************************************************************/ size_t* PosGeocNanEnVector(const double* datos, const size_t nDatos, const size_t incDatos, size_t* nNan) { //índice para recorrer bucles size_t i=0; //vector de salida size_t* salida=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos a 0 el número de NaN encontrados *nNan = 0; //comprobamos una posible salida rápida if(nDatos==0) { //salimos de la función return salida; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los elementos de los vectores for(i=0;ianterior = anterior; nuevoVert->siguiente = siguiente; //si anterior es un vértice bueno if(anterior!=NULL) { //lo apuntamos al vértice creado nuevoVert->anterior->siguiente = nuevoVert; } //si siguiente es un vértice bueno if(siguiente!=NULL) { //indicamos que el vértice creado es el anterior nuevoVert->siguiente->anterior = nuevoVert; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el resto de campos nuevoVert->x = x; nuevoVert->y = y; nuevoVert->orig = orig; nuevoVert->pos = pos; nuevoVert->alfa = alfa; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return nuevoVert; } /******************************************************************************/ /******************************************************************************/ vertPolilClip* CreaPolilClip(const double* x, const double* y, const size_t nCoor, const size_t incX, const size_t incY) { //índice para recorrer bucles size_t i=0; //variable auxiliar de posición size_t posIni=0; //otra variable auxiliar int hayVert=0; //estructura auxiliar vertPolilClip* aux=NULL; //variable de salida vertPolilClip* poli=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //buscamos el primer punto que sea distinto de NaN for(i=0;isiguiente; //liberamos la memoria free(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ vertPolilClip* ReiniciaPolilClip(vertPolilClip* poli) { //estructura que apunta al espacio en memoria a liberar vertPolilClip* borra=NULL; //estructura auxiliar vertPolilClip* aux=NULL; //estructura de salida vertPolilClip* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar aux = poli; //comprobamos una posible salida rápida if(aux==NULL) { //salimos de la función return NULL; } //buscamos para la estructura de salida el primer vértice original while(aux!=NULL) { //comprobamos si estamos ante un vértice bueno if(aux->orig) { //asignamos la variable de salida sal = aux; //salimos del bucle break; } //siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //volvemos a inicializar la variable auxiliar aux = poli; //mientras la variable de trabajo no apunte a NULL while(aux!=NULL) { //comprobamos si estamos ante un vértice a borrar if(aux->orig==0) { //lo almacenamos en la estructura de borrado borra = aux; //actualizamos el puntero de vértice siguiente if(aux->anterior!=NULL) { //cuando el vértice a borrar no es el primero de la lista aux->anterior->siguiente = aux->siguiente; } else if(aux->siguiente!=NULL) { //cuando el vértice a borrar es el primero de la lista aux->siguiente->anterior = NULL; } //actualizamos el puntero de vértice anterior if(aux->siguiente!=NULL) { //cuando el vértice a borrar no es el último de la lista aux->siguiente->anterior = aux->anterior; } else if(aux->anterior!=NULL) { //cuando el vértice a borrar es el último de la lista aux->anterior->siguiente = NULL; } //apuntamos al siguiente elemento aux = aux->siguiente; //liberamos la memoria free(borra); } else { //reinicializamos el resto de miembros, menos las coordenadas //originales y el identificador de vértice original aux->pos = GEOC_PTO_FUERA_POLIG; aux->alfa = 0.0; //siguiente elemento aux = aux->siguiente; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ vertPolilClip* SiguienteVertOrigPolilClip(vertPolilClip* vert) { //variable de salida, que inicializamos con la dirección de entrada vertPolilClip* sal=vert; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //si estamos ante un vértice original, pasamos al siguiente if((sal!=NULL)&&sal->orig) { //apuntamos al siguiente vértice sal = sal->siguiente; } //vamos rechazando vérties no originales (el bucle se para cuando llegamos //al final o a un vértice que no es original) while((sal!=NULL)&&(sal->orig==0)) { //pasamos al siguiente vértice sal = sal->siguiente; } //si hemos llegado a un vértice que no es original, apuntamos a NULL if((sal!=NULL)&&(sal->orig==0)) { //asignamos NULL sal = NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ /******************************************************************************/ void InsertaVertPolilClip(vertPolilClip* ins, vertPolilClip* extremoIni, vertPolilClip* extremoFin) { //estructura auxiliar vertPolilClip* aux=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el vértice auxiliar como el extremo inicial pasado aux = extremoIni; //mientras no lleguemos al extremo final y el punto a insertar esté más //lejos del origen que el punto de trabajo while((aux!=extremoFin)&&((aux->alfa)<=(ins->alfa))) { //avanzamos al siguiente vértice aux = aux->siguiente; } //insertamos el punto y ordenamos los punteros de vértices anterior y //posterior ins->siguiente = aux; ins->anterior = aux->anterior; ins->anterior->siguiente = ins; ins->siguiente->anterior = ins; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ size_t NumeroVertOrigPolilClip(vertPolilClip* poli) { //estructura auxiliar vertPolilClip* aux=NULL; //variable de salida size_t num=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //comprobamos si estamos ante un vértice original if(aux->orig) { //si no es un vértice original, nos posicionamos en el siguiente que sí //lo sea aux = SiguienteVertOrigPolilClip(aux); } //mientras no lleguemos al final while(aux!=NULL) { //aumentamos el contador de vértices originales num++; //nos posicionamos en el siguiente vértice original aux = SiguienteVertOrigPolilClip(aux); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return num; } /******************************************************************************/ /******************************************************************************/ size_t NumeroVertPolilClip(vertPolilClip* poli) { //estructura auxiliar vertPolilClip* aux=NULL; //variable de salida size_t num=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //mientras no lleguemos al final while(aux!=NULL) { //aumentamos el contador de vértices num++; //nos posicionamos en el siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return num; } /******************************************************************************/ /******************************************************************************/ int Paso1Recpolil(vertPolilClip* poli, vertPoliClip* poliRec, size_t* nIntersec) { //estructuras auxiliares que apuntan a los elementos pasados vertPolilClip* auxA=NULL; vertPoliClip* auxC=NULL; //estructuras auxiliares para trabajar con el siguiente vértice vertPolilClip* auxB=NULL; vertPoliClip* auxD=NULL; //vértices de intersección a insertar vertPolilClip* insPolil=NULL; //coordenadas de la intersección de dos segmentos double xI=0.0,yI=0.0; //longitud de segmento y parámetro alfa double lon=0.0,alfa=0.0; //código de intersección de segmentos int intersec=0; //variable auxiliar int nuevoPunto=0; //variable de salida int salida=GEOC_ERR_NO_ERROR; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el número de intersecciones a 0 *nIntersec = 0; //EL PRIMER PASO DEL ALGORITMO DE RECORTE DE POLILÍNEAS ES EL CÁLCULO DE //TODOS LOS PUNTOS DE INTERSECCIÓN ENTRE LOS POLÍGONOS //recorremos los vértices de la polilínea for(auxA=poli;auxA->siguiente!=NULL;auxA=auxA->siguiente) { //sólo trabajamos si el vértice es original if(auxA->orig) { //recorremos los vértices del polígono de recorte for(auxC=poliRec;auxC->siguiente!=NULL;auxC=auxC->siguiente) { //sólo trabajamos si el vértice es original (esto hace que //podamos trabajar con un polígono proveniente de una operación //booleana previa entre polígonos if(auxC->interseccion==0) { //siguiente vértice de los segmentos auxB = SiguienteVertOrigPolilClip(auxA); auxD = SiguienteVertOrigPoliClip(auxC); //calculamos la intersección de los segmentos intersec = IntersecSegmentos2D(auxA->x,auxA->y,auxB->x, auxB->y,auxC->x,auxC->y, auxD->x,auxD->y,&xI,&yI); //comprobamos la posición relativa del primer punto del //segmento de la polilínea con respecto al polígono //esta función sólo marca dentro o fuera auxA->pos = (char)PtoEnPoliClip(auxA->x,auxA->y,poliRec); //comprobamos si el segmento de la polilínea contiene al //último punto de ésta, por lo que el bucle se acabará aquí if(auxB->siguiente==NULL) { //comprobamos la posición relativa del último punto auxB->pos = (char)PtoEnPoliClip(auxB->x,auxB->y, poliRec); } //comprobamos si hay que aumentar el contador de //intersecciones if(intersec!=GEOC_SEG_NO_INTERSEC) { //aumentamos el contador de intersecciones (*nIntersec)++; } //comprobamos el tipo de intersección if(intersec==GEOC_SEG_INTERSEC) { //INTERSECCIÓN LIMPIA //calculamos la longitud del segmento de la polilínea lon = Dist2D(auxA->x,auxA->y,auxB->x,auxB->y); //calculamos los parámetros alfa alfa = Dist2D(auxA->x,auxA->y,xI,yI)/lon; //creamos el nuevo vértice a insertar insPolil = CreaVertPolilClip(xI,yI,NULL,NULL,0, (char)GEOC_PTO_BORDE_POLIG, alfa); //comprobamos los posibles errores if(insPolil==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //añadimos el punto de intersección InsertaVertPolilClip(insPolil,auxA,auxB); } else if(intersec==GEOC_SEG_INTERSEC_EXTREMO_NO_COLIN) { //EL EXTREMO DE UN SEGMENTO TOCA AL OTRO SEGMENTO, PERO //LOS SEGMENTOS NO SON COLINEALES //comprobamos si el extremo que toca es el inicial del //segmento de la polilínea if((xI==auxA->x)&&(yI==auxA->y)) { //el primer punto del segmento está en el borde auxA->pos = (char)GEOC_PTO_BORDE_POLIG; } else if((xI!=auxB->x)||(yI!=auxB->y)) { //el extremo que toca es del segmento del polígono y //no toca al punto final del segmento de la //polilínea //calculamos la longitud del segmento de la //polilínea lon = Dist2D(auxA->x,auxA->y,auxB->x,auxB->y); //calculamos los parámetros alfa alfa = Dist2D(auxA->x,auxA->y,xI,yI)/lon; //creamos el nuevo vértice a insertar insPolil = CreaVertPolilClip(xI,yI,NULL,NULL,0, (char)GEOC_PTO_BORDE_POLIG, alfa); //comprobamos los posibles errores if(insPolil==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //añadimos el punto de intersección InsertaVertPolilClip(insPolil,auxA,auxB); } else { //comprobamos si estamos ante el segmento que //contiene al último punto de la polilínea if(auxB->siguiente==NULL) { //el último punto del segmento está en el borde auxB->pos = (char)GEOC_PTO_BORDE_POLIG; } else { //disminuimos el contador de intersecciones, ya //que esta se detectará en la siguiente vuelta //del bucle (*nIntersec)--; } } } else if(intersec==GEOC_SEG_INTERSEC_EXTREMO_COLIN) { //LOS SEGMENTOS SON COLINEALES PERO SÓLO SE TOCAN EN EL //EXTREMO //comprobamos si el extremo que toca es el primero if((xI==auxA->x)&&(yI==auxA->y)) { //el primer punto del segmento está en el borde auxA->pos = (char)GEOC_PTO_BORDE_POLIG; } else { //comprobamos si estamos ante el segmento que //contiene al último punto de la polilínea if(auxB->siguiente==NULL) { //el último punto del segmento está en el borde auxB->pos = (char)GEOC_PTO_BORDE_POLIG; } else { //disminuimos el contador de intersecciones, ya //que esta se detectará en la siguiente vuelta //del bucle (*nIntersec)--; } } } else if(intersec==GEOC_SEG_INTERSEC_MISMO_SEG) { //AMBOS SEGMENTOS SON EL MISMO //el primer punto del segmento está en el borde auxA->pos = (char)GEOC_PTO_BORDE_POLIG; //comprobamos si estamos ante el segmento que contiene //al último punto de la polilínea if(auxB->siguiente==NULL) { //aumentamos el contador de intersecciones (*nIntersec)++; //el último punto del segmento está en el borde auxB->pos = (char)GEOC_PTO_BORDE_POLIG; } } else if(intersec==GEOC_SEG_INTERSEC_COLIN) { //LOS SEGMENTOS TIENEN MÁS DE UN PUNTO EN COMÚN, PERO NO //SON EL MISMO //comprobamos si el extremo inicial está tocando el //polígono o no if((xI==auxA->x)&&(yI==auxA->y)) { //el primer punto del segmento está en el borde auxA->pos = (char)GEOC_PTO_BORDE_POLIG; //identificador de nuevo punto nuevoPunto = 0; //comprobamos si alguno de los extremos del segmento //del polígono está dentro del segmento de la //polilínea if(PuntoEntreDosPuntos2DColin(auxC->x,auxC->y, auxA->x,auxA->y, auxB->x,auxB->y)) { //nuevo punto nuevoPunto = 1; //coordenadas del punto intersección xI = auxC->x; yI = auxC->y; } else if(PuntoEntreDosPuntos2DColin(auxD->x,auxD->y, auxA->x,auxA->y, auxB->x,auxB->y)) { //nuevo punto nuevoPunto = 1; //coordenadas del punto intersección xI = auxD->x; yI = auxD->y; } //comprobamos si hay que añadir el nuevo punto if(nuevoPunto) { //aumentamos el contador de intersecciones (*nIntersec)++; //calculamos la longitud del segmento de la //polilínea lon = Dist2D(auxA->x,auxA->y,auxB->x,auxB->y); //calculamos los parámetros alfa alfa = Dist2D(auxA->x,auxA->y,xI,yI)/lon; //creamos el nuevo vértice a insertar insPolil = CreaVertPolilClip(xI,yI,NULL,NULL,0, (char)GEOC_PTO_BORDE_POLIG, alfa); //comprobamos los posibles errores if(insPolil==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //añadimos el punto de intersección InsertaVertPolilClip(insPolil,auxA,auxB); } //comprobamos si estamos ante el segmento que //contiene al último punto de la polilínea if(auxB->siguiente==NULL) { //comprobamos si el último punto del segmento //de la polilínea está contenido en el segmento //del polígono if(PuntoEntreDosPuntos2DColin(auxB->x,auxB->y, auxC->x,auxC->y, auxD->x,auxD->y)) { //aumentamos el contador de intersecciones (*nIntersec)++; //indicamos que el último punto del segmento //de la polilínea está en el borde auxB->pos = (char)GEOC_PTO_BORDE_POLIG; } } } else { //comprobamos si el vértice a añadir es el extremo //final del segmento del polígono (la función //devuelve las coordenadas del extremo final del //segmento de la polilínea if((xI==auxB->x)&&(yI==auxB->y)) { //asignamos las coordenadas de salida correctas xI = auxD->x; yI = auxD->y; } //calculamos la longitud del segmento de la //polilínea lon = Dist2D(auxA->x,auxA->y,auxB->x,auxB->y); //calculamos los parámetros alfa alfa = Dist2D(auxA->x,auxA->y,xI,yI)/lon; //creamos el nuevo vértice a insertar insPolil = CreaVertPolilClip(xI,yI,NULL,NULL,0, (char)GEOC_PTO_BORDE_POLIG, alfa); //comprobamos los posibles errores if(insPolil==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return GEOC_ERR_ASIG_MEMORIA; } //añadimos el punto de intersección InsertaVertPolilClip(insPolil,auxA,auxB); //comprobamos si estamos ante el segmento que //contiene al último punto de la polilínea if(auxB->siguiente==NULL) { //aumentamos el contador de intersecciones (*nIntersec)++; //indicamos que el último punto del segmento de //la polilínea está en el borde auxB->pos = (char)GEOC_PTO_BORDE_POLIG; } } } } } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ polil* Paso2Recpolil(vertPolilClip* poli, const enum GEOC_OP_BOOL_POLIL op) { //estructura auxiliar vertPolilClip* aux=NULL; //vectores de coordenadas de los vértices del resultado double* x=NULL; double* y=NULL; //número de elementos de los vectores x e y size_t nPtos=0; //número de elementos para los que ha sido asignada memoria size_t nElem=0; //variable de estado int estado=GEOC_ERR_NO_ERROR; //polilínea de salida polil* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //chequeamos una posible salida rápida porque la polilínea sea NULL if(poli==NULL) { //creamos la estructura vacía resultado = IniciaPolilVacia(); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //salimos de la función return resultado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la estructura auxiliar con la dirección de entrada aux = poli; //distinguimos entre las dos operaciones //por defecto, recorte if(op!=GeocOpBoolFuera) { //vamos recorriendo vértices de la polilínea do { //comprobamos si el vértice es del borde o de dentro del polígono if(aux->pos==GEOC_PTO_DENTRO_POLIG) { //un punto de dentro del polígono siempre pertenece a la //polilínea recortada //no hace falta asignar los elementos NaN de separación de //polilíneas, que ya se añaden cuando de trabaja con un punto de //borde //aumentamos el número de elementos almacenados en los vectores //de coordenadas nPtos++; //comprobamos si hay que reasignar memoria if(nPtos>nElem) { //aumentamos el número de elementos nElem += GEOC_RECPOLIL_BUFFER_PTOS; //reasignamos memoria x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos los posibles errores if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos las coordenadas del vértice x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } else if(aux->pos==GEOC_PTO_BORDE_POLIG) { //comprobamos la situación de los vértices anterior y siguiente //para la posible reasignación de memoria if((aux->anterior==NULL)||(aux->siguiente==NULL)|| (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)|| (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //este es un vértice de comienzo o fin de una polilínea, por //lo que necesitamos memoria para las coordenadas y el //marcador NaN nPtos += 2; } else { //este vértice pertenece al interior del polígono nPtos++; } //comprobamos si hay que reasignar memoria if(nPtos>nElem) { //aumentamos el número de elementos nElem += GEOC_RECPOLIL_BUFFER_PTOS; //reasignamos memoria x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos los posibles errores if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //comprobamos de nuevo la situación de los vértices anterior y //posterior if((aux->anterior==NULL)|| (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)) { //el vértice es inicio de polilínea //asignamos los valores NaN de separación x[nPtos-2] = GeocNan(); y[nPtos-2] = GeocNan(); //asignamos las coordenadas del vértice x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } else if((aux->siguiente==NULL)|| (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //el vértice es final de polilínea //asignamos las coordenadas del vértice x[nPtos-2] = aux->x; y[nPtos-2] = aux->y; //asignamos los valores NaN de separación x[nPtos-1] = GeocNan(); y[nPtos-1] = GeocNan(); } else { //el vértice pertenece a la polilínea recortada x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } } //avanzamos al siguiente vértice aux = aux->siguiente; }while(aux!=NULL); } else { //vamos recorriendo vértices de la polilínea do { //comprobamos si el vértice es del borde o de fuera del polígono if(aux->pos==GEOC_PTO_FUERA_POLIG) { //un punto de fuera del polígono siempre pertenece a la //polilínea exterior //no hace falta asignar los elementos NaN de separación de //polilíneas, que ya se añaden cuando de trabaja con un punto de //borde //aumentamos el número de elementos almacenados en los vectores //de coordenadas nPtos++; //comprobamos si hay que reasignar memoria if(nPtos>nElem) { //aumentamos el número de elementos nElem += GEOC_RECPOLIL_BUFFER_PTOS; //reasignamos memoria x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos los posibles errores if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos las coordenadas del vértice x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } else if(aux->pos==GEOC_PTO_BORDE_POLIG) { //comprobamos la situación de los vértices anterior y siguiente //para la posible reasignación de memoria if((aux->anterior!=NULL)&&(aux->siguiente!=NULL)&& (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)&& (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //este vértice pertenece al exterior del polígono nPtos++; } else if(((aux->anterior==NULL)|| (aux->anterior->pos!=GEOC_PTO_FUERA_POLIG))&& (aux->siguiente!=NULL)&& (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //este es un vértice de comienzo de una polilínea, por lo //que necesitamos memoria para las coordenadas y el marcador //NaN nPtos += 2; } else if(((aux->siguiente==NULL)|| (aux->siguiente->pos!=GEOC_PTO_FUERA_POLIG))&& (aux->anterior!=NULL)&& (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)) { //este es un vértice de fin de una polilínea, por lo que //necesitamos memoria para las coordenadas y el marcador NaN nPtos += 2; } //comprobamos si hay que reasignar memoria if(nPtos>nElem) { //aumentamos el número de elementos nElem += GEOC_RECPOLIL_BUFFER_PTOS; //reasignamos memoria x = (double*)realloc(x,nElem*sizeof(double)); y = (double*)realloc(y,nElem*sizeof(double)); //comprobamos los posibles errores if((x==NULL)||(y==NULL)) { //liberamos la posible memoria asignada free(x); free(y); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //comprobamos de nuevo la situación de los vértices anterior y //posterior if((aux->anterior!=NULL)&&(aux->siguiente!=NULL)&& (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)&& (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //el vértice pertenece a la polilínea recortada x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } else if(((aux->anterior==NULL)|| (aux->anterior->pos!=GEOC_PTO_FUERA_POLIG))&& (aux->siguiente!=NULL)&& (aux->siguiente->pos==GEOC_PTO_FUERA_POLIG)) { //el vértice es inicio de polilínea //asignamos los valores NaN de separación x[nPtos-2] = GeocNan(); y[nPtos-2] = GeocNan(); //asignamos las coordenadas del vértice x[nPtos-1] = aux->x; y[nPtos-1] = aux->y; } else if(((aux->siguiente==NULL)|| (aux->siguiente->pos!=GEOC_PTO_FUERA_POLIG))&& (aux->anterior!=NULL)&& (aux->anterior->pos==GEOC_PTO_FUERA_POLIG)) { //el vértice es final de polilínea //asignamos las coordenadas del vértice x[nPtos-2] = aux->x; y[nPtos-2] = aux->y; //asignamos los valores NaN de separación x[nPtos-1] = GeocNan(); y[nPtos-1] = GeocNan(); } } //avanzamos al siguiente vértice aux = aux->siguiente; }while(aux!=NULL); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la estructura de salida resultado = CreaPolil(x,y,nPtos,1,1,&estado); //comprobamos los posibles errores if(resultado==NULL) { //liberamos la memoria asignada free(x); free(y); //comprobamos el error if(estado==GEOC_ERR_ASIG_MEMORIA) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); } else { //mensaje de error GEOC_ERROR("Error en la llamada a 'CreaPolil()'\nEste error no " "puede producirse aquí porque los NaN deben estar " "bien puestos"); } //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //liberamos la memoria utilizada free(x); free(y); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polil* RecortaPolil(vertPolilClip* poli, vertPoliClip* poliRec, const enum GEOC_OP_BOOL_POLIL op, size_t* nIntersec) { //identificador de error int idError=GEOC_ERR_NO_ERROR; //polilínea de salida de salida polil* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //PRIMER PASO DEL ALGORITMO: CÁLCULO DE TODOS LOS PUNTOS DE INTERSECCIÓN //ENTRE LA POLILÍNEA Y EL POLÍGONO //calculamos los puntos de intersección idError = Paso1Recpolil(poli,poliRec,nIntersec); //comprobamos los posibles errores if(idError==GEOC_ERR_ASIG_MEMORIA) { //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso1Recpolil'"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si no hay intersecciones if(!(*nIntersec)) { //comprobamos las posibles situaciones relativas entre la polilínea y el //polígono que pueden producir cero intersecciones if(PtoEnPoliClip(poli->x,poli->y,poliRec)==GEOC_PTO_FUERA_POLIG) { //LA POLILÍNEA ESTÁ FUERA DEL POLÍGONO DE RECORTE //distinguimos las operaciones (por defecto, dentro) if(op!=GeocOpBoolFuera) { //el resultado es una polilínea vacía resultado = CreaPolilPolilClip(NULL); } else { //el resultado es la polilínea original resultado = CreaPolilPolilClip(poli); } } else { //LA POLILÍNEA ESTÁ DENTRO DEL POLÍGONO DE RECORTE //distinguimos las operaciones (por defecto, dentro) if(op!=GeocOpBoolFuera) { //el resultado es la polilínea original resultado = CreaPolilPolilClip(poli); } else { //el resultado es una polilínea vacía resultado = CreaPolilPolilClip(NULL); } } //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //salimos de la función return resultado; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //realizamos la operación si hay alguna intersección resultado = Paso2Recpolil(poli,op); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria en la llamada a " "'Paso2Recpolil'"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polil* RecortaPolilMult(const polil* poli, const polig* poliRec, const enum GEOC_OP_BOOL_POLIL op, size_t* nIntersec) { //índices para recorrer bucles size_t i=0,j=0; //variable de posición size_t pos=0; //posición de un rectángulo con respecto a otro int pr=0; //número de intersecciones auxiliar size_t nInt=0; //variable de error int estado=GEOC_ERR_NO_ERROR; //listas de trabajo vertPolilClip* polilClip=NULL; vertPoliClip* poligClip=NULL; //polilínea auxiliar polil* polilAux=NULL; //variable de salida polil* resultado=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el número total de intersecciones *nIntersec = 0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos la variable de salida resultado = IniciaPolilVacia(); //comprobamos los posibles errores if(resultado==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos las polilíneas a recortar for(i=0;inPolil;i++) { //dirección de inicio de los vértices de la polilínea pos = poli->posIni[i]; //creamos la polilínea a recortar de trabajo polilClip = CreaPolilClip(&(poli->x[pos]),&(poli->y[pos]), poli->nVert[i],1,1); //comprobamos los posibles errores if(polilClip==NULL) { //liberamos la memoria asignada hasta ahora LibMemPolil(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //recorremos los polígonos de recorte for(j=0;jnPolig;j++) { //comprobamos si la polilínea y el polígono tienen definidos sus //límites if((poli->hayLim)&&(poliRec->hayLim)) { //comprobamos si los restángulos que encierran a la polilínea y //al polígono son disjuntos o no pr = RectDisjuntos(poli->xMin[i],poli->xMax[i],poli->yMin[i], poli->yMax[i], poliRec->xMin[j],poliRec->xMax[j], poliRec->yMin[j],poliRec->yMax[j]); //comprobamos los casos particulares si los rectángulos son //disjuntos if(pr&&(op==GeocOpBoolDentro)) { //si buscamos la parte de la polilínea que cae dentro del //polígono, no se añade nada //vamos a la siguiente vuelta del bucle continue; } else if(pr&&(op==GeocOpBoolFuera)) { //si buscamos la parte de la polilínea que cae fuera del //polígono, se añade la polilínea entera estado = AnyadeDatosPolil(resultado,&(poli->x[pos]), &(poli->y[pos]),poli->nVert[i],1, 1); //comprobamos los posibles errores, que sólo pueden ser de //asignación de memoria if(estado!=GEOC_ERR_NO_ERROR) { //liberamos la posible memoria asignada hasta ahora LibMemPolilClip(polilClip); LibMemPolil(resultado); //lanzamos el mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //vamos a la siguiente vuelta del bucle continue; } } //dirección de inicio de los vértices del polígono de recorte pos = poliRec->posIni[j]; //creamos el polígono de recorte de trabajo poligClip = CreaPoliClip(&(poliRec->x[pos]),&(poliRec->y[pos]), poliRec->nVert[j],1,1); //comprobamos los posibles errores if(poligClip==NULL) { //liberamos la memoria asignada hasta ahora LibMemPolilClip(polilClip); LibMemPolil(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //recortamos polilAux = RecortaPolil(polilClip,poligClip,op,&nInt); //comprobamos los posibles errores if(polilAux==NULL) { //liberamos la posible memoria asignada hasta ahora LibMemPolilClip(polilClip); LibMemPoliClip(poligClip); LibMemPolil(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //sumamos el número de intersecciones (*nIntersec) += nInt; //añadimos la polilínea recortada a la variable de salida if(AnyadePolilPolil(resultado,polilAux)==GEOC_ERR_ASIG_MEMORIA) { //liberamos la posible memoria asignada hasta ahora LibMemPolilClip(polilClip); LibMemPoliClip(poligClip); LibMemPolil(polilAux); LibMemPolil(resultado); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //liberamos la memoria asignada al polígono de esta vuelta del bucle LibMemPoliClip(poligClip); //liberamos la memoria asignada a la polilínea auxiliar LibMemPolil(polilAux); //reinicializamos la polilínea a recortar polilClip = ReiniciaPolilClip(polilClip); } //liberamos la memoria asignada a la polilínea de esta vuelta del bucle LibMemPolilClip(polilClip); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return resultado; } /******************************************************************************/ /******************************************************************************/ polil* CreaPolilPolilClip(vertPolilClip* poli) { //índice para recorrer bucles size_t i=0; //número de elementos size_t nVert=0,nElem=0; //estructura auxiliar vertPolilClip* aux=poli; //variable de salida polil* result=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //creamos la estructura vacía result = IniciaPolilVacia(); //comprobamos los posibles errores if(result==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contamos todos los vértices de la polilínea nVert = NumeroVertPolilClip(poli); //contemplamos una posible salida rápida if(nVert==0) { //devolvemos la estructura vacía return result; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //número de elementos de los vectores de coordenadas nElem = nVert+2; //asignamos memoria para los vectores de coordenadas de la estructura result->x = (double*)malloc(nElem*sizeof(double)); result->y = (double*)malloc(nElem*sizeof(double)); //asignamos memoria para los vectores de posición result->posIni = (size_t*)malloc(sizeof(size_t)); result->nVert = (size_t*)malloc(sizeof(size_t)); //comprobamos los posibles errores de asignación de memoria if((result->x==NULL)||(result->y==NULL)||(result->posIni==NULL)|| (result->nVert==NULL)) { //liberamos la posible memoria asignada LibMemPolil(result); //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //asignamos el número de elementos de los vectores de coordenadas y de //polilíneas result->nElem = nElem; result->nPolil = 1; //asignamos la posición de inicio y el número de vértices result->posIni[0] = 1; result->nVert[0] = nVert; //asignamos los separadores de polilínea al principio y al final result->x[0] = GeocNan(); result->y[0] = GeocNan(); result->x[nElem-1] = GeocNan(); result->y[nElem-1] = GeocNan(); //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los vértices de la polilínea for(i=1;i<=nVert;i++) { //copio las coordenadas del vértice result->x[i] = aux->x; result->y[i] = aux->y; //siguiente vértice aux = aux->siguiente; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return result; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/ventorno.c000755 001750 001750 00000007422 12540021550 015770 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup anespec general @{ \file ventorno.c \brief Definición de funciones para el control de variables de entorno. \author José Luis García Pallero, jgpallero@gmail.com \date 31 de marzo de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/ventorno.h" /******************************************************************************/ /******************************************************************************/ int VarEnvValRef(const char* var, const char* valRef) { //posible valor de la variable de entorno char* valEnv=NULL; //variable de salida int salida=0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //extraemos el valor de la variable de entorno valEnv = getenv(var); //comprobamos si la variable está definida if(valEnv==NULL) { //se devuelve menor que 0 salida = -1; } else { //comprobamos su valor if(strcmp(valEnv,valRef)) { //su valor es distinto al de referencia salida = 0; } else { //si es igual al de referencia salida = 1; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return salida; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/geocomp.c000644 001750 001750 00000012016 12540021550 015537 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup anespec general geocomp geodesia geom geopot gravim mmcc @{ \file geocomp.c \brief Definición de funciones para la obtención de información de la implementación de OpenMP usada. \author José Luis García Pallero, jgpallero@gmail.com \date 25 de agosto de 2011 \version 1.0 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/geocomp.h" /******************************************************************************/ /******************************************************************************/ void VersionOpenMP(const int macro_OPENMP, char version[]) { //vamos comprobando los valores de la macro if(macro_OPENMP==GEOC_OMP_F_1_0) { //versión 1.0 strcpy(version,GEOC_OMP_V_1_0); } else if(macro_OPENMP==GEOC_OMP_F_2_0) { //versión 2.0 strcpy(version,GEOC_OMP_V_2_0); } else if(macro_OPENMP==GEOC_OMP_F_2_5) { //versión 2.5 strcpy(version,GEOC_OMP_V_2_5); } else if(macro_OPENMP==GEOC_OMP_F_3_0) { //versión 3.0 strcpy(version,GEOC_OMP_V_3_0); } else if(macro_OPENMP==GEOC_OMP_F_3_1) { //versión 3.1 strcpy(version,GEOC_OMP_V_3_1); } else { //versión desconocida strcpy(version,GEOC_OMP_V_DESC); } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ int FechaVersionOpenMP(const char version[]) { //variable de salida int fecha=GEOC_OMP_F_DESC; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //vamos comprobando los valores de la versión if(!strcmp(version,GEOC_OMP_V_1_0)) { //versión 1.0 fecha = GEOC_OMP_F_1_0; } else if(!strcmp(version,GEOC_OMP_V_2_0)) { //versión 2.0 fecha = GEOC_OMP_F_2_0; } else if(!strcmp(version,GEOC_OMP_V_2_5)) { //versión 2.5 fecha = GEOC_OMP_F_2_5; } else if(!strcmp(version,GEOC_OMP_V_3_0)) { //versión 3.0 fecha = GEOC_OMP_F_3_0; } else if(!strcmp(version,GEOC_OMP_V_3_1)) { //versión 3.1 fecha = GEOC_OMP_F_3_1; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return fecha; } /******************************************************************************/ /******************************************************************************/ /** @} */ /******************************************************************************/ /******************************************************************************/ /* kate: encoding utf-8; end-of-line unix; syntax c; indent-mode cstyle; */ /* kate: replace-tabs on; space-indent on; tab-indents off; indent-width 4; */ /* kate: line-numbers on; folding-markers on; remove-trailing-space on; */ /* kate: backspace-indents on; show-tabs on; */ /* kate: word-wrap-column 80; word-wrap-marker-color #D2D2D2; word-wrap off; */ octclip-1.0.8/src/octclip.h000644 001750 001750 00000002773 12540021550 015561 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /* Copyright (C) 2011 José Luis García Pallero, * * This file is part of OctCLIP. * * OctCLIP is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this software; see the file COPYING. If not, see * . */ /******************************************************************************/ /******************************************************************************/ #ifndef _OCTCLIP_H_ #define _OCTCLIP_H_ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/geom.h" /******************************************************************************/ /******************************************************************************/ #endif /******************************************************************************/ /******************************************************************************/ octclip-1.0.8/src/dpeucker.c000644 001750 001750 00000045524 12540021550 015722 0ustar00topotopo000000 000000 /* -*- coding: utf-8 -*- */ /** \ingroup geom @{ \file dpeucker.c \brief Definición de funciones para el aligerado de polilíneas basadas en el algoritmo de Douglas-Peucker. \author José Luis García Pallero, jgpallero@gmail.com \date 04 de julio de 2011 \section Licencia Licencia Copyright (c) 2011, José Luis García Pallero. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /******************************************************************************/ /******************************************************************************/ #include"libgeoc/dpeucker.h" /******************************************************************************/ /******************************************************************************/ size_t* AligeraPolilinea(const double* x, const double* y, const size_t nPtos, const size_t incX, const size_t incY, const double tol, const enum GEOC_DPEUCKER_ROBUSTO robusto, const size_t nPtosRobusto, const size_t nSegRobusto, size_t* nPtosSal) { //índice para recorrer bucles size_t p=0; //índice de los puntos de trabajo size_t i=0,j=0,k=0; //coordenadas de trabajo double xIni=0.0,yIni=0.0,xFin=0.0,yFin=0.0,xTrab=0.0,yTrab=0.0; //altura del triángulo de trabajo double h=0.0; //variable indicadora de punto a mantener int usado=0; //número de elementos de trabajo internos del vector de salida size_t nElem=0; //vector de salida size_t* sal=NULL; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //iniciamos la variable de salida de número de puntos a 0 *nPtosSal = 0; //comprobamos casos especiales de nPtos if(nPtos==0) { //salimos de la función con NULL return NULL; } else if(nPtos<=2) { //asignamos el número de puntos usados *nPtosSal = nPtos; //asignamos memoria para el vector de salida sal = (size_t*)malloc((*nPtosSal)*sizeof(size_t)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //asignamos valores al vector de salida for(i=0;i<(*nPtosSal);i++) { //asignamos el índice de trabajo sal[i] = i; } //salimos de la función return sal; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //inicializamos el indicador interno de tamaño del vector nElem = GEOC_DPEUCKER_BUFFER_PTOS; //asignamos memoria para el vector de salida sal = (size_t*)malloc(nElem*sizeof(size_t)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } //indicamos que el primer punto siempre se usa *nPtosSal = 1; sal[0] = 0; //puntos de trabajo para iniciar los cálculos i = 0; j = 1; k = 2; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //entramos en un bucle infinito while(1) { //comprobamos si hay que salir del bucle if(k>(nPtos-1)) { //salimos del bucle break; } //coordenadas de la base del triángulo xIni = x[i*incX]; yIni = y[i*incY]; xFin = x[k*incX]; yFin = y[k*incY]; //inicializamos a 0 la variable de punto usado usado = 0; //recorremos los puntos a testear for(p=j;ptol) { //indicamos que el punto ha sido usado usado = 1; //comprobamos si se utiliza el algoritmo robusto if(robusto!=GeocDPeuckerRobNo) { //comprobamos si hay que aplicar el algoritmo de //intersección con puntos originales if((robusto==GeocDPeuckerRobSi)|| (robusto==GeocDPeuckerRobOrig)) { //aplicamos el algoritmo AligPolilRobIntersecOrig(x,y,nPtos,incX,incY, nPtosRobusto,i,&p); } //comprobamos si hay que aplicar el algoritmo de auto //intersección if((robusto==GeocDPeuckerRobSi)|| (robusto==GeocDPeuckerRobAuto)) { //indicamos un número de puntos para el vector de salida //una unidad menor que el número realmente almacenado //para evitar el segmento inmediatamente anterior al que //vamos a crear AligPolilRobAutoIntersec(x,y,incX,incY,sal, (*nPtosSal)-1,nSegRobusto,i, &p); } } //añadimos al contador este nuevo punto (*nPtosSal)++; //comprobamos si hay que reasignar memoria if((*nPtosSal)>nElem) { //añadimos otro grupo de puntos nElem += GEOC_DPEUCKER_BUFFER_PTOS; //asignamos memoria para el vector de salida sal = (size_t*)realloc(sal,nElem*sizeof(size_t)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //añadimos el nuevo punto usado sal[(*nPtosSal)-1] = p; //actualizamos los índices de los puntos de trabajo i = p; j = i+1; k = j+1; //salimos del bucle break; } } //comprobamos si no se ha utilizado ninguno de los vértices candidatos if(!usado) { //pasamos al siguiente punto como extremo del segmento k++; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si el último punto se ha añadido if(sal[(*nPtosSal)-1]!=(nPtos-1)) { //añadimos al contador el último punto (*nPtosSal)++; //comprobamos si hay que reasignar memoria if((*nPtosSal)>nElem) { //añadimos otro grupo de puntos nElem += GEOC_DPEUCKER_BUFFER_PTOS; //asignamos memoria para el vector de salida sal = (size_t*)realloc(sal,nElem*sizeof(size_t)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //asignamos el último punto sal[(*nPtosSal)-1] = nPtos-1; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //comprobamos si el vector de salida tiene demasiada memoria asignada if(nElem>(*nPtosSal)) { //ajustamos el tamaño del vector de salida sal = (size_t*)realloc(sal,(*nPtosSal)*sizeof(size_t)); //comprobamos los posibles errores if(sal==NULL) { //mensaje de error GEOC_ERROR("Error de asignación de memoria"); //salimos de la función return NULL; } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return sal; } /******************************************************************************/ /******************************************************************************/ void AligPolilRobIntersecOrig(const double* x, const double* y, const size_t nPtos, const size_t incX, const size_t incY, const size_t ptosAUsar, const size_t posIni, size_t* posFin) { //índices para recorrer bucles size_t i=0,j=0; //coordenadas de trabajo double xA=0.0,yA=0.0,xB=0.0,yB=0.0,xC=0.0,yC=0.0,xD=0.0,yD=0.0; //punto de parada para comprobar la intersección de segmentos size_t parada=0; //identificador de intersección int inter=0; //variables auxiliares size_t aux=0; double xAux=0.0,yAux=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contemplamos una posible salida rápida if((*posFin)<=(posIni+1)) { //salimos de la función return; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el número de puntos que quedan hasta el final de los vectores //de coordenadas desde la posición de fin de segmento (contándola) aux = nPtos-(*posFin); //calculamos el punto de parada para la intersección de segmentos if((aux>ptosAUsar)&&(ptosAUsar!=0)) { //paramos en un pnto tal que usemos ptosAUsar puntos parada = *posFin+ptosAUsar-1; } else { //paramos en el penúltimo punto parada = nPtos-2; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //las coordenadas del punto inicial del segmento base no cambian nunca xA = x[posIni*incX]; yA = y[posIni*incY]; //recorremos los puntos candidatos hasta el anterior al punto base for(i=(*posFin);i>posIni;i--) { //comprobamos si estamos ante el punto posterior al inicial if(i==(posIni+1)) { //terminamos, porque este punto es el siguiente al punto base en el //listado original *posFin = i; //salimos del bucle break; } else { //coordenadas de los puntos inicial y final del segmento base xB = x[i*incX]; yB = y[i*incY]; //recorremos los puntos posteriores hasta el de parada for(j=i;j<=parada;j++) { //coordenadas de los puntos inicial y final del siguiente //segmento xC = x[j*incX]; yC = y[j*incY]; xD = x[(j+1)*incX]; yD = y[(j+1)*incY]; //calculamos la intersección entre los segmentos inter = IntersecSegmentos2D(xA,yA,xB,yB,xC,yC,xD,yD,&xAux, &yAux); //comprobamos si hay intersección entre los segmentos if(inter!=GEOC_SEG_NO_INTERSEC) { //salimos del bucle break; } } //comprobamos si no ha habido ninguna intersección if(inter==GEOC_SEG_NO_INTERSEC) { //indicamos el índice del vértice final *posFin = i; //salimos del bucle break; } } } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //salimos de la función return; } /******************************************************************************/ /******************************************************************************/ void AligPolilRobAutoIntersec(const double* x, const double* y, const size_t incX, const size_t incY, const size_t* posAlig, const size_t nPosAlig, const size_t segAUsar, const size_t posIni, size_t* posFin) { //índices para recorrer bucles size_t i=0,j=0; //variables de posición size_t k=0,l=0,pos=0; //coordenadas de trabajo double xA=0.0,yA=0.0,xB=0.0,yB=0.0,xC=0.0,yC=0.0,xD=0.0,yD=0.0; //número de segmentos calculados hasta ahora, excepto el último size_t nSeg=0; //identificador de intersección int inter=0; //variables auxiliares double xAux=0.0,yAux=0.0; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //contemplamos una posible salida rápida if(((*posFin)<=(posIni+1))||(nPosAlig<2)) { //salimos de la función return; } //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //calculamos el número de segmentos calculados hasta ahora, excepto el //anterior al de trabajo nSeg = nPosAlig-1; //comprobamos si se usan todos los segmentos o sólo parte if(segAUsar!=0) { //asignamos el número de segmentos a utilizar nSeg = (nSeg>segAUsar) ? segAUsar : nSeg; } //las coordenadas del punto inicial del segmento base no cambian nunca xA = x[posIni*incX]; yA = y[posIni*incY]; //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //recorremos los puntos candidatos hasta el anterior al punto base for(i=(*posFin);i>posIni;i--) { //comprobamos si estamos ante el punto posterior al inicial if(i==(posIni+1)) { //terminamos, porque este punto es el siguiente al punto inicial *posFin = i; //salimos del bucle break; } else { //coordenadas del punto final del segmento base xB = x[i*incX]; yB = y[i*incY]; //recorremos el número de segmentos de trabajo for(j=0;j> OctCLIP Category Kernel functions _oc_polybool Category Driver functions oc_polybool octclip-1.0.8/COPYING000644 001750 001750 00000104513 12540021550 014212 0ustar00topotopo000000 000000 GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read .