* [[kalandus:juhend|Kasutusjuhend]]
* **Kasutusjuhend PDF-ks (koos piltidega)**
* [[kalandus:harrastus_export|Harrastuspüügi andmete eksport Excelist]]
====== Küsimused ======
* L1 kirjed raportites?!
* kuidas lahendada õiguste küsimus?
* et MEI inimesed näeksid vaid neile mõeldud mooduleid? või pole see probleem?
* raportid:
* loogika:
* raportid iga liigi ja piirkonna kohta eraldi või ka midagi üldisemat?iga liigi kohta eraldi
* piirkond = area või rectangle?üldiselt area (subdivision)
* kas eraldi raportid Harbor, Sea, Market või üle kõigi?EI
* tõlked: millised? kes?jääb inglise keel
* BITS
* HH, HE, HL, CA kirjed ongi erinevad FishFrame omadest?JAH
* kas olen tabelid teinud õige doku järgiJAH
* not null väljad, mis osades kirjetes siiski null:
* CA: age_rings
* HL: sub_factor, cat_identifier
* kuidas teha kuupäeva järgi otsingut (filtrit)?
* CA kirje
* size_category ja area_code vahel on üks nullirida ülearu FF näidises?!
* ja viimane väli (otolith_side) tundub puudu olevat
* andmete järjestus failides
* kas peab olema kindel või
* esimene rida on koos väljanimedega
* näidisfailid
* L1 tüüpi kirjete näidisfail
* iga mooduli kohta eraldi fail
* ka XML formaadis
* kas imporditud andmeid peab saama ka muuta?
* kas sellel on mingid piirangud?
* otsing/filter milliste andmete põhjal?
* millised raportid on vaja genereerida?
* [[file:///home/rene/smartcode/kala_teaduspyyk/ARU%20TEADANDM%20FINAL%202%2005.pdf|ARU TEADANDM FINAL 2 05.pdf]] faili lõpus peaksid vist olema...
* kas eksport võimalus ka zip-ga vajalik?võiks teha küll kunagi
====== TODO ======
===== Moodulid =====
==== FishFrame ====
* Moodul F: vette tagasilastud saagi (discard) kohta andmete kogumine
* Moodul H: bioloogilise valimi võtmine saagist: koosseis pikkuse ja vanuse järgi
* vanuseline koosseis
* keskmine pikkus
* keskmine kaal
* suguküpsus
* Moodul I: muu bioloogilise valimi võtmine
==== BITS/Datras ====
* Moodul G: kalabioloogilised teadusuuringud
* Läänemere rahvusvahelised katsetraalimised põhjatraaliga
* Kirjed:
* HH: import, listing, lisamine/muutmine
* HL: import, listing, lisamine/muutmine
* CA: import, listing, lisamine/muutmine
==== BALTDAT ====
* Moodul G: kalabioloogilised teadusuuringud
* Läänemere räimevaru hüdroakustiline mõõdistamine
* Kirjed:
* CI: import,listing, lisamine/muutmine
* SA: import, listing, lisamine/muutmine
* HH: import, listing, lisamine/muutmine
* HE: import, listing, lisamine/muutmine
* HL: import, listing, lisamine/muutmine
* CA: import, listing, lisamine/muutmine
==== Muu ====
* Moodul E: harrastuslik ja sportlik kalapüük
* **Kaheks kirjeks eraldi**
* Kalapüügist sõltumatud bioloogilised andmed (formaat teadmata...)
* Lõhe ja meriforelli noorjärkude seire jõgedes (mart.kangur@ut.ee, 6718959)
* **Kaheks kirjeks eraldi**
* **Rannikumere kalakoosluste seire (eschbaum@ut.ee, 7375095)**
* **Moodul J: majandusandmete kogumine laevade rühmade kohta**
==== Raportid ====
* **keskmiste arvutamisel tuleb kigepealt leida keskmised igas journey-s ja alles siis nende pealt kokku lõplik keskmine**
* **osad kalaliigid valikust puudu**
* Raporti genereerimiseks järgmine sisend: Kala, Piirkond, Periood
//Spets lk 14//
* Teaduspüüki ja proovivõttu iseloomustavad päringu positsioonid
* Analüüsitava kala pikkusjaotust iseloomustavad päringu positsioonid
* pikkusklassid kilul ja räimel 0.5 cm tagant, ülejäänudel 1 cm tagant
* Analüüsitava kala bioloogilisi näitajaid (sugu, suguküpsus, vanus, pikkus) iseloomustavad päringu positsioonid
* Püügistatistikat iseloomustavad päringu positsioonid
===== Üldine =====
* **Listing:**
* HH kirjete listingu juurde faili andmed
* HL ja CA kirjete juurde HH kirje andmed
* **Edit:**
* HL ja CA kirje lisamisel võimalikud vaikimisi väärtused HH-st
* kus võimalik, kasutame select boxe (catch category)
* area-te nimekiri? (kirejete muutmise/lisamise juures)
* kirje muutmisel link tagasi listingu peale
* kirjete muutmisel/lisamisel andmete valideerimine
* **logimine**
* **Raportid:**
* kuup2eva j2rgi piirang
* õigused paika (vaatamine/lisamine/muutmine/kustutamine)
* listingusse ette linnukesed kustutamise jaoks
* export + raportid: kuup2eva j2rgi piirang
* faili andmete muutmine???
* faili kustutamine
* ka ülekirjutamine
* kui sama nimi, siis pakume seda varianti
* imporditud failide salvestamine eraldi kataloogi???
* kas ka vigased???
* kirjete käsitisi sisestamisel ei panda useri id-d külge
* HH kirje juurde ka lisaja info
* HL, CA lisamisel vaja ka HH kirje id kaasa panna
* HH tabelis lon. minutes puudu!
* kirjete muutmine
* kirjete lisamine
* L1 kirjete haldamine
* fatal -> error
* BALTDAT
* **CI kirje cruise start ja end ajad on failides kujul DDMM**
* tuleb ka expordi puhul j2lgida!
* import puudu
* seos failiga puudu. Kas teha eraldi failide tabel?
* uue kirje tüübi lisamisel peab:
* selle ka CI kirje kustutamisel kustutama
* vastavate kirjete arvu CI listingusse (lingiks)
* klasssifikaatori "Kalad" juurde tekitaada ka NODC kood
^Nimi^Ladina keeles^NODC^
|Kilu|Sprattus sprattus|8747011701|
|Räim|Clupea harengus|8747010201|
|Tursk|Gadus morhua|8791030402|
|Lõhe|Salmo salar|8755010305|
|Meriforell|Salmo trutta|8755010306|
|Angerjas|Anguilla anguilla|8741010102|
||||
===== Import =====
* **TÄIDAME KA date VÄLJA!!!**
- tabelid andmebaasi (iga kirje tüübi jaoks eraldi)
- baasist NOT NULL piirangud ära (ise vastutavad, sest peab ju FF-st läbi käima
* dez failis ka muudatused teha ning võrrelda siis tulemsut ''create.sql'' failiga
- import (parse)
* **BALTDAT-i padding fields!**
- CSV
- XML
- zip
- kontrollimisel ja baasi strtolower()
- import andmebaasi
- faili uploade moodul
- logimine (logitabelid)
- uploade'tud failid salvestame eraldi kataloogi
===== Otsing/päringud/muutmine =====
- andmete näitamine standard listinguna
- otsing/filter
- otsing kuupäevade vahemiku järgi (https://kala/?call=fman_diarys_list&m_id=35&m=|31|35|)
===== Eksport =====
* **BALTDAT-i padding fields!**
* **BALTDAT CI kirjes kuupäevad kujul MMDD**
- CSV
* BALTDAT: kuup2vade splittimisega mingi jama, ilmselt tehakse 2006 -> 20-06 (MMDD)
* BALTDAT: faili nime arvutamine
- XML
- zip???
===== Features =====
* pärast andmete importi väljastame koondandmed (mitu kirjet jne)
* vea korral väljastame võimalikult täpse vea kirjelduse koos rea numbriga, kus see tekkis
* võimalus eksportida vaid osa andmeid (otsingu/filtri tulemus)???
====== Ülesehitus ======
* Töönduspüügi andmed on FishFrame formaadis
* Teaduspüügi andmed BITS/Datras formaadis
===== FishFrame =====
* **Kala bioloogilised näitajad (Commercial Samplings)**
* Mere andmed (Sea)
* //HL kirjed (Samples)//
* //CA kirjed (SMALKSs)//
* Turu andmed (Market)
* //HL kirjed (Samples)//
* //CA kirjed (SMALKSs)//
* Sadama andmed (Harbour)
* //HL kirjed (Samples)//
* //CA kirjed (SMALKSs)//
* **Maaletoodud/lossitud kala statistika (Landing Statistics)**
* L1 kirjed
===== BALTDAT =====
* **Kalabioloogilised teadusuuringud**
* Uurimisreisi üldinfo (CI)
* Akustilise mõõdistuse andmed (SA)
* Bioloogilised andmed
* katsetraalimise põhiandmed HH
* katsetraalimise lisaandmed HE
* kala pikkusjaotuse andmed HL
* CA kirjed
===== Muu =====
* **Harrastuslik kalapüük**
* //Custom formaadis kirjed//
====== Raportid ======
===== Kala bioloogilised põhinäitajad =====
==== Pikkusjaotus ====
CA kirje järgi saame teada kui suur % iga pikkusega kaladest on mingi vanusega:
^Length^Age^Count^%^Desc^
|50mm|1|3|100%|Kõik 50mm kalad on 1 aastased|
|60mm|0|3|11%|11% 60mm pikkustest on 0 aastased (3/(3+8+17) *100% = 11%)|
| |1|8|28%|28% 60mm pikkustest on 1 aastased|
| |2|17|61%|61% 60mm pikkustest on 2 aastased|
|70mm|1|4|22%|
| |2|5|28%|
| |3|9|50%|
Teeme HL kirjete põhjal koondtabeli, kus kirjas mitu kala on igas pikkusklassis:
^Len. class^Count^
|50mm|34|
|60mm|253|
|70mm|184|
Leiame jaotuse vanuse kaupa:
^Vanus^Keskmine pikkus^Kirjeldus^
|0|60 mm |Kuna teiste pikkustega 0 aastasi üldse pole, siis on ka keskmine 60mm|
|1|(50*34 + 60*253*0.28 + 70*184*0.22)/(34+253*0.28+184*0.22)=60.45 |50mm pikkused on kõik 1 aastased, 60mm pikksutest on 28% 1 aastased ja 70-stest 22%|
|2|(60*253*0.61 + 70*184*0.28)/(253*0.61+184*0.28)=62.5| |
|3|70 mm| |
====== Listingu ja editeerimise vormide conf ======
Näide:
$param['bits_records_hh'] = array(
"id_field" => "bits_rec_hh_id",
"sequence" => "bits_seq",
"slaves" => array("bits_records_hl" => "HL", "bits_records_ca" => "CA"),
// --- listingu parameetrid ---
"default_sort" => "date DESC",
"title" => "Katsetraalimised põhjatraaliga (HH kirjed)",
//special v2ljade formaatimiseks
"field_handler" => array(
"hl_cnt" => array("HL records", "SELECT count(*) FROM bits_records_hl HL WHERE HL.bits_rec_hh_id=bits_records_hh.bits_rec_hh_id", "fishframe_record
"ca_cnt" => array("CA records", "SELECT count(*) FROM bits_records_ca CA WHERE CA.bits_rec_hh_id=bits_records_hh.bits_rec_hh_id", "fishframe_record
),
);
$bits_records_hh = array(
"quarter" => array("Quarter", "text", 1),
...
...
"country" => array("Country", "text", 1, 1),
);
Kirjeldus:
$param[] = array(
"id_field" => ,
"sequence" => ,
"slaves" => array( => , => ),
// --- listingu parameetrid ---
"default_sort" => ,
"title" => ,
//special v2ljade formaatimiseks
"field_handler" => array(
=> array(, ,
),
);
$ = array(
=> array(, , , , , ),
);
====== Arendus ======
===== Test keskkond =====
* [[ https://fish.envir.ee]]
ssh fish.envir.ee -p 2223
cd /home/fish/fisherman
===== Live keskkond =====
* [[ https://kala.envir.ee]]
ssh kala.envir.ee -p 2223
===== Põhimõtted =====
* Kasutan sama baasi
* Baasi haldamine Dezigneriga
* tuleb teha update skriptid või siis lisada uued tabelid kohe mõlemasse
* ''psql_fish'' korraldus käsurealt viib test baasi sisse
* Uus funktsionaaluss kirjutatakse vana süsteemi peale moodulitena ning vajadusel täiendatakse olemasolevat
* broserist näed ära, mis lehte küsitkse
* arendus CVSi põhine
===== Framework =====
* ''moodules'' kataloogis on kood
* ''tempaltes/sources'' on smarty lauskpõhjad (**template'i uuendamisel tuleb 2x refresh teha!!!**)
* menüü: ''includes/menu.inc.php''
====== Uuendused ======
===== Lisatud =====
* includes/fishframe_utils.inc
* modules/fishframe*
* modules/reports_fishframe*
* modules/bits*
* modules/import*
* modules/export*
* modules/river_surveys*
* templates/source/bits*
* templates/source/fishframe*
* templates/source/reports_fishframe*
* templates/source/river_surveys*
===== Muudetud =====
* includes/menu.inc.php
* includes/function.php
* source/pisces_edit.tpl
* source/pisces.tpl
* modules/pisces.php
===== SQL =====
alter table pisces add column pisces_nodc text;
====== www.FishFrame.org ======
===== Dokumendid/juhendid =====
* [[http://dmz-web08.dfu.min.dk/FantaSea/FishFrame/Data/TestData/|Testandmete failid]]
* [[http://www.ices.dk/datacentre/datras/Manual%20BITS.pdf|Baltic International Trawl Survey (BITS) juhend]]
* [[http://www.ices.dk/datacentre/datsu/rptFmt.asp?Id=59|BITS formaadi kirjeldus (alates 2004)]]
* [[http://www.iode.org/marinexml/files/hersur-baltdat.pdf|HERSUR/BALTDAT Exchange Format Specification]]
===== Üldine info =====
Testkasutajad:
* TestReader@FishFrame.org, TestReader
* TestEditor@FishFrame.org, TestEditor
* TestAdmin@FishFrame.org, TestAdmin