quick-start guide for the plot interface, mdb interface ......7 quick-start guide document pi-mep...

1Quick-startGuideDocument Pi-MEPInterfaceQuick-startGuides 7May2019 Version1.1

Quick-startGuideforthePlotInterface,MDB

interface,MerginatorandSyntoolCustomer ESA/ESRINESAContractChangeNoticeNo 4000119132/16/I-SBoDocumentReference Pimep_quick_start_guide_plot-mdb-

merginator_interfacesVersion/Rev 1.1DateofIssue 7May2019 Function Name Signature DatePreparedby Consortium IFREMER&ODL 7May

2019

Checkedby

Projectmanager

NicolasReul,IFREMER

3Quick-startGuideDocument Pi-MEPInterfaceQuick-startGuides 7May2019 Version1.11Introduction 52PlotInterface 5

1.2GeneralLayoutoftheinterface 51.3SpatialdomainSelection 61.4PeriodSelection 61.5Selectionofthetypeofplots 71.5Timeseriesplots 81.6Scatterplots 101.7Mapping 11

3MDBInterface 123.1Match-upDataselection 133.2Plotfunctionalities 133.3Export 14

4Merginator 144.1Selectionofthedate,regionandcolorbar 154.2DynamicalMapping 164.2AnimationMapping,Filelistingandexports 16

5.Syntool 17


1 Introduction

This document is a quick start guide for the “plot interface” (§2), “MDB interface” (§3), “Merginator” (§4) and Syntool (§5) of the Pi-MEP platform.

2 Plot Interface

The plot interface allows extraction and plots of satellite and in situ SSS time-series at virtual buoys location, or some time series of statistics (averages, standard deviation, …) of SSS data or scatterplots of these data over some user-selected spatial and temporal domains. This tool relies on “Datalaps”which is the “time series real-timeextractor”: itallows fast access to data available given multi-criteria requests (over regional areasusually),togeneratetimeseriesplotsorstatisticalmaps,evenwhenusingdozenyearsofdata. It relies on Big Data technology for the efficient storage and manipulation ofgeoreferencedtimeseries. 1.2 General Layout of the interface

Theimageabovedescribesthelayoutoftheinterface.Theleftsidecontainsthecontrolsforselectinganareaandatimerange,selectingthesatellite/insituproductstobeanalysed,foraddinganewplotandfortheconfigurationofeachtypeofplot:(multi-)timeseries,scatterplots, and map charts (Hovmöller diagrams, and histograms shall be added in the nextupdatedversionoftheplatform).Therightsidecontainstheresultingplots.AllplotscanbeexportedasPNGimagestobeeasilyembeddedindocuments.Timeseries,scatterplotsandmapsprovidesomeadditionalinteractivity to focus on a subdomain (zoom/pan) or a specific data point (value undercursor).AmenualsooffersthepossibilitytodownloadthedataasCSVfilesforthesethreeplots.

6Quick-startGuideDocument Pi-MEPInterfaceQuick-startGuides 7May2019 Version1.11.3 Spatial domain Selection

Usingthemaponthetopleftmenuandthe“drawarectangle”selectiontool(middleleftblackrectanglepanelofthemap)andthezoomfunctions,theuser-chosendomainofanalysiscanbeselected.

By clicking on the blue rectangle (chosen domain) on the map, the latitude/longitudeboundariesoftherectangulardomainofanalysiscanbepreciselyenteredandselected.1.4 Period Selection

Theperiodofanalysiscanbedefinedbytheuserusingtheselectiontoollocatedjustbelowthemapontheleftmenu.Startingandendingdatecanbedefinedusing:“From”to“To”.


1.5 Selection of the type of plots

Usingtheblue“+”buttonontheleftmenu(atthebottomleft),theusercanchoosethetypeofplottobevisualizeontherightpanelsbeyond:

• TimeSeriesPlot• ScatterPlot• MapPlot

Each“cyancolour”menubarontheleftindicatesanewtypeofplotwhichwillappearontherightpanelswiththeappearingorderontherightasdefinedbytheorderofthesuccessive“cyan-bar”plots intheleftpanels.Theplotswillappearupdatedontherightpanelsonlyafterclickingonthe“updateplots”buttonifaselectionparameterhasbeenchangedbythetheuser.Eachplotcanberemovedbyusingthe“II”Removeplotbuttonontherightpartofeachcyancolorbar.


1.5 Time series plots

• Ifonthepreviousstep,theuserselectsa“TimeSeries”Plot,thenanewcyan-barmenuentitled“TimeSeries”willappearontheleftmenu.Thenameofthetimeseriescanbegivenbytheuserbyclickingandchangingthetitledirectlyinthe“cyan-bar”.

• Usingthe“TimeMonthly”buttonlocatedbelowthecyan-barmenu,theusercan

choosetheTimeaggregationmethodwitheither:Ø RawvaluesØ YearlyaØ MonthlyØ Daily

• Usingthe“Average”button,theusercanchoosethespatio-temporalstatisticswhichwillbeusedforgeneratingthetimeseriesusingeither:

Ø AverageØ SumØ MinØ MaxØ STD(standarddeviation)Ø count


• Selectingtheproductsandvariablestobevisualized.

The“+”smallbuttonbeloweachcyan-barontherightcanbeusedtoaddsomeproducts

tobevisualizedinthetimeseries.Whenclickingonthisbuttonanewvariablewillappearunderthe“cyanbar”.Theusercanthenmakehis/herownchoicebyselectingtheproductin the list/menuproposed. The list first shows all the Pi-MEP satellite SSS products andassociatedvariables,andthenfollowsinthe list thevariables includedintotheplatform-generatedmatch-upsatellite/insitufiles.Thenamingconventionisdefinedasfollows:mdb_nameofsatelliteSSSproduct_nameofinsitudata-nameofvariable.

Theusercanselectthecolorofthecurve(ontheright)foreachselectedproduct/variablebyclickingonthecoloredcirclelocatedontheleftofeachproduct.


• Exportingthedata

Thetimeseriesandplotsgeneratedbytheuserandvisibleontherightplotpanelscanbeexportedbytheusersinimageformat(PNG,JPEG,PDFSVG)orinnumericaltablesformat(csvandxls)usingthetoprightbuttonofeachplot.

• CreatingandsharingLinksofsomeuserpre-configured

plotinterfacepage:

Thestateoftheleftsideoftheinterface(i.e.thearea,timerangeandplots options) are stored in thewebpageURL, it is thereforepossibletocreatelinkstoapre-configuredplotsinterface.Thelinksofauser-preconfiguredpagecanbecopiedusingthelinksymbolonthebottomrightof the left-menu.These linkscan thenbeused inotherwebapplicationswhichdefine(orlettheuserdefine)similarparameters to provide a seamless transition between theapplications.1.6 Scatterplots

Usingtheblue“+”buttonontheleftmenu(atthebottomleft),theusercanchoosethetypeofplottobevisualizedontherightpanelsbeyond:


Iftheuserselectedthe“scatterplot”option:


Theusercan

• definethetitleoftheplot(similarlytothetimeseries)• selecttheX-axisdata(intheexampleaboveweshowtheSSSfromARGOatco-

localizedSMOS-M3-BEC.v2-9d/ARGOpairsfromthematch-updatabase)• selecttheY-axisdata(intheexampleabovetheSSSfromSMOSatco-localized

SMOS-M3-BEC.v2-9d/ARGOpairsisselected)• selectthecolorwhichwillshowathirdvariablecharacterizingthesatellite/insitu

SSSpairsoverlayinthescatterplot(intheexampleabovea“blues”colorbarisusedtorepresentthedistancetocoastatco-localizedpairs),thecolorscaleandrangecanbeselected.

•

Alltheotherfunctionalities(export,links,etc..)aresimilartothefunctionalitiesdescribedforthetime-seriesplots.

1.7 Mapping Usingtheblue“+”buttonontheleftmenu(atthebottomleft),theusercanchosethetypeofplottobevisualizedontherightpanelsbeyond:


Iftheuserselects“MapPlot”then


Theusercan

• definethetitleoftheplot(similarlytothetimeseries).Intheexampleabovethetitleis“SatelliteSSSSTDmap”

• selectthetheproducttobemappedontheselectedregion(intheexampleaboveweshowtheSSSfromCATDS-LOCEANSMOSSSSLevel3v3products)

• selectthestatisticstoevaluatedforthemapping(intheexampleabovethestatisticsselectedis“STD”)Alltheotherfunctionalities(export,links,etc..)aresimilartothefunctionalitiesdescribedforthetime-seriesplots.

3 MDB Interface

Searchingmatch-upsandextractingtheassociateddatacanbeperformedusingtheMDBqueryinterface,awebpagewhichcontainsaformtodefinethesearchfilters,providesmeanstovisualizetheresultsasplotsornumericaltablesandletstheuserdownloadthemasCSVfiles.


SketchoftheMDBqueryinterfacemenu(ontheleftofthepages)3.1 Match-up Data selection Beforeperformingasearchoranextraction,theinterfacerequirestheusertoselectanin-situ/satellitecouple,anarea(fromthelistofpre-setsPi-MEPregion)andatimerange.AuserdefinedspatialdomaincanalsobeselectedusingtherectangleandzoomfunctionsonthemapMoreadvancedfiltersarealsoavailablebutarelockeduntilthein-situ/satellitecouplehasbeenselectedsincesomeoptionsarespecifictoasatelliteoranin-situsensor:● Depthofin-situmeasurements(between0and10m)● Distancetocoast(from0to2000km)● SSTrangeoftheextractionfrominsitu(from-2.1to35°C)● SSSrangeoftheextractionfrominsitu● Temporallaginthecollocationprocessbetweenin-situdateandSSSsatellitedata(between0and12h)● Spatiallaginthecollocationprocessbetweenin-situdateandSSSsatellitedata(between0and100kms).● RealtimeorDelaymodeorboth(ARGO)● CMORPHrainrateattimeandlocationofthein-situmeasurement:filterifitissuperiororinferiortoa

specifiedthreshold(0to25mm/h)

● ASCATwindspeedattimeandlocationofthein-situmeasurement:filterifitissuperior/inferiortoaspecifiedthreshold(0to30m/s)

● CMORPHrainratevaluesduringthe(1to7)daysbeforetimeofthein-situmeasurement(samelocation):filterifsumormeanormaxorstdofrainrateissuperiororinferiortoaspecifiedthreshold(0to25mm/h)

● ASCATwindspeedvaluesduringthe(1to7)daysbeforetimeofthein-situmeasurement(samelocation):filterifmeanormaxorstdofwindspeedissuperiororinferiortoaspecifiedthreshold(0to30m/s)

● Differencebetweenin-situandsatelliteSSSvaluesrange(-5to5).

3.2 Plot functionalities


Theplotsdisplayedintheinterfaceinclude:

● timeseriesofthemonthlyaverage(inblack)andstandarddeviation(inblue)ofthedifferencein-situ/satelliteΔSSSovertheselecteddomain

● aplotoftheinsituandsatelliteSSSvaluesatmatch-uppairsmonthlyaverageovertheselecteduserdomain

● ascatterplotofin-situvssatelliteSSSAswiththeplotsinterface,thestateoftheconfigurationpanel(leftsideofthesketch)isstoredintheURLtoallowthecreationoflinksthatleadtoapre-configuredMDBqueryinterface.3.3 Export

Numerical tables (csv, xls) show statistics about the extractedmatch-ups: number ofcollocations, mean bias, variance and root-mean-square deviation and the time seriesthemselves.The timeseriesandplotsgeneratedby theuserandvisibleon therightplotpanelscanbeexportedbytheusersinimageformat(PNG,JPEG,PDFSVG)orinnumericaltablesformat(csvandxls)usingthetoprightbuttonofeachplot.ThefilteredMDBdatacanalsobedirectlyextractedincsvformatusingthe“downloadcsv”menuontheleft.

4 Merginator

Thistoolisusefultoexplorespatialpatternsofnumerousdatasetsataglance.Forthemomenttheproductsshownintheinterfacearepre-selected.Amenuwillbesoonaddedtobeablevisualizingotherdatasets.


Thedatamapsshownbytheinterfaceare:

1)TheL3/L4SSSfromsatelliteproductswithtemporalaveragingperiodwhichincludethedatechosenbytheuser

• SMOSCATDS/LOCEANLevel3-9days• SMOSCATDS/LOCEANLevel3-18days• SMOSBECLevel3OA-9days• SMOSCATDS/IFREMERL4aweekly• SMOSCATDS/OP• SMAPJPLLevel3-8daysV4• AquariusJPLLevel3-7daysV5

2)TheInsituObjectivelyanalyzedSSSISASandtheHYCOMmodelSSS3)TheSSS,windspeed(ascat),sst(ECMWF)andaccumulatedrain(CMORPH)4.1 Selection of the date, region and colorbar Inthetopleftmenu,theusercanselectthecentraldatewhichisusedtovisualizedalltheproductswithinsomepre-selectedregionaswellasthecolorbarrangestobeusedforthedifferentvariablesshownonthemaps.


4.2 Dynamical Mapping Byclickingonthe“Dynamic”buttononthetoprightmenu,theusercanalsochosetozoomdynamicallyonallfieldssimultaneously4.2 Animation Mapping, File listing and exports Byclickingonthelinksymbolonthetoprightofeachplottheuserwillseeanewpageopening:


Theusercanselectthetimesampling/averagingofthemapsonofthetoprightpanelmenu(day,month,year).Thehistogramthenshowsthenumberofproductspersampledperiod.Ananimationcanbegenerateddirectlybytheuser,toseethemapstemporalevolution.Byusingthefilters&options,theusercanselectthecolorbarandrangeaswellastheprojectionsofthemaps.Byclickingonthe“link”foundonthemap,theuseropensanewwindowwiththeimagewhichcanbesaved.Thefilelistoftheproductsfoundovertheselectedtimeperiodanddomaincanbeaccessedontheleftmenuusingthe“Downloadfilelist”

5. Syntool ThePi-MEPdataportalisavailabletoanyoneusingarelativelyrecentwebbrowserwithoutneedtologinhttp://pimep.oceandatalab.com/(Figure1)~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~Warning!Iftheportalwon’tloadyoumightneedtoemptyyourcacheorfollowinstructions:https://www.thesslstore.com/blog/clear-hsts-settings-chrome-firefox/TheportalistemporarilyonOceanDataLabserverbutisaccessingdataatIfremerthatpreventsustousehttpsprotocol,soifyouhavebeenonthepreviousversionoftheportalusinghttps,yourbrowserremembersitandmaycausethiserror.~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Theselectionorproductstobedisplayediscontrolledbytheleft“Products”Menu(Figure2).ThedateandtimeselectioniscontrolledbytheLowerBanner(timeline).Themousescrollcontrolszoomlevelswhileonthemapandtimewhileonthetimeline.Dateswhenselectedproductsareavailableappearinwhite,orgreyotherwise.Whenactivatingthecolocationtrigger©,dateswhenallselectedproductsareavailablewithinthetimerangeandthevisiblemapareaappearinred.


ThisinterfaceismeanttobeintuitivewithtooltipsavailablewhenhoveringbuttonsandcanalsobecontrolledusingKeyboard“Shortcuts”detailedintheTopMenuBanner.Hereafterthemainfunctionalities:


The“Settings”menu(Figure3)canbeusedtocontroltransparency,layerordering,colorbars,andadvancedfilters.The“Share”buttongeneratesashortURLpermalinkthatcanbeusedtosharethesameviewoftheportaltosomebodyelse.Fromthetopbanneronecanalsosendsomefeedbackorchangethebackgroundmapfromsatelliteimagerytomaps.


WhenselectingdriftersorTSGproducts,onedayoftrajectoryisshowndependingontheselecteddateinthebottombannertimeline,ifthetimerangeissmallerthandaily,thetimewindowishighlightedwithathickerlinewithadiamondshapeindicatingthepositionofthedrifter/shipattheselectedtime(Figure4).Asimplemouseclickonagivendriftertrajectory,asanyotherproducts,canbeusedtoselectitandtherebydisplayingit’sdatasetname(Figure5).


The“Hotspots”Menuallowtogoquicklytosomepredefinedinterestingcases(Predefinedhotspotsifany),ortosavetheportalstatetocomebacktoitatalatertime(localhotspots).

23Quick-startGuideDocument Pi-MEPInterfaceQuick-startGuides 7May2019 Version1.1Creationoflocalhotspotisaseasyastypinganameforthishotspotandclickingon“Create”.Anyhotspotcanbeshareusingthebuttonattherightsideofeachhotspotline(seeFigure6)

quick-start guide for the plot interface, mdb interface ......7 quick-start guide document pi-mep...

Documents