⚠ DISCLAIMER / VAROITUS

EN: Theoretical study of agents-govern + Claude AI for 3D parametric modelling. Not a pier design. Must not be used for actual construction. No structural-engineer review, no site survey, no permit, no Eurocode load calculations. See disclaimer.html.

FI: Teoreettinen tutkielma agents-govern + Claude AI:n käytöstä 3D-parametrisessa mallinnuksessa. Ei laiturin rakennesuunnitelma. Ei saa käyttää todellisen rakentamisen perustana. Ei rakennesuunnittelijan tarkastusta, ei maaperätutkimusta, ei rakennuslupaa, ei Eurocode-laskelmia. Ks. disclaimer.html.

Puulaiturin rakennesuunnitelma — geometrinen + materiaalipohjainen

Versio: 16 (päivitetty 2026-04-26 — paalumateriaali vaihdettu: kreosoottipylväät → lämpökäsitelty mäntypuu (ThermoWood)) Lähde: laituri_3d.py -parametrisesta CadQuery-mallista Generointikomento: uv run python laituri_3d.py --out-dir out Aiotut tiedostot tässä kansiossa: - laituri.step — 3D-malli (FreeCAD, muut CAD-ohjelmat) - laituri.glb — 3D-malli web-katseluun - laituri_pohja.dxf — skemaattinen pohjakuva (paalut + vyöhirret + kannattajat + kansiala) - laituri_sivu.dxf — skemaattinen sivuleikkaus (paalut + ristituet + tasot + vesiraja + mutapinta) - laituri_paaty.dxf — skemaattinen päätynäkymä (poikkileikkaus paaluparin kohdalla: 2 paalua + vyöhirret + X-ristituki + kannattajat + kansi + pohjalevyt) - stage_01_paalut.dxf … stage_07_paaty.dxf — vaiheittaiset rakennus-DXF:t (yksi per asennusvaihe, työmaalle tulostettavaksi — ks. §5) - detail_J7_jatkos.dxf — vinoliitos-detail (scarf joint 21000 mm vyöhirsille, mittakaava 1:1) - laituri_bom.csv — koneellinen BOM (semicolon-eroteltu, sisältää nyt jatkos-laskennan) - RAKENNESUUNNITELMA.md — tämä dokumentti

0. Turvallisuusehto (kriittinen)

MIKÄÄN puinen tai metallinen komponentti EI saa olla kannen yläpuolella (z > kannen yläpinta = 0). Ainoat sallitut kohdat kannen yläpuolella ovat paalujen yläpäät, jotka nousevat 200 mm yli kannen mahdollisten pohjan painumien tai upotussyvyyden muutosten varalle.

Aiempi versio v13/v14 sisälsi pääty-vyöhirsen kannen päällä (z=0..148); tämä oli kompastusvaara ja korjattiin v15:ssa. Pytest-invariantti test_top_waling_below_deck_SAFETY estää regression.

1. Disclaimer

Tämä on geometrinen + materiaalipohjainen suunnitelma — EI rakennelaskenta.

Mitoitusta ei ole tarkistettu Eurocode 5 -puurakenteiden, RIL-ohjeiden tai minkään muun rakennusinsinöörin standardin mukaisesti. Ennen rakentamista mitoitukset on tarkistettava pätevällä rakennesuunnittelijalla, erityisesti:

• Jää- ja aaltokuormat paaluihin
• Pile-mitoitus todelliseen pohjaan
• Liitossuunnittelu (pultti-, ruuviliitokset)
• Käyttörajatila (taipuma, värähtely)

Tämä dokumentti soveltuu rakennushankkeen geometrian ja materiaalitarpeen suunnitteluun, ei lupahankkeen rakennelaskelmiksi.

2. Yleiset mitat ja parametrit

3D-mallissa on 283 yksittäistä komponenttia koottuna cq.Assembly-puuhun.

3. Komponenttipuu (asennuksen alhaalta-ylös -järjestyksessä)

Puulaituri 21x2m
├── Paalut (16 kpl, lämpökäsitelty mäntypylväs Q300mm — ThermoWood class D)
│   ├── Paalu_P1_L .. Paalu_P8_L (vasen rivi)
│   └── Paalu_P1_R .. Paalu_P8_R (oikea rivi)
│
├── Pohjalevyt (32 kpl: 2 ristissä per paalu)
│   ├── Pohjalevy_P1_L_1 (poikittain) ─┐
│   └── Pohjalevy_P1_L_2 (pitkittäin) ─┘ asennetaan ennen paalun upotusta
│
├── Vyöhirret (16 kpl: 2 tasoa × 2 sivua × 2 rinnakkain)
│   ├── Vyohirsi_alempi_L_0/1 + R_0/1   (vesirajan tuntumassa, ~100 mm yläpuolella)
│   └── Vyohirsi_ylempi_L_0/1 + R_0/1   (kannen alapuolella)
│
├── Ristituet poikittain (16 kpl: X-tukirakenne joka paaluparille)
│   └── Ristituki_P1_A/B .. Ristituki_P8_A/B
│
├── Pituussuuntaiset vinotuet (14 kpl, joka välissä, suunta vuorotellen)
│   └── Pituusvino_0_-900 / +900 .. Pituusvino_6_-900 / +900
│
├── Kannakkeet (8 kpl, poikittain paalupareittain — v6 fix)
│   └── Kannake_P1 .. Kannake_P8 (yläpinta = kannattajan alapinta z=−226)
│
├── Vaakatason ristituet (14 kpl, X-kuvio paaluvälien yli — v11 fix)
│   └── Vaakaristi_0_A .. Vaakaristi_6_B (Z2-tasolla z=−274, jää/aaltoresistanssi)
│
├── Kannattajat (5 kpl, c-c 500 mm — ST-1 fix; lepäävät kannakkeiden päällä)
│   └── Kannattaja_0 .. Kannattaja_4
│
├── Kansilaudat (169 kpl, 28×120 uritettu)
│   └── Kansilauta_000 .. Kansilauta_168
│
└── Top-walingit (2 kpl, kannen ALAPUOLELLA joistin tasolla — v15 SAFETY)
    └── TopWaling_-1050 / +1050 (lateraalisidonta z=−176..−28)

4. Bill of Materials (BOM) — yhteenveto

Lähde: laituri_bom.csv (23 osariviä, yhteensä 1020,4 juoksumetriä lineaarista materiaalia + 28,8 m kierretankoa)

Puutavara

) HUOM:* 21 m pituiset hirret on jatkettava — kaupallinen maksimi ~5,4 m (ks. löydös TM-1 alla).

✱) Päivitetty (ST-1 fix): kannattajia 4 → 5 (c-c 500 mm) jotta 28 mm uritettu kansi ei jousta. +1 kpl ja +21 m kannattaja-puutavaraa, +338 ruuvia kanteen.

✦) Lisätty v6:ssa (puuttunut komponentti): Alkuperäisestä mallista puuttuivat kannakkeet kokonaan. Ilman näitä 21 m pituiset kannattajat roikkuvat ilmassa ilman tukipistettä — laituri ei toimisi rakenteellisesti. 8 kannakelankkua (yksi per paalupari) bolttataan paalujen läpi ja tukevat kannattajat alapuolelta.

✥) Vahvistettu v8:ssä (jää-/aaltokuormille): Alkuperäinen pituusvinotuki kattoi vain 4 / 7 paaluvälistä alternoivilla suunnilla — kolme väliä jäi ilman pitkittäistä tukea. Muutettu siksak-Pratt-truss-kuvioksi: yksi vinotuki joka välissä, suunta vuorotellen (pariton ↑, parillinen ↓), molemmilla sivuilla. 8 → 14 kpl, +21,6 m puutavaraa. Antaa täyden longitudinaalisen jäykkyyden jää- ja aaltokuormille.

⌑) Lisätty v11:ssä, päivitetty v12:ssa: Käyttäjä huomasi että jää- ja aaltokuormat aiheuttavat sivuttaisvoimia, jotka voivat vinouttaa laiturin vinoneliön muotoon. Lisätty 14 vinopalkkia (yksi paaluväli = X-kuvio: P_R(i)→P_L(i+1) + P_L(i)→P_R(i+1)) Z2-tasolle (z=−274, +200 mm poikittaisen X-ristituen keskeltä). v12: päivitetty 48×198 NTR AB (vakio mitallistettu, sijaitsee selkeästi vesirajan yläpuolella). Voi vaatia notkauksen vyöhirsien kosketuskohdissa.

⊳) Lisätty v13 (H1), siirretty v15:ssa kannen ALAPUOLELLE (TURVALLISUUSKORJAUS): v13 lisäsi pääty-vyöhirsen kannen tasolle (z=0..148) — käyttäjä huomasi v15 Gate 2 -tarkistuksessa että tämä on kompastusvaara kannen reunalla (148 mm korkea palkki kannen pinnalla). v15 siirsi walingin kannen ALAPUOLELLE (z=−176..−28), joistin tasolle samaan y-positioon kuin alemmat vyöhirret. Sama H1-rakennetehoste (paalujen lateraalisidonta), mutta piilossa, ei kompastusvaaraa. Bolttaus M16 kierretangolla paalun läpi (sama hardware-inventaario kuin muut paalun läpi -liitokset).

⊕) Lisätty v13:ssa (H4 fix — kulmaraudat): Alkuperäisessä mallissa kannattajat lepäsivät kannakkeiden päällä pelkällä painollaan, ilman mekaanista kiinnitystä. Aalto-/jääkuormissa nostokuorma irrottaisi kannattajat. Lisätty 40 kulmarautaa (Simpson Strong-Tie -tyyppi) jokaiseen 5 kannattajan × 8 kannakkeen risteykseen, kiinnitettynä 160 puuruuvilla A4 5×40 mm. Estää kannattajien kohoamisen.

◇) Materiaaliluokitus v12:ssa: Komponentit, jotka eivät kosketa vettä jatkuvasti, voidaan toteuttaa NTR AB -luokassa A:n sijaan. AB on noin 10-15 % halvempaa ja sopii sade- ja lumialtistukseen. A-luokassa pysyivät: pohjalevyt (mudassa), alempi vyöhirsi (vesirajan tuntumassa), ristituki X (ulottuu alemman vyöhirren tasolle) ja kannake (lähellä vesirajan vaikutusaluetta). AB-luokkaan siirtyivät: ylempi vyöhirsi, pituusvinotuet ja vaakaristit. Kansilauta oli jo AB.

Kiinnikkeet — paalun läpi (TM-2 fix: kierretanko)

Kiinnikkeet — muut

✱) Päivitetty (ST-1 fix): ruuveja 1352 → 1690 koska kannattaja lisätty.

5. Asennusjärjestys (suositeltu)

1. Pohjalevyjen esivalmistus rannassa — 16 paaluparia × 2 ristikkäistä lankkua, läpipulttaus M20:lla paalun alapäähän
2. Paalujen pystytys — lämpökäsitellyt mäntypylväät paikalleen, tarkistus painumamittauksilla. Mudan upotus tavoite 3,0 m (verifioi paikan päällä). HUOM: lämpökäsitelty puu on ~5-10 % heikompi taivutuksessa kuin käsittelemätön — varmistettava että dimensiot riittävät pystytys- ja jääkuormiin.
3. Alemmat vyöhirret — vesirajan yläpuolelle ~400 mm, M16 kierretanko paalun läpi (ks. asennuskäytäntö §5.1)
4. Poikittaiset ristituet (X) — alemman ja ylemmän vyöhirren välille, jokaiseen paalupariin (kierretanko paalun läpi, M16 × 250 mm lapipultti X-keskukseen)
5. Ylemmät vyöhirret — kannattajien tason alle
6. Pituussuuntaiset vinotuet — vuorotellen joka toiseen lohkoon (alkaen i=0,2,4,6); päät kiinnitetään M16 × 250 mm lapipultilla
7. Kannakkeet — yksi per paalupari, paalujen läpi M16 × 400 mm lapipultilla (2 per kannake). Yläpinta tasoon kannattajien alapinnan kanssa (z=−226). Pyöreälle paalulle: notkaus paalukosketuspinnalle TAI lyhennä 1500 mm:iin sivu-asennukseen.
8. Kannattajat (joists) — pituussuunnassa kannakkeiden päälle, c-c 500 mm (5 kpl 2 m leveydellä — ST-1 fix)
9. Kansilaudat — 5 mm raolla, A4-ruuvit 5×70 mm × 2 ruuvia per kannattaja-risteys

5.1 Asennuskäytäntö paalun läpi -kiinnityksissä (kierretanko M16)

Koska 64 paalukiinnitystä toteutetaan kierretankona (ei valmiina läpipulttina), seuraavat ehdot ovat pakollisia turvallisen toiminnan takaamiseksi:

Lyhyemmät M16-kiinnitykset (ristituen X-keskus, vinotukien päät) tehdään tavallisina M16 × 250 mm lapipultteina — niissä ei ole kierretangon haittoja (ei tärinäaltistusta paalun kautta) eikä saatavuusongelmia.

5.2 Vaiheittaiset asennus-DXF:t työmaalle (v14)

stage_01_paalut.dxf … stage_07_paaty.dxf antavat työnjohtajalle ja asentajille kuvalliset asennusvaiheet. Jokainen DXF on yhden vaiheen päässä-tila (top view), joten työntekijä voi:

1. Tulostaa nykyvaiheen DXF:n A3:lle / A2:lle
2. Tarkistaa että edellisen vaiheen rakenne on paikallaan ennen kuin lisätään tämän vaiheen komponentteja
3. Valmistuneen vaiheen jälkeen siirtyä seuraavan stage-DXF:än

5.3 Vinoliitos-detail (J7) — 21000 mm vyöhirret jatkettava

detail_J7_jatkos.dxf näyttää miten kaupalliset 5400 mm boardit liitetään vinoliitoksella saavuttaakseen 21000 mm pituuden. Mittakaava 1:1, joten työntekijä voi mitata suoraan tulosteesta.

Asennuskäytäntö (kuvattu DXF:ssä):

1. Sahaa boardit oikea-pituiseen samaan vinoon (1:6 kaltevuus = ~600 mm overlap)
2. Vino-pinnat istuvat toisiaan vasten ilman välitilaa
3. Liima (PU- tai epoksi-puuliima) + 4 lapipulttia M10 viistopinnan läpi
4. Liitos PITÄÄ sijoittaa SUORAAN paalun kohdalle (paalu rakenteellisena tukena)
5. Per 21000 mm vyöhirsi: 4 boardia 5400 mm + 3 jatkosta paalujen kohdilla

6. Advisory-löydökset (informatiivinen, ei rakennesuunnittelijan tarkistus)

Materiaali- ja BOM-huomiot

Rakenteelliset huomiot

Yhteenveto (versio 12)

• TM-1 (merkittävä) ratkaistu v3 — jatkoslaskenta BOM:iin
• TM-2 (kriittinen) ratkaistu v2 — kierretanko + NyLock + 80×80 aluslevyt
• TM-3 (vähäinen) ratkaistu v12 — NTR AB -luokitus vesirajan yläpuolisille osille
• TM-4 (merkittävä) ratkaistu v16 — kreosoottipylväs vaihdettu lämpökäsiteltyyn mäntypuuhun
• ST-1 (merkittävä) ratkaistu v2 — kannattajaväli 500 mm
• Avoimia kriittisiä: 0 (kaikki ratkaistu)
• 2 vähäistä (TM-5 hukkavara, ST-3 pohjalevyn koko) + 3 dokumentointihuomiota (ST-2 jääkuorma, ST-4 venekiinnitys, ST-5 mudan upotus)

Iteraatiot v2, v3 ja v12 ovat ratkaisseet kaikki koodimuutoksilla korjattavat löydökset (1 kriittinen, 2 merkittävää, 1 vähäinen). Loput ovat informatiivisia tai vaativat ulkoisen rakennesuunnittelijan tarkistuksen.

Lisäykset v16:ssa

• Paalumateriaali vaihdettu: kreosoottikyllästetty puhelinpylväs → lämpökäsitelty mäntypuu (ThermoWood class D, EN 252 ground contact). Sama dimensio Q300×8500 mm. Ratkaisee TM-4 löydöksen (kreosoottipuu ei sallittu uudisrakennukseen EU:ssa rajoituksen 2003 jälkeen).
• Hyödyt:
• EU-hyväksytty uudisrakennukseen (toisin kuin kreosootti)
• Korkea kosteus- ja homenkesto (lämpökäsittely 180-230 °C poistaa puun ravinteet jotka ruokkivat homeita)
• Saatavissa standardimitoissa Suomalaisilta valmistajilta (Stora Enso, Metsä Wood)
• Ei myrkyllisiä kyllästysaineita → turvallisempi sahaus, ei erityisjätettä
• Haitat tarkistettavaksi:
• 5-10 % heikompi taivutuksessa kuin käsittelemätön puu — varmistettava että jää-/aaltokuormat eivät ylitä rajoja (ulkoinen rakennesuunnittelija)
• Kalliimpaa kuin tavallinen kestopuu, mutta halvempaa kuin kierrätetyn kreosoottipylvään etsintä uudisrakennukseen
• Ruskea väri (tyypillinen) — esteettinen huomio
• ⚙ -merkki BOM-rivillä 1 osoittaa materiaalimuutoksen.

Lisäykset v15:ssä — KRIITTINEN TURVALLISUUSKORJAUS

• Top-waling siirretty kannen yläpuolelta kannen ALAPUOLELLE. v13/H1 fix oli sijoittanut walingin z=0..148 (kannen reunalla), mikä oli kompastusvaara. v15 siirtää walingin z=−176..−28 (joistin tasolle, kannen alapuolelle, piiloon). Sama y-positio (±1050) kuin alemmat vyöhirret. Bolttaus säilyy samanlaisena.
• Stage-tiedostot uudelleenjärjestetty: stage 5 = top-waling (siirretty asennusvaiheen aikaisemmaksi koska helpompi asentaa ennen joistia), stage 6 = kannattajat + kulmaraudat, stage 7 = kansilaudat (viimeistely).
• Uusi turvallisuusinvariantti test_top_waling_below_deck_SAFETY estää regression: top-walingin yläpinta z ≤ kannen alapinta − deck_board_t. Pakottaa sen pysymään aina kannen alapuolella.
• Korvaava invariantti test_top_waling_aligned_with_joist_top varmistaa että waling istuu siististi joistin viereen ilman vaakasuuntaista välitilaa.
• BOM: M12 × 400 mm lapipultti vaihdettu M16 × 450 mm kierretankoon (käyttää samaa kierretanko-inventaariota kuin muut paalun läpi -liitokset, ei vaadi erikoismittaisia M12-pultteja). Yhteensä 80 kierretankoa (oli 64 + uusi 16).
• §0 lisätty dokumentin alkuun: kriittinen turvallisuusehto.

Lisäykset v14:ssä

• Vaiheittaiset rakennus-DXF:t työmaalle: uusi vie_dxf_stages()-funktio tuottaa 7 erillistä DXF-tiedostoa (stage_01_paalut.dxf … stage_07_paaty.dxf), yksi per asennusvaihe. Kukin näyttää pohjasta sen mitä on rakennettu vaiheen jälkeen — tulostettavissa työmaalla A3/A2-formaatissa.
• Vinoliitos-detail (J7): uusi detail_J7_jatkos.dxf näyttää 21000 mm vyöhirsen jatkosrakenteen (vinoliitos / scarf joint) mittakaavassa 1:1. Sisältää asennusohje-tekstit DXF:ssä.
• Audit-korjaus A4: pituussuuntaiset vinotuet erotettu omalle LONG_BRACE-layerille (sininen) — erottuvat sivunäkymässä paljon paremmin taustasta. Aiemmin sulautuivat valkoiseen pääjoukkoon.
• Audit-korjaus A1: zoom-PNG:t piilottavat DIMENSIONS- ja LABELS-layerit etteivät mittaviivat estä zoomausta. Sivu/pääty-zoomit toimivat nyt oikein; pohja-zoom ei näytä eroa koska rakenne on yhdenmukainen koko pituudelta.
• Uusi LONG_BRACE-layer + päivitetty _dxf_doc() rekisteröimään se.

Lisäykset v13:ssa

• Pääty-vyöhirsi (H1 fix): lisätty 2 pitkittäistä vyöhirttä kannen tasolle, sitomaan paalujen yläpäät yhteen. NTR AB 48×148 × 21000 mm × 2 kpl. Bolttaus M12 × 400 mm lapipultilla paalun läpi (16 kpl). Pohja, sivu ja päätynäkymä-DXF:t päivitetty näyttämään uusi komponentti.
• Kannattaja-kannake-kulmaraudat (H4 fix): lisätty BOM-rivit 40 kulmaraudalle (Simpson Strong-Tie -tyyppi) ja 160 A4-puuruuville. Ei mallinneta 3D:nä koska kulmaraudat ovat liian pieniä mallin mittakaavalle. Estää kannattajien kohoamisen aalto-/jääkuormissa.
• Komponenttimäärä: 281 → 283 (+2 pääty-vyöhirret). Materiaali: 978,4 → 1020,4 m (+42 m). BOM-rivit 19 → 23.
• 2 uutta pytest-invarianttia (yhteensä 20/20):
• test_top_waling_starts_at_deck — pääty-vyöhirsen alapinta = kannen yläpinta
• test_top_waling_below_pile_top — vyöhirsen yläpinta < paalun yläpää (paalu sticks up above)

Lisäykset v12:ssa

• Vaakaristit 40×198 → 48×198 NTR AB. Aiempi 40 mm paksuus oli epästandardi mitta. Vaihdettu vakioon 48×198 — saatavuus varma, vakio mitallistettu kestopuu joka tuottajalla.
• Materiaaliluokituksen optimointi: ylempi vyöhirsi, pituussuuntaiset vinotuet ja vaakaristit siirrettiin NTR A → NTR AB -luokkaan koska sijaitsevat vesirajan yläpuolella ja eivät jatkuvasti kosketa vettä. AB on noin 10-15 % halvempaa.
• BOM-rivit 18 → 19: vyöhirsi-rivi jaettu kahdeksi (ylempi NTR AB + alempi NTR A) materiaaliselityksen tarkkuuden vuoksi.
• A-luokassa jäivät: pohjalevyt, alempi vyöhirsi, ristituki X, kannake (kaikki vesirajan tuntumassa tai sen alla).

Lisäykset v11:ssä

• Vaakatason X-ristituki (G1+Z2) lisätty käyttäjän pyynnöstä: jokaiseen 7 paaluväliin kaksi vinopalkkia jotka risteävät keskellä — toinen P_R(i)→P_L(i+1), toinen P_L(i)→P_R(i+1). Yhteensä 14 vinopalkkia Z2-tasolla (200 mm ylempänä kuin transverse X-cross center). Vahvistaa laiturin sivuttaista jäykkyyttä jää-/aaltokuormissa.
• Materiaali 40×198 NTR A — käyttäjän valitsema, mutta epästandardi mitallistettu mitta (vakio on 48×198). BOM:issa selkeä huomio.
• +49 m puutavaraa, +28 lapipulttia M16×400 mm.
• 2 uutta pytest-invarianttia (yhteensä 18/18):
• test_horiz_brace_z_above_x_cross — Z2 = X-cross center + 200 mm
• test_horiz_brace_below_deck — vaakaristin yläpinta < kannen alapinta
• DXF-näkymät: pohja saa selkeän X-kuvion paaluvälien yli; sivu 7 vaakaviivaa; pääty kiinnityskohdat suorakaiteina kummankin paalun kohdalla.

Lisäykset v10:ssä

• Mittatekstit ja labelit muunnettu LWPOLYLINE-glyfeiksi. v9:n manuaaliset mittaviivat näkyivät (LINE-entiteetit), mutta itse mittanumerot ja "WL"/"MUD"/näkymäotsikot eivät — viewer (Onshape-tyyppinen) ohittaa DXF:n TEXT-entiteetit kun fonttiviite (Standard / txt.shx) puuttuu. Korvattu kaikki TEXT-kutsut _add_text_geom-funktiolla joka käyttää ezdxf.addons.text2path-modulia muuntaen merkit ulkoreuna-poluiksi ja tasoittaen ne LWPOLYLINE-segmenteiksi.
• Tulokset: 0 TEXT-entiteettiä missään tiedostossa. LWPOLYLINE-määrät kasvoivat: pohja 16 → 66, sivu 19 → 106, pääty 15 → 105 (yksi mittanumero "21000" = ~7 polylineä; yksi merkki = ~5-15 polylineä riippuen muodosta).
• Lopputulos: mittaviivat, mittaluvut ja labelit ovat nyt kaikki pelkkää 2D-geometriaa (LINE + LWPOLYLINE + CIRCLE). Toimii joka DXF-katselimessa, fontista riippumatta.

Lisäykset v9:ssä

• Pituussuuntaiset vinotuet sivunäkymään. Aiempi _vie_dxf_sivu ei piirtänyt pituusvinotukia vaikka 3D-malli ne sisältää (14 kpl). Nyt sivunäkymässä näkyy 7 siksag-viivaa (sivut päällekkäin projektoituvat) jotka kuvastavat Pratt-truss-rakennetta.
• Mittaviivat → manuaaliset LINE+TEXT-entiteetit. Aiemmat ezdxf:n add_linear_dim() -kutsut tuottivat DIMENSION-blokkit, joita useimmat 3D-CAD-katselimet (Onshape, Fusion 360, FreeCAD Part) ohittavat DXF-importissa. Korvattu manuaalisilla viivoilla (jatkeviivat + mittaviiva + nuolikärjet 4 viivasta) + tekstillä (mm-arvot). Toimii nyt joka DXF-katselimessa.
• Entity-määrät kasvoivat koska 1 mittaviiva = 7 LINE-entiteettiä + 1 TEXT-entiteetti (oli 1 DIMENSION + INSERT-blokit, joita ei kuitenkaan renderöitynyt).

Lisäykset v8:ssä

• Pituusvinotuet täyteen kattavuuteen (jää-/aaltokuormille). Aiemmin 4 / 7 paaluvälistä jäi ilman pitkittäistä tukea. Nyt siksak-Pratt-truss- kuvio: 14 vinotukea (oli 8), kattaa kaikki 7 väliä molemmilta sivuilta vuorottelevin suunnin.
• Mittaviivat DXF-näkymiin (de-facto industrial way). Käytetään ezdxf:n EZDXF-dimstyleä (mm-skaalaan viritetty: 100 mm tekstikoko, 80 mm nuolikärjet, 0 desimaalia). Erillinen DIMENSIONS-layer + erillinen LABELS-layer otsikoille ja ankkurimerkeille. Yhteensä:
• Pohja: 4 mittaviivaa (kokonaispituus, paaluvali, kokonaisleveys, paalujen poikittainen c-c)
• Sivu: 6 mittaviivaa (kokonaispituus, paaluvali, kannen-vesirajan korkeus, vesisyvyys, mudan upotus, paalun kokonaispituus)
• Pääty: 7 mittaviivaa (pier_width, pile_trans c-c, vyöhirsi-ulkoreuna leveys, kannen-vesirajan, vesisyvyys, mudan upotus, vyöhirsi-tasot)
• DXF-tiedostokoot kasvoivat ~3-kertaisiksi (~80 KB) mittaviivojen lisäyksen takia.

Lisäykset v7:ssä

• DXF-tiedostot uudelleen toimivia. Aiemmissa versioissa cadquery-pohjaiset DXF:t sisälsivät vain 1-4 viivaa odotettujen 30+:n sijaan — käyttäjä huomasi tyhjyydet 3D-katselimessa. Vaihdettiin ezdxf-kirjastoon suoraan: nyt pohja sisältää 16 ympyrää + 16 suorakaidetta + 3 tekstiä, sivu 18 viivaa + 19 suorakaidetta + 3 tekstiä, päätynäkymä 4 viivaa + 15 suorakaidetta + 3 tekstiä.
• Tekstilabelit lisätty kaikkiin kolmeen näkymään (näkymän nimi + WL/MUD-merkinnät).
• Uusi suora riippuvuus: ezdxf>=1.0 pyproject.toml:iin.

Lisäykset v6:ssa

• Puuttuneet kannakkeet lisätty — käyttäjä huomasi että kannattajat roikkuvat ilmassa. 8 transverse cap beam (NTR A 48×198 × 2100 mm) per paalupari, jokainen bolttattu paalujen läpi M16 × 400 mm lapipultilla (2 per kannake). Kannakkeen yläpinta = kannattajan alapinta tarkasti (varmistettu pytestillä).
• Ristituen kallistuskulma korjattu 1.78° → 8° — cross_attach_*_z siirretty vyöhirsien sisäpinnoilta keskilinjoille (Option A). Vertikaalijänne kasvoi 56 mm → 254 mm. Nyt X-kuvio on silmälle näkyvä, ei vaakasuora viiva.
• Kaksi uutta Mitat-parametriä: cap_beam_t = 48, cap_beam_w = 198. Ja uusi property cap_beam_z (yläpinta = kannattajan alapinta).
• Kolme uutta pytest-invarianttia (yhteensä 16/16):
• test_cross_brace_has_visible_angle — kallistus > 5°
• test_joist_rests_on_cap_beam — kannakkeen yläpinta = kannattajan alapinta
• test_cap_beam_below_deck — kannake + kannattaja täyttävät kannen alapuolisen tilan

Lisäykset v5:ssä

• Bugi #1 korjattu (kriittinen geometria): ristituen 3D-rotaatiosta poistettu virheellinen - 90. Aiemmin tukivinos seisoi pystysuoraan 1816 mm korkeana ja sen yläpää nousi 576 mm kannen yli. Nyt vinos sijaitsee oikein vyöhirsien välisellä alueella.
• Bugi #2 korjattu (vyöhirren sijainti): lower_waling_z muutettu water_level + 400 → water_level + 100. Aiemmin "alempi" vyöhirsi sijaitsi 46 mm ylempänä kuin "ylempi". Nyt alempi on todella alempana, vesirajan tuntumassa, ja X-ristituen vertikaalinen jänne kasvoi käytännössä nollasta järkevään.
• Refaktorointi: Mitat-luokkaan lisätty propertyt upper_waling_z, lower_waling_z, cross_attach_upper_z, cross_attach_lower_z. Nyt 3D-rakennus, sivu- ja päätynäkymä DXF:t lukevat kaikki samasta lähteestä — ei riskiä että jokin näkymä eroaisi muista.
• Kaksi uutta pytest-invarianttia (yhteensä 13/13):
• test_waling_levels_dont_overlap — alemman yläpinta < ylemmän alapinta
• test_cross_brace_fits_below_deck — kiinnityspisteet kannen alapuolella

Lisäykset v4:ssä

• Päätynäkymä DXF (laituri_paaty.dxf) — kolmas projektio, näyttää poikkileikkauksen yhden paaluparin kohdalla. Yhdessä pohja+sivu+pääty muodostavat täydellisen 3-näkymän standardin mukaisen skemaattisen suunnitelman.
• water_depth-property korjattu — aiempi kommentti väitti tuloksen olevan negatiivinen; tosiasiassa positiivinen (water_level − mud_level). Käyttöpaikan turha abs() poistettu.

Lisäykset v3:ssa

• 2D DXF-näkymät (laituri_pohja.dxf, laituri_sivu.dxf) — skemaattiset eivät täysi HLR-projektio. Avaa esim. LibreCAD, AutoCAD, FreeCADin Draft-työpöydällä.
• Yksikkötestit tests/test_mitat.py (11 testiä) — ajetaan komennolla uv run pytest. Suojaavat parametrimuutokset (esim. num_pile_pairs-skaalaus) geometrian rikkoutumiselta.
• .gitattributes — STEP/GLB/DXF binääriksi merkitty, ei diff-meluamista.

7. Avaaminen FreeCADissa (tarkistus)

File -> Open -> out/laituri.step

STEP-tiedosto avautuu komponentteina nimettynä Tree View -puuhun: Paalu_P1_L, Pohjalevy_P1_L_1, Vyohirsi_ylempi_L_0 jne.

Vaihtoehtoisesti web-katselu: avaa out/laituri.glb esim. https://gltf-viewer.donmccurdy.com/

8. Mitä tämä dokumentti EI sisällä (referenssi)

• Eurocode 5 -puurakenteiden tarkistus (kuormitukset, käyttörajatilat)
• Ankkurointimitoitus / pile-mitoitus
• Liitosvoimien laskenta (paalu-vyöhirsi, vyöhirsi-kannattaja jne.)
• 2D-piirustukset (pohja, sivut, leikkaukset) — laituri_3d.py:hin voi lisätä DXF-vienti
• Kustannuslaskenta — BOM tarjoaa lähtötiedot, hinnat lisättävä erikseen
• Lupakuvat / rakennustarkastusasiakirjat