diff --git a/CHANGELOG.md b/CHANGELOG.md index c358fa2..4664081 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -41,6 +41,12 @@ release path documented in [`TODO.md`](TODO.md). can be compared across the whole window without repeating the overlay step per panel. Overlaying no longer rewrites the panel's Y-axis label: it stays on the active panel's parameter instead of reverting to "Fit parameter". +- Overlaid curves get smart legend labels derived from each data set's scan + variable: an energy scan is tagged with its constant temperature, a + temperature scan with its energy for LE-µSR or its field for bulk µSR, and a + field scan with its temperature. Legend entries renamed directly in the plot + are remembered, so Refresh keeps the user's labels instead of rebuilding the + defaults. - Remembered parameter-plot configurations are no longer restored silently. The **Choose X axis** dialog now always appears, and a **Configuration** dropdown lists saved configurations whose parameter set matches the current diff --git a/docs/_build/html/_sources/parameters-plots.rst.txt b/docs/_build/html/_sources/parameters-plots.rst.txt index f81ad5b..04fbc2c 100644 --- a/docs/_build/html/_sources/parameters-plots.rst.txt +++ b/docs/_build/html/_sources/parameters-plots.rst.txt @@ -88,6 +88,17 @@ layout choice. Panels share the chosen X axis. The toolbar holds: Adding files this way is the same overlay mechanism as **Overlay data sets** in *Plot options*; the toolbar shortcut just applies the additions to all panels instead of the active one. + +Overlaid curves get a *smart legend* label that says which physical state +each scan represents instead of only a file name. The label is derived from +the data set's own scan variable and its constant coordinate: an energy scan +(``dataE`` varying) is tagged with its fixed temperature (``(T = 300 K)``), a +temperature scan with its fixed energy for LE-µSR (``(E = 12 keV)``) or with +its field for bulk µSR (``(B = 100 G)``), and a field scan with its fixed +temperature. When no fixed coordinate is present the plain file label is used. +You can also rename a legend entry directly in the plot; a Refresh then keeps +your name instead of rebuilding the default. + * **Plot options** -- expand the layout, X, parameter, style, and displayed series controls for the active panel. diff --git a/docs/_build/html/parameters-plots.html b/docs/_build/html/parameters-plots.html index ecbc0e6..6e70b9d 100644 --- a/docs/_build/html/parameters-plots.html +++ b/docs/_build/html/parameters-plots.html @@ -182,6 +182,17 @@ the active panel’s parameter rather than reverting to a generic label. Adding files this way is the same overlay mechanism as Overlay data sets in Plot options; the toolbar shortcut just applies the additions to all panels instead of the active one.

+ +

Overlaid curves get a smart legend label that says which physical state +each scan represents instead of only a file name. The label is derived from +the data set’s own scan variable and its constant coordinate: an energy scan +(dataE varying) is tagged with its fixed temperature ((T = 300 K)), a +temperature scan with its fixed energy for LE-µSR ((E = 12 keV)) or with +its field for bulk µSR ((B = 100 G)), and a field scan with its fixed +temperature. When no fixed coordinate is present the plain file label is used. +You can also rename a legend entry directly in the plot; a Refresh then keeps +your name instead of rebuilding the default.

+ diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js index adb965e..a06bc3d 100644 --- a/docs/_build/html/searchindex.js +++ b/docs/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"A first fit":[[7,"a-first-fit"]],"Command log":[[11,"command-log"]],"Configuration sharing":[[0,null]],"Constraints":[[1,null],[1,"id1"]],"Contents":[[4,null]],"Custom parameters":[[1,"custom-parameters"]],"Desktop installation":[[2,"desktop-installation"]],"Editing trace styles":[[8,"editing-trace-styles"]],"Example: couple the magnetic field to the Larmor frequency":[[1,"example-couple-the-magnetic-field-to-the-larmor-frequency"]],"Execution details":[[11,"execution-details"]],"File handling":[[6,"file-handling"]],"Fit and Plot":[[12,"fit-and-plot"]],"Fit model":[[12,"fit-model"]],"Fit options":[[12,"fit-options"]],"Fit or plot will not start":[[14,"fit-or-plot-will-not-start"]],"Fit range":[[12,"fit-range"]],"Fitted parameters look wrong or unchanged":[[14,"fitted-parameters-look-wrong-or-unchanged"]],"General notes":[[5,"general-notes"]],"Getting started":[[2,null]],"Glossary":[[3,null]],"Keyboard shortcuts":[[5,null],[8,"keyboard-shortcuts"]],"MSR editor":[[5,"msr-editor"],[6,null]],"Multi-group asymmetry fits":[[13,"multi-group-asymmetry-fits"]],"Notes":[[0,"notes"]],"On the desktop":[[0,"on-the-desktop"]],"On the web":[[0,"on-the-web"]],"Opening the web edition":[[2,"opening-the-web-edition"]],"Outcome dialog":[[11,"outcome-dialog"]],"Overlay data sets (multiple files in one panel)":[[8,"overlay-data-sets-multiple-files-in-one-panel"]],"Overview":[[7,null]],"Ownership: GUI or editor":[[6,"ownership-gui-or-editor"]],"Parameter plot hangs on \u201cPreparing plot files\u201d":[[14,"parameter-plot-hangs-on-preparing-plot-files"]],"Parameter plot is empty or missing data":[[14,"parameter-plot-is-empty-or-missing-data"]],"Parameter selection (Parameters tab)":[[5,"parameter-selection-parameters-tab"]],"Parameter-plot window":[[5,"parameter-plot-window"]],"Parameters and parameter plots":[[8,null]],"Per-run statistics":[[12,"per-run-statistics"]],"Plot options":[[8,"plot-options"]],"Preferences":[[10,null]],"Prerequisites":[[2,"prerequisites"]],"Preview":[[1,"preview"]],"Remembered plot configurations":[[8,"remembered-plot-configurations"]],"Reporting problems":[[14,"reporting-problems"]],"Restored configuration differs from the original machine":[[14,"restored-configuration-differs-from-the-original-machine"]],"Result files":[[11,"result-files"]],"Results and diagnostics":[[11,null]],"Run log window":[[11,"run-log-window"]],"Run selection":[[12,"run-selection"]],"Running the desktop app":[[2,"running-the-desktop-app"]],"Runs and fitting":[[12,null]],"Selecting parameters for plotting":[[8,"selecting-parameters-for-plotting"]],"Series fit actions":[[12,"series-fit-actions"]],"Some links start with a different prefix":[[14,"some-links-start-with-a-different-prefix"]],"Support":[[2,"support"]],"Template and series presets":[[8,"template-and-series-presets"]],"The Choose X axis dialog":[[8,"the-choose-x-axis-dialog"]],"The Quick Start guide":[[2,"the-quick-start-guide"]],"The Shared column":[[8,"the-shared-column"]],"The parameter table":[[8,"the-parameter-table"]],"The parameter-plot window":[[8,"the-parameter-plot-window"]],"The status bar":[[11,"the-status-bar"]],"Troubleshooting":[[14,null]],"Two editions":[[7,"two-editions"]],"Under the hood":[[7,"under-the-hood"]],"View settings":[[12,"view-settings"]],"Web and desktop editions":[[9,null]],"Web page cannot load data":[[14,"web-page-cannot-load-data"]],"What is shared":[[0,"what-is-shared"]],"What you get":[[7,"what-you-get"]],"Workflow":[[6,"workflow"]],"muSRFlow User Manual":[[4,null]],"t0 / background":[[13,null]],"\u201cNothing to fit\u201d":[[14,"nothing-to-fit"]]},"docnames":["configuration-sharing","constraints","getting-started","glossary","index","keyboard-shortcuts","msr-editor","overview","parameters-plots","platforms","preferences","results-diagnostics","runs-fitting","t0-background","troubleshooting"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["configuration-sharing.rst","constraints.rst","getting-started.rst","glossary.rst","index.rst","keyboard-shortcuts.rst","msr-editor.rst","overview.rst","parameters-plots.rst","platforms.rst","preferences.rst","results-diagnostics.rst","runs-fitting.rst","t0-background.rst","troubleshooting.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"":[0,3,5,6,8,10,12,13,14],"0":12,"01":12,"012":11,"1":[8,11,12,13],"100":12,"101":13,"103":13,"12":12,"16":12,"1998":12,"2":[8,12,13],"21":12,"24":12,"25":12,"3":[8,12,13],"4":[12,13],"5":12,"514":[3,12],"515":[3,12],"516":12,"520":12,"525":12,"540":12,"7":12,"8":12,"A":[0,1,3,4,8,10,11,12,13,14],"For":[2,6,8,11,12,13],"If":[0,4,8,11,12,14],"In":[5,7,8,14],"It":[0,1,4,6,7,11],"Its":[5,7],"On":[2,3,4,6,7,9,11,12,14],"One":[3,12],"The":[0,1,3,4,5,6,7,9,10,12,13,14],"Then":8,"There":2,"These":4,"To":[1,12],"With":[5,8],"_asi":10,"_par":0,"_singlehist":10,"abov":8,"abragamco":12,"accept":14,"access":9,"accumul":12,"across":[7,8,10,13],"action":[0,3,4,5,7,8,10,11,14],"activ":[2,5,6,7,8,14],"actor":6,"actual":[0,12,13],"ad":[8,10,12],"add":[1,5,8,11,12,14],"addit":8,"addrun":[3,12],"adjust":[7,8,13],"affect":8,"after":[0,8,12,14],"afterward":[8,11],"again":[7,8,12,14],"against":[8,14],"aggreg":[11,12],"agre":[13,14],"align":8,"all":[2,3,8,11,12,14],"alpha":12,"alreadi":[2,8,12],"also":[2,6,8],"alwai":8,"amplitud":[8,12],"an":[0,1,2,3,4,6,7,8,10,11,12,13,14],"analysi":[0,3,6,7,11,14],"anchor":5,"ani":[1,6,7,8,9,11,12,13],"anoth":[0,3,7,8,14],"anyon":0,"anyth":[4,10],"apod":[3,12],"app":4,"appear":[2,8,11],"append":[3,10],"appimag":2,"appli":[0,1,3,5,8,9,12],"applic":4,"approxim":10,"ar":[0,1,2,4,7,8,10,12,13,14],"area":[5,11],"argument":11,"arithmet":1,"around":4,"arrang":[0,8],"artifact":[6,9,10,11],"ask":[6,8],"assign":8,"asymmetri":[4,10,12],"attempt":[6,14],"authorit":[11,12,14],"auto":[8,10],"automat":[3,5,8,12],"auxiliari":9,"avail":[0,1,4,8],"avoid":[1,10],"awar":2,"ax":[5,8],"axi":[4,12,14],"back":[6,8,12,13],"background":[4,7],"backward":[0,12],"bar":[0,2,4,5,7,8,12,14],"base":8,"becom":[1,6,8,12],"been":5,"befor":[1,8,12,14],"behaviour":[4,11,13],"behind":[8,9],"below":[11,12],"bench":14,"besid":9,"best":[11,12],"between":[5,8,12],"beyond":8,"bfield":1,"bg":[7,13],"bin":[12,13],"binari":10,"bind":1,"blob":8,"block":[1,3,11,12],"bold":8,"both":[1,3,4,7,8,9,13,14],"bottom":11,"box":[5,8],"browser":[0,2,3,4,7,8,9,14],"bug":2,"build":[2,4,8,10],"built":[4,6,8],"button":[0,1,2,3,4,6,7,8,9,11,12],"c":[0,14],"cach":12,"calcul":12,"came":12,"can":[0,1,3,6,7,8,12],"cancel":10,"cannot":[0,4,8,11,12,13],"canva":[3,7,9,11,12],"canvas":3,"cap":8,"carri":[0,3,8,12,14],"cfg":14,"cgi":[2,4,9,14],"ch":[0,2,10,14],"chain":0,"chang":[1,6,8,10,12,14],"chapter":[2,7,9],"chart":5,"check":[8,14],"checkbox":8,"checkout":2,"chip":[3,8,12,14],"choic":[8,12],"choos":[0,1,2,4,7,10],"chosen":[8,12],"clash":10,"classic":[7,12],"clear":8,"click":[5,6,7,8,11,12,14],"clipboard":5,"clone":8,"close":[5,6,8,10,11,14],"closest":8,"cmd":[5,8],"code":11,"collaps":[11,13],"colleagu":[0,8],"collect":[7,11],"collid":5,"colon":12,"colour":8,"column":[3,12,14],"combin":12,"come":9,"comma":12,"command":[3,4,7,9,10,12,14],"commit":8,"common":[8,13],"compact":[0,14],"companion":3,"compar":8,"compat":12,"complet":[0,6,11],"compon":[0,1,8,12,14],"compos":12,"compress":[0,3,14],"concentr":4,"concern":9,"concret":8,"configur":[3,4,7,9,10],"confirm":[6,8,12,14],"constant":1,"constrain":1,"constraint":[0,3,4,6,7,8,12],"contact":[2,4,14],"contain":[1,8,11],"content":[8,12],"context":11,"contigu":[8,12],"contrast":12,"control":[1,6,7,8,13,14],"conveni":12,"convent":10,"converg":[11,12],"convert":7,"copi":[0,6,8,9],"correct":[3,12],"correspond":2,"could":[0,14],"count":[8,12],"coupl":4,"covari":12,"cover":[4,14],"creat":4,"cross":8,"ctrl":[5,8],"current":[0,2,3,6,7,8,10,12,13,14],"cursor":5,"custom":[4,7,8,12],"cycl":12,"dai":7,"damp":8,"dash":12,"dat":[0,3,7,8,11],"data":[0,2,3,4,7,9,10,11,12,13],"dc":12,"default":[8,10,12,13],"defin":1,"degrad":8,"degre":12,"delet":8,"depend":[5,12],"deploi":14,"deploy":[2,4],"deriv":10,"describ":[2,3,4,8,12],"deselect":[5,8],"desk":4,"desktop":[3,4,6,7,8,10,11,12,14],"desktop_deploy":[2,4],"detail":[4,7,12,14],"detect":10,"detector":[12,13],"develop":10,"diagnos":11,"diagnost":4,"dialog":[0,2,3,4,7,9,10,14],"did":[11,12],"differ":[4,7,9,12,13],"direct":[3,12],"directli":[1,6,7,8],"directori":[0,7,9,10,11,14],"disabl":12,"disagre":13,"disappear":[8,12],"disclosur":12,"disk":[0,6,12],"dismiss":8,"displai":[3,6,7,8,9,11,12],"dist":2,"distinct":[8,12,13],"do":[6,12,13,14],"doc":[2,4],"document":[2,3,4,5,6,7,10,11,12,13,14],"doe":[0,4,6,7,8,11,12],"dolli":12,"domain":[3,12],"dot":12,"download":[5,8,11],"drag":8,"draw":[0,8],"drawn":[3,7,8,9,12],"drive":8,"driven":5,"dropdown":[1,8,12,14],"dump_head":[3,4,7,10],"dynam":12,"e":[2,12],"each":[2,3,8,11,12],"edit":[3,4,5,6,10,12,13,14],"editor":[3,4,7,8,9,12,14],"effect":[10,13],"effici":12,"eight":8,"either":12,"electron":[0,2,4,6,7,9,10],"element":11,"elig":12,"embed":[0,8],"empti":[4,8,10,12],"enabl":[8,10,12],"encod":[0,7],"end":[4,8,12],"endpoint":[9,14],"engin":[3,7,9],"enter":[2,5,6,7,12],"entri":[3,5,8],"equal":1,"equival":8,"eras":11,"error":[0,8,12],"esc":[5,8],"even":8,"event":5,"everi":[3,5,7,8,10,11,12,13,14],"everydai":5,"everyth":[1,12],"evolv":7,"exact":[8,12],"exactli":[1,8],"exampl":[4,8,10,11,12,13],"exce":12,"execut":[4,7],"exist":[0,10,12,13],"exit":11,"expand":[2,7,8,12],"expert":[7,13],"explain":11,"explicit":8,"explicitli":9,"exponenti":12,"exponentialbessel":12,"exponentialco":12,"expos":[0,6,7,9,10,12,14],"express":[1,12],"extern":2,"extra":8,"factor":12,"factori":7,"fail":[11,12,14],"fast":3,"fastest":14,"featur":10,"fed":7,"feed":[7,8,11],"fetch":14,"few":5,"fft":[0,3,7,12],"field":[4,5,6,8,10,12,13],"file":[0,2,3,4,7,9,10,12,13],"final":7,"finish":[11,14],"first":[0,2,4,6,8,10,12,14],"fit":[0,1,2,3,4,6,8,9,11],"fitparamet":3,"fix":[9,12,13,14],"flame":12,"flip":12,"flow":12,"focu":5,"focus":[5,8],"follow":12,"forget":8,"form":[3,12,14],"format":3,"forward":[12,13],"four":8,"fourier":[3,12],"fragment":[0,3],"frame":[3,12],"free":12,"frequenc":[3,4,8,10,12],"fresh":6,"freshli":12,"from":[0,1,2,3,4,5,6,7,8,9,10,11,12,13],"frq":1,"full":[5,7,8,11],"function":[1,3,12],"further":12,"g":[2,12],"gain":12,"gamma_mu":1,"gauss":12,"gaussian":12,"gaussianbessel":12,"gaussianco":12,"gbgco":12,"gbgexp":12,"gbgsexp":12,"gbgzf":12,"gdktlf":12,"gener":[1,3,4,6,7,8,10,11,12,13],"get":[0,4,8],"give":11,"given":10,"glfexp":12,"glfsexp":12,"global":[3,8,12],"glossari":4,"good":13,"gp":12,"gpd":12,"gracefulli":8,"graphic":4,"grid":8,"group":[4,10,12],"grow":8,"guess":[3,7,8,10,13],"gui":[1,4,7,11,12,14],"guid":[4,7],"gyromagnet":1,"ha":[3,5,8,12,14],"hal":12,"hand":[5,6,8,11,12,14],"handl":[0,4,8,9],"hang":4,"happen":8,"harmlessli":0,"hash":0,"have":[8,12,13],"header":10,"health":14,"help":[4,9,14],"hess":12,"hide":[8,12],"highlight":[7,12],"hint":10,"hist":12,"histogram":[10,12,13],"hold":[5,8,10,12,13,14],"hood":4,"host":[2,13],"hover":11,"how":[7,12],"http":[0,2],"i":[1,2,3,4,5,6,7,8,9,10,11,12,13],"icon":[0,6],"ident":[0,8,12],"identifi":[8,12],"idl":11,"ignor":[0,5,14],"imaginari":12,"immedi":[0,1,8,11],"import":13,"includ":[1,8,12,14],"inconsist":13,"independ":[2,3,8,9,11,12,14],"indic":8,"individu":[8,12],"inform":12,"initi":[3,7,10],"inlin":[0,8,12],"input":[3,5],"insid":[3,7,12],"inspect":[4,7,11],"instal":[4,10,12,14],"instanc":0,"instead":[1,8,10,11,14],"instrument":[0,2,7,10,12],"interact":[5,7,8],"interfac":7,"invalid":11,"invok":11,"involv":14,"issu":2,"its":[0,2,3,7,8,9,10,11,12,13,14],"itself":8,"j":2,"join":3,"jsroot":[3,7,9,12],"just":[5,6,8],"keep":[6,8,11,12,13],"kei":[0,5,8],"kept":[11,12],"keyboard":4,"khz":12,"kt":12,"kubo":12,"label":[8,12],"lack":14,"lai":8,"lam_2255":8,"larg":11,"larger":8,"larmor":4,"lasso":5,"last":11,"later":[2,11,13],"layout":8,"ldktlf":12,"leak":8,"least":14,"leav":[8,10,12,13],"left":8,"legaci":[12,14],"legend":8,"lem":12,"let":8,"level":8,"lgkt":12,"lgktexp":12,"lgktsexp":12,"librari":9,"lifetim":12,"like":[1,13],"likelihood":12,"limit":[3,7,8,12],"line":[3,4,7,8,9,11,14],"linear":8,"link":[0,2,3,4,7,8,9,11],"linux":2,"list":[1,6,8,11,12,14],"liter":1,"live":[1,7,9,10,11,12],"llfexp":12,"llfsexp":12,"lmu":10,"load":[4,8,13],"local":[0,2,7,8,9,14],"locat":10,"lock":[6,14],"log":[4,7,12,14],"logarithm":[8,12],"long":0,"longer":8,"look":[4,7,10],"lose":12,"lower":8,"ltf":12,"machin":[0,2,4,7,11],"made":3,"magnet":4,"mai":[0,6,14],"mailto":[2,14],"main":[0,1,2,4,7,8,9,11],"make":12,"manag":7,"manual":[2,3,7,9],"map":8,"mark":[3,12],"marker":8,"match":[0,3,4,8,10,14],"matter":7,"max":12,"mc":12,"md":[2,4,14],"mean":[6,12],"measur":[3,8],"mechan":[3,8],"median":12,"medium":12,"menu":[6,7,9,10],"merg":12,"messag":[11,14],"metadata":[3,7,10],"mhz":12,"microsecond":12,"might":12,"migrad":12,"minim":12,"minimis":12,"mino":12,"minuit2":12,"mirror":4,"miss":4,"mix":13,"mode":[5,8,10,13],"model":[0,1,2,4,6,7,8,9,14],"modeless":[2,9,11],"modern":7,"modifi":13,"monochrom":8,"more":[7,8,12,14],"most":[5,8],"mous":5,"msr":[1,2,3,4,7,9,10,11,12,13,14],"msr2data":[0,3,4,7,10],"multi":[3,4,8,12],"multipl":6,"multipli":1,"muon":[1,3,7],"musrfit":[1,2,3,4,7,8,10,11,12],"musrfit_startup":10,"musrflow":[0,2,3,5,6,7,10,11,14],"musrus":[0,2],"musrview":[3,4,7,9,10,12],"must":[2,13,14],"name":[1,3,5,7,8,10,12],"nativ":[3,7,8,9,12],"ndf":[11,12],"need":[2,7,8],"neither":0,"never":[0,5,8,10,14],"new":[8,12,14],"newest":8,"newli":8,"next":[1,2,6,8,10,12,13],"node":2,"non":10,"none":12,"normal":[0,1,5,8,12,13],"note":[4,8,14],"noth":[0,2,4,12],"notic":11,"npm":2,"number":[2,7,8],"numer":[8,12],"object":12,"off":12,"offer":[8,11,12],"offset":12,"old":12,"oldest":8,"omit":8,"onc":[1,2,6,8,12],"one":[1,2,3,5,6,7,9,12,13,14],"ones":[2,12],"onli":[1,2,8,11,12,13,14],"onto":8,"opac":8,"open":[0,4,6,7,8,9,10,11,12,14],"oper":11,"opt":12,"option":[0,2,3,4,7,14],"order":[8,11,12,13],"ordinari":1,"organis":4,"origin":[4,8],"oscil":12,"other":[1,8,11,13],"otherwis":0,"out":[8,11,12],"outcom":[4,14],"outlier":12,"output":[3,10,11,12],"over":[7,10,11,12],"overlai":[0,14],"overlaid":[8,14],"overrid":[8,12],"overview":4,"overwrit":6,"own":[0,3,6,7,8,9,12],"ownership":[4,5],"pack":12,"packag":[2,4,7,11,12],"padlock":6,"page":[3,4,7,9,12],"pair":12,"palett":[0,8],"pan":[5,8],"pane":[1,11],"panel":[0,5,14],"par":[3,7,11,12],"par4":12,"par7":12,"paramet":[0,2,3,4,6,7,9,10,11,12],"parr":12,"part":[1,3,8],"parti":0,"pass":0,"past":[0,9],"pastel":8,"path":[0,2,8,9,10,12],"payload":0,"per":[1,8,9,11,13],"perform":14,"perman":11,"phase":[3,12],"phi":12,"physic":[7,12,13],"pick":8,"picker":8,"place":14,"plain":8,"plot":[0,3,4,6,7,9,11,13],"plotli":[5,8],"plottabl":14,"plu":[3,8,12],"point":[2,14],"pointer":8,"polici":12,"pop":11,"popul":[0,8],"portabl":[3,7,10],"power":12,"predefin":8,"prefer":[0,4,7,9,14],"prefix":[4,8],"prepar":[3,4,6,12],"prerequisit":4,"preselect":8,"present":13,"press":[1,2,5,7,8],"preview":[4,6,12],"previou":12,"previous":13,"primari":11,"print":3,"problem":4,"process":11,"produc":[0,2,3,7,8,9,11,12],"progress":12,"project":[2,3],"protocol":9,"provid":[5,7,8],"psi":[0,2,10,14],"public":10,"put":10,"q":[5,8],"qualiti":12,"question":2,"quick":[4,7,9],"ran":11,"rang":[0,3,4,5,6,7,8,13],"rate":12,"rather":[8,12],"ratio":[1,12],"raw":0,"re":[8,12,14],"reachabl":14,"read":[0,1,3,7,8,10,12,13,14],"readabl":[11,14],"readm":[4,14],"real":[6,8,12,14],"reason":14,"rebuild":[12,14],"rebuilt":[0,8],"recent":8,"recipi":0,"recognis":[6,8],"recolour":8,"record":[3,11,12,14],"recreat":0,"redraw":8,"refer":[0,1,3,7,12],"referenc":1,"refin":1,"refit":[3,8,12,14],"reflect":1,"refresh":[8,14],"regener":6,"regular":12,"reimplement":7,"reject":13,"relat":[0,1],"relax":12,"releas":2,"relev":[7,11],"remain":0,"rememb":[0,10],"remov":[1,8,12],"render":[1,7,8],"replac":[6,8,12],"report":[2,4,12],"reposit":8,"repositori":[2,4],"repres":1,"reproduc":[0,11],"request":8,"requir":[2,12],"reread":[8,14],"reset":[5,8,14],"resolut":[12,14],"resolv":[3,7,8,10,12,14],"respect":12,"rest":8,"restor":[0,3,4,7,8,9],"restyl":8,"result":[2,4,6,7,8,10,12,14],"return":[6,12,13],"reus":[3,12,14],"revert":8,"right":[2,7,8],"role":8,"root":[3,7,9,10,11,12,14],"rotat":[3,12],"rout":[8,12],"row":[1,8,12,13,14],"rpm":2,"rrf":[0,3,7,12],"run":[0,1,3,4,6,7,8,9,10,13,14],"runner":2,"runtim":2,"sai":9,"salman":[2,4,14],"same":[0,1,2,3,4,5,7,8,10,11,12,14],"save":[6,7,8,9,10,12],"scale":12,"scan":[0,8],"scana_par":8,"scanb_par":8,"scatter":8,"scope":8,"scratch":8,"search":10,"second":12,"section":[2,7],"see":[0,3,4,5,7,8,11,12,13,14],"seed":[3,10],"select":[0,2,4,6,7,11],"sender":0,"sensibl":10,"sent":0,"separ":[4,8,12],"sequenc":12,"seri":[3,4,11,14],"serial":8,"serv":2,"server":[0,2,4,6,7,8,9,10,11,14],"session":[0,2,7,10],"set":[0,3,4,5,6,7,9,10,13,14],"setup":[0,10,14],"sever":[8,12],"sgkt":12,"shadow":8,"share":[3,4,7,9,12,13,14],"shift":[5,8,13],"ship":0,"short":[2,7,11],"shortcut":4,"shorten":11,"should":14,"show":[1,3,6,7,8,10,11,12,13,14],"shown":[6,8,12],"side":[8,9,11,14],"signal":[3,12],"silent":[6,12],"simplex":12,"sinc":13,"singl":[0,3,7,8,10,12,13],"six":12,"size":8,"skip":[3,8,12,14],"slash":12,"slkt":12,"small":8,"so":[0,1,3,5,6,7,8,9,11,12,13],"some":[4,12,13],"someth":8,"somewher":10,"sourc":[0,6,8,14],"space":5,"special":3,"specialis":10,"specif":[8,9,10],"spectra":[3,7,9,11,12],"spectromet":12,"spectroscopi":[3,7],"speed":5,"spin":[3,12],"split":1,"spread":12,"squar":8,"stack":8,"stage":8,"stai":[8,11,12,13],"stand":12,"standard":[5,10,13],"stanza":0,"start":[3,4,7,8,9,10,11,12],"startup":[10,14],"state":[0,5,8,11,12],"static":12,"statist":[3,11],"statu":[4,12,14],"step":[3,7,8,9,12,14],"still":[8,12],"store":[10,13],"strategi":12,"stretch":12,"stretchco":12,"strictli":12,"stripe":[8,14],"strkt":12,"strktexp":12,"strktsexp":12,"strong":12,"style":0,"subtract":3,"success":[11,12],"suffix":[8,10],"sum":12,"summari":12,"summaris":12,"support":4,"surrend":6,"surviv":8,"swatch":8,"switch":12,"symbol":8,"sync":8,"synchronis":[7,11],"syntax":[1,12],"system":0,"t0":[4,7],"tab":[0,1,2,4,6,7,8,9,11,12,13],"tabl":[0,2,3,4,7,11,12,14],"take":[8,10,12,13],"target":0,"task":5,"templat":[6,11],"ters":11,"tesla":12,"text":[1,3,5,6,8,9,11,12,14],"tf":8,"than":[8,12],"thei":[1,2,4,5,7,8,11,12,13],"theirs":8,"them":[1,8,10,13,14],"theori":[1,3,12],"therefor":0,"thi":[0,1,2,3,4,6,7,8,9,10,11,12,13,14],"third":0,"those":[8,14],"three":[1,8,12],"through":[3,6,9,12],"tick":8,"time":[0,1,7,8,12,13],"titl":8,"togeth":12,"toggl":[5,8],"token":13,"tool":[2,3,4,5,7,9,10,14],"toolbar":[6,7,8,12],"top":[0,8],"total":8,"toward":8,"toyab":12,"trace":0,"track":2,"transform":[3,12],"transient":11,"treat":3,"tree":[2,7,9,10,12,14],"troubleshoot":4,"truth":6,"twice":[8,12],"two":[3,4,6,8,12,13,14],"type":[1,3,5,8,12],"typic":[1,7],"u":[5,8],"unaffect":12,"uncertainti":[3,8],"unchang":[4,13],"uncheck":[8,14],"under":[1,4,8,9,10,11,14],"underneath":8,"unexpect":11,"unifi":8,"uniform":12,"unit":[3,12],"unless":8,"unlock":[6,14],"unmatch":8,"unspecifi":12,"until":[6,14],"untouch":[0,12],"up":[5,8,11,12],"updat":[1,8],"upload":8,"upper":8,"url":[0,2,3],"us":[0,1,3,4,6,7,8,10,11,12,13,14],"usabl":11,"user":[8,9],"usual":[5,10],"valid":[12,14],"valu":[0,1,3,7,8,10,11,12,13,14],"vari":7,"variabl":0,"variant":12,"varieti":12,"verifi":[1,7,14],"version":14,"vertic":8,"via":[9,12],"view":[0,3,4,7],"viewer":[3,7],"visibl":[6,8],"visual":12,"vm":12,"wa":[0,6,8,11,14],"wai":[8,11,12,13],"warn":[12,14],"weak":12,"web":[3,4,6,7,8,10,11,12],"webpag":9,"well":[0,5],"went":11,"were":11,"what":[1,4,8,9,11,14],"whatev":0,"when":[0,2,8,10,11,12,13],"whenev":8,"where":[9,10,12,14],"whether":[5,8,11],"which":[3,6,8,12],"while":[0,5,6,8,10,11,12],"who":0,"whole":[8,11],"whose":[12,13],"win":[8,10],"window":[0,2,3,4,7,9,12],"within":8,"without":[0,1,8,10,11,12,13],"work":[0,2,5,7,8,10,12,14],"workflow":[1,4,7,9],"worst":[11,12],"would":[6,13],"wrap":[2,4],"writabl":14,"write":[2,3,6,7,10,12],"written":[10,13],"wrong":[4,11],"x":[4,5,12,14],"xml":[10,14],"y":[5,8,12],"year":[0,2,7,12],"yet":8,"you":[1,4,6,8,10,12,13,14],"your":[0,2,7,8,11,12],"zaher":[2,4,14],"zoom":[5,8],"\u00b5sr":7,"\u03bb\u2081":8,"\u03c7\u00b2":[11,12]},"titles":["Configuration sharing","Constraints","Getting started","Glossary","muSRFlow User Manual","Keyboard shortcuts","MSR editor","Overview","Parameters and parameter plots","Web and desktop editions","Preferences","Results and diagnostics","Runs and fitting","t0 / background","Troubleshooting"],"titleterms":{"A":7,"On":0,"The":[2,8,11],"action":12,"app":2,"asymmetri":13,"axi":8,"background":13,"bar":11,"cannot":14,"choos":8,"column":8,"command":11,"configur":[0,8,14],"constraint":1,"content":4,"coupl":1,"custom":1,"data":[8,14],"desktop":[0,2,9],"detail":11,"diagnost":11,"dialog":[8,11],"differ":14,"edit":[2,7,8,9],"editor":[5,6],"empti":14,"exampl":1,"execut":11,"field":1,"file":[6,8,11,14],"first":7,"fit":[7,12,13,14],"frequenc":1,"from":14,"gener":5,"get":[2,7],"glossari":3,"group":13,"gui":6,"guid":2,"handl":6,"hang":14,"hood":7,"i":[0,14],"instal":2,"keyboard":[5,8],"larmor":1,"link":14,"load":14,"log":11,"look":14,"machin":14,"magnet":1,"manual":4,"miss":14,"model":12,"msr":[5,6],"multi":13,"multipl":8,"musrflow":4,"note":[0,5],"noth":14,"one":8,"open":2,"option":[8,12],"origin":14,"outcom":11,"overlai":8,"overview":7,"ownership":6,"page":14,"panel":8,"paramet":[1,5,8,14],"per":12,"plot":[5,8,12,14],"prefer":10,"prefix":14,"prepar":14,"prerequisit":2,"preset":8,"preview":1,"problem":14,"quick":2,"rang":12,"rememb":8,"report":14,"restor":14,"result":11,"run":[2,11,12],"select":[5,8,12],"seri":[8,12],"set":[8,12],"share":[0,8],"shortcut":[5,8],"some":14,"start":[2,14],"statist":12,"statu":11,"style":8,"support":2,"t0":13,"tab":5,"tabl":8,"templat":8,"trace":8,"troubleshoot":14,"two":7,"unchang":14,"under":7,"user":4,"view":12,"web":[0,2,9,14],"what":[0,7],"window":[5,8,11],"workflow":6,"wrong":14,"x":8,"you":7}}) \ No newline at end of file +Search.setIndex({"alltitles":{"A first fit":[[7,"a-first-fit"]],"Command log":[[11,"command-log"]],"Configuration sharing":[[0,null]],"Constraints":[[1,null],[1,"id1"]],"Contents":[[4,null]],"Custom parameters":[[1,"custom-parameters"]],"Desktop installation":[[2,"desktop-installation"]],"Editing trace styles":[[8,"editing-trace-styles"]],"Example: couple the magnetic field to the Larmor frequency":[[1,"example-couple-the-magnetic-field-to-the-larmor-frequency"]],"Execution details":[[11,"execution-details"]],"File handling":[[6,"file-handling"]],"Fit and Plot":[[12,"fit-and-plot"]],"Fit model":[[12,"fit-model"]],"Fit options":[[12,"fit-options"]],"Fit or plot will not start":[[14,"fit-or-plot-will-not-start"]],"Fit range":[[12,"fit-range"]],"Fitted parameters look wrong or unchanged":[[14,"fitted-parameters-look-wrong-or-unchanged"]],"General notes":[[5,"general-notes"]],"Getting started":[[2,null]],"Glossary":[[3,null]],"Keyboard shortcuts":[[5,null],[8,"keyboard-shortcuts"]],"MSR editor":[[5,"msr-editor"],[6,null]],"Multi-group asymmetry fits":[[13,"multi-group-asymmetry-fits"]],"Notes":[[0,"notes"]],"On the desktop":[[0,"on-the-desktop"]],"On the web":[[0,"on-the-web"]],"Opening the web edition":[[2,"opening-the-web-edition"]],"Outcome dialog":[[11,"outcome-dialog"]],"Overlay data sets (multiple files in one panel)":[[8,"overlay-data-sets-multiple-files-in-one-panel"]],"Overview":[[7,null]],"Ownership: GUI or editor":[[6,"ownership-gui-or-editor"]],"Parameter plot hangs on \u201cPreparing plot files\u201d":[[14,"parameter-plot-hangs-on-preparing-plot-files"]],"Parameter plot is empty or missing data":[[14,"parameter-plot-is-empty-or-missing-data"]],"Parameter selection (Parameters tab)":[[5,"parameter-selection-parameters-tab"]],"Parameter-plot window":[[5,"parameter-plot-window"]],"Parameters and parameter plots":[[8,null]],"Per-run statistics":[[12,"per-run-statistics"]],"Plot options":[[8,"plot-options"]],"Preferences":[[10,null]],"Prerequisites":[[2,"prerequisites"]],"Preview":[[1,"preview"]],"Remembered plot configurations":[[8,"remembered-plot-configurations"]],"Reporting problems":[[14,"reporting-problems"]],"Restored configuration differs from the original machine":[[14,"restored-configuration-differs-from-the-original-machine"]],"Result files":[[11,"result-files"]],"Results and diagnostics":[[11,null]],"Run log window":[[11,"run-log-window"]],"Run selection":[[12,"run-selection"]],"Running the desktop app":[[2,"running-the-desktop-app"]],"Runs and fitting":[[12,null]],"Selecting parameters for plotting":[[8,"selecting-parameters-for-plotting"]],"Series fit actions":[[12,"series-fit-actions"]],"Some links start with a different prefix":[[14,"some-links-start-with-a-different-prefix"]],"Support":[[2,"support"]],"Template and series presets":[[8,"template-and-series-presets"]],"The Choose X axis dialog":[[8,"the-choose-x-axis-dialog"]],"The Quick Start guide":[[2,"the-quick-start-guide"]],"The Shared column":[[8,"the-shared-column"]],"The parameter table":[[8,"the-parameter-table"]],"The parameter-plot window":[[8,"the-parameter-plot-window"]],"The status bar":[[11,"the-status-bar"]],"Troubleshooting":[[14,null]],"Two editions":[[7,"two-editions"]],"Under the hood":[[7,"under-the-hood"]],"View settings":[[12,"view-settings"]],"Web and desktop editions":[[9,null]],"Web page cannot load data":[[14,"web-page-cannot-load-data"]],"What is shared":[[0,"what-is-shared"]],"What you get":[[7,"what-you-get"]],"Workflow":[[6,"workflow"]],"muSRFlow User Manual":[[4,null]],"t0 / background":[[13,null]],"\u201cNothing to fit\u201d":[[14,"nothing-to-fit"]]},"docnames":["configuration-sharing","constraints","getting-started","glossary","index","keyboard-shortcuts","msr-editor","overview","parameters-plots","platforms","preferences","results-diagnostics","runs-fitting","t0-background","troubleshooting"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["configuration-sharing.rst","constraints.rst","getting-started.rst","glossary.rst","index.rst","keyboard-shortcuts.rst","msr-editor.rst","overview.rst","parameters-plots.rst","platforms.rst","preferences.rst","results-diagnostics.rst","runs-fitting.rst","t0-background.rst","troubleshooting.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"":[0,3,5,6,8,10,12,13,14],"0":12,"01":12,"012":11,"1":[8,11,12,13],"100":[8,12],"101":13,"103":13,"12":[8,12],"16":12,"1998":12,"2":[8,12,13],"21":12,"24":12,"25":12,"3":[8,12,13],"300":8,"4":[12,13],"5":12,"514":[3,12],"515":[3,12],"516":12,"520":12,"525":12,"540":12,"7":12,"8":12,"A":[0,1,3,4,8,10,11,12,13,14],"For":[2,6,8,11,12,13],"If":[0,4,8,11,12,14],"In":[5,7,8,14],"It":[0,1,4,6,7,11],"Its":[5,7],"On":[2,3,4,6,7,9,11,12,14],"One":[3,12],"The":[0,1,3,4,5,6,7,9,10,12,13,14],"Then":8,"There":2,"These":4,"To":[1,12],"With":[5,8],"_asi":10,"_par":0,"_singlehist":10,"abov":8,"abragamco":12,"accept":14,"access":9,"accumul":12,"across":[7,8,10,13],"action":[0,3,4,5,7,8,10,11,14],"activ":[2,5,6,7,8,14],"actor":6,"actual":[0,12,13],"ad":[8,10,12],"add":[1,5,8,11,12,14],"addit":8,"addrun":[3,12],"adjust":[7,8,13],"affect":8,"after":[0,8,12,14],"afterward":[8,11],"again":[7,8,12,14],"against":[8,14],"aggreg":[11,12],"agre":[13,14],"align":8,"all":[2,3,8,11,12,14],"alpha":12,"alreadi":[2,8,12],"also":[2,6,8],"alwai":8,"amplitud":[8,12],"an":[0,1,2,3,4,6,7,8,10,11,12,13,14],"analysi":[0,3,6,7,11,14],"anchor":5,"ani":[1,6,7,8,9,11,12,13],"anoth":[0,3,7,8,14],"anyon":0,"anyth":[4,10],"apod":[3,12],"app":4,"appear":[2,8,11],"append":[3,10],"appimag":2,"appli":[0,1,3,5,8,9,12],"applic":4,"approxim":10,"ar":[0,1,2,4,7,8,10,12,13,14],"area":[5,11],"argument":11,"arithmet":1,"around":4,"arrang":[0,8],"artifact":[6,9,10,11],"ask":[6,8],"assign":8,"asymmetri":[4,10,12],"attempt":[6,14],"authorit":[11,12,14],"auto":[8,10],"automat":[3,5,8,12],"auxiliari":9,"avail":[0,1,4,8],"avoid":[1,10],"awar":2,"ax":[5,8],"axi":[4,12,14],"b":8,"back":[6,8,12,13],"background":[4,7],"backward":[0,12],"bar":[0,2,4,5,7,8,12,14],"base":8,"becom":[1,6,8,12],"been":5,"befor":[1,8,12,14],"behaviour":[4,11,13],"behind":[8,9],"below":[11,12],"bench":14,"besid":9,"best":[11,12],"between":[5,8,12],"beyond":8,"bfield":1,"bg":[7,13],"bin":[12,13],"binari":10,"bind":1,"blob":8,"block":[1,3,11,12],"bold":8,"both":[1,3,4,7,8,9,13,14],"bottom":11,"box":[5,8],"browser":[0,2,3,4,7,8,9,14],"bug":2,"build":[2,4,8,10],"built":[4,6,8],"bulk":8,"button":[0,1,2,3,4,6,7,8,9,11,12],"c":[0,14],"cach":12,"calcul":12,"came":12,"can":[0,1,3,6,7,8,12],"cancel":10,"cannot":[0,4,8,11,12,13],"canva":[3,7,9,11,12],"canvas":3,"cap":8,"carri":[0,3,8,12,14],"cfg":14,"cgi":[2,4,9,14],"ch":[0,2,10,14],"chain":0,"chang":[1,6,8,10,12,14],"chapter":[2,7,9],"chart":5,"check":[8,14],"checkbox":8,"checkout":2,"chip":[3,8,12,14],"choic":[8,12],"choos":[0,1,2,4,7,10],"chosen":[8,12],"clash":10,"classic":[7,12],"clear":8,"click":[5,6,7,8,11,12,14],"clipboard":5,"clone":8,"close":[5,6,8,10,11,14],"closest":8,"cmd":[5,8],"code":11,"collaps":[11,13],"colleagu":[0,8],"collect":[7,11],"collid":5,"colon":12,"colour":8,"column":[3,12,14],"combin":12,"come":9,"comma":12,"command":[3,4,7,9,10,12,14],"commit":8,"common":[8,13],"compact":[0,14],"companion":3,"compar":8,"compat":12,"complet":[0,6,11],"compon":[0,1,8,12,14],"compos":12,"compress":[0,3,14],"concentr":4,"concern":9,"concret":8,"configur":[3,4,7,9,10],"confirm":[6,8,12,14],"constant":[1,8],"constrain":1,"constraint":[0,3,4,6,7,8,12],"contact":[2,4,14],"contain":[1,8,11],"content":[8,12],"context":11,"contigu":[8,12],"contrast":12,"control":[1,6,7,8,13,14],"conveni":12,"convent":10,"converg":[11,12],"convert":7,"coordin":8,"copi":[0,6,8,9],"correct":[3,12],"correspond":2,"could":[0,14],"count":[8,12],"coupl":4,"covari":12,"cover":[4,14],"creat":4,"cross":8,"ctrl":[5,8],"current":[0,2,3,6,7,8,10,12,13,14],"cursor":5,"curv":8,"custom":[4,7,8,12],"cycl":12,"dai":7,"damp":8,"dash":12,"dat":[0,3,7,8,11],"data":[0,2,3,4,7,9,10,11,12,13],"dc":12,"default":[8,10,12,13],"defin":1,"degrad":8,"degre":12,"delet":8,"depend":[5,12],"deploi":14,"deploy":[2,4],"deriv":[8,10],"describ":[2,3,4,8,12],"deselect":[5,8],"desk":4,"desktop":[3,4,6,7,8,10,11,12,14],"desktop_deploy":[2,4],"detail":[4,7,12,14],"detect":10,"detector":[12,13],"develop":10,"diagnos":11,"diagnost":4,"dialog":[0,2,3,4,7,9,10,14],"did":[11,12],"differ":[4,7,9,12,13],"direct":[3,12],"directli":[1,6,7,8],"directori":[0,7,9,10,11,14],"disabl":12,"disagre":13,"disappear":[8,12],"disclosur":12,"disk":[0,6,12],"dismiss":8,"displai":[3,6,7,8,9,11,12],"dist":2,"distinct":[8,12,13],"do":[6,12,13,14],"doc":[2,4],"document":[2,3,4,5,6,7,10,11,12,13,14],"doe":[0,4,6,7,8,11,12],"dolli":12,"domain":[3,12],"dot":12,"download":[5,8,11],"drag":8,"draw":[0,8],"drawn":[3,7,8,9,12],"drive":8,"driven":5,"dropdown":[1,8,12,14],"dump_head":[3,4,7,10],"dynam":12,"e":[2,8,12],"each":[2,3,8,11,12],"edit":[3,4,5,6,10,12,13,14],"editor":[3,4,7,8,9,12,14],"effect":[10,13],"effici":12,"eight":8,"either":12,"electron":[0,2,4,6,7,9,10],"element":11,"elig":12,"embed":[0,8],"empti":[4,8,10,12],"enabl":[8,10,12],"encod":[0,7],"end":[4,8,12],"endpoint":[9,14],"energi":8,"engin":[3,7,9],"enter":[2,5,6,7,12],"entri":[3,5,8],"equal":1,"equival":8,"eras":11,"error":[0,8,12],"esc":[5,8],"even":8,"event":5,"everi":[3,5,7,8,10,11,12,13,14],"everydai":5,"everyth":[1,12],"evolv":7,"exact":[8,12],"exactli":[1,8],"exampl":[4,8,10,11,12,13],"exce":12,"execut":[4,7],"exist":[0,10,12,13],"exit":11,"expand":[2,7,8,12],"expert":[7,13],"explain":11,"explicit":8,"explicitli":9,"exponenti":12,"exponentialbessel":12,"exponentialco":12,"expos":[0,6,7,9,10,12,14],"express":[1,12],"extern":2,"extra":8,"factor":12,"factori":7,"fail":[11,12,14],"fast":3,"fastest":14,"featur":10,"fed":7,"feed":[7,8,11],"fetch":14,"few":5,"fft":[0,3,7,12],"field":[4,5,6,8,10,12,13],"file":[0,2,3,4,7,9,10,12,13],"final":7,"finish":[11,14],"first":[0,2,4,6,8,10,12,14],"fit":[0,1,2,3,4,6,8,9,11],"fitparamet":3,"fix":[8,9,12,13,14],"flame":12,"flip":12,"flow":12,"focu":5,"focus":[5,8],"follow":12,"forget":8,"form":[3,12,14],"format":3,"forward":[12,13],"four":8,"fourier":[3,12],"fragment":[0,3],"frame":[3,12],"free":12,"frequenc":[3,4,8,10,12],"fresh":6,"freshli":12,"from":[0,1,2,3,4,5,6,7,8,9,10,11,12,13],"frq":1,"full":[5,7,8,11],"function":[1,3,12],"further":12,"g":[2,8,12],"gain":12,"gamma_mu":1,"gauss":12,"gaussian":12,"gaussianbessel":12,"gaussianco":12,"gbgco":12,"gbgexp":12,"gbgsexp":12,"gbgzf":12,"gdktlf":12,"gener":[1,3,4,6,7,8,10,11,12,13],"get":[0,4,8],"give":11,"given":10,"glfexp":12,"glfsexp":12,"global":[3,8,12],"glossari":4,"good":13,"gp":12,"gpd":12,"gracefulli":8,"graphic":4,"grid":8,"group":[4,10,12],"grow":8,"guess":[3,7,8,10,13],"gui":[1,4,7,11,12,14],"guid":[4,7],"gyromagnet":1,"ha":[3,5,8,12,14],"hal":12,"hand":[5,6,8,11,12,14],"handl":[0,4,8,9],"hang":4,"happen":8,"harmlessli":0,"hash":0,"have":[8,12,13],"header":10,"health":14,"help":[4,9,14],"hess":12,"hide":[8,12],"highlight":[7,12],"hint":10,"hist":12,"histogram":[10,12,13],"hold":[5,8,10,12,13,14],"hood":4,"host":[2,13],"hover":11,"how":[7,12],"http":[0,2],"i":[1,2,3,4,5,6,7,8,9,10,11,12,13],"icon":[0,6],"ident":[0,8,12],"identifi":[8,12],"idl":11,"ignor":[0,5,14],"imaginari":12,"immedi":[0,1,8,11],"import":13,"includ":[1,8,12,14],"inconsist":13,"independ":[2,3,8,9,11,12,14],"indic":8,"individu":[8,12],"inform":12,"initi":[3,7,10],"inlin":[0,8,12],"input":[3,5],"insid":[3,7,12],"inspect":[4,7,11],"instal":[4,10,12,14],"instanc":0,"instead":[1,8,10,11,14],"instrument":[0,2,7,10,12],"interact":[5,7,8],"interfac":7,"invalid":11,"invok":11,"involv":14,"issu":2,"its":[0,2,3,7,8,9,10,11,12,13,14],"itself":8,"j":2,"join":3,"jsroot":[3,7,9,12],"just":[5,6,8],"k":8,"keep":[6,8,11,12,13],"kei":[0,5,8],"kept":[11,12],"kev":8,"keyboard":4,"khz":12,"kt":12,"kubo":12,"label":[8,12],"lack":14,"lai":8,"lam_2255":8,"larg":11,"larger":8,"larmor":4,"lasso":5,"last":11,"later":[2,11,13],"layout":8,"ldktlf":12,"le":8,"leak":8,"least":14,"leav":[8,10,12,13],"left":8,"legaci":[12,14],"legend":8,"lem":12,"let":8,"level":8,"lgkt":12,"lgktexp":12,"lgktsexp":12,"librari":9,"lifetim":12,"like":[1,13],"likelihood":12,"limit":[3,7,8,12],"line":[3,4,7,8,9,11,14],"linear":8,"link":[0,2,3,4,7,8,9,11],"linux":2,"list":[1,6,8,11,12,14],"liter":1,"live":[1,7,9,10,11,12],"llfexp":12,"llfsexp":12,"lmu":10,"load":[4,8,13],"local":[0,2,7,8,9,14],"locat":10,"lock":[6,14],"log":[4,7,12,14],"logarithm":[8,12],"long":0,"longer":8,"look":[4,7,10],"lose":12,"lower":8,"ltf":12,"machin":[0,2,4,7,11],"made":3,"magnet":4,"mai":[0,6,14],"mailto":[2,14],"main":[0,1,2,4,7,8,9,11],"make":12,"manag":7,"manual":[2,3,7,9],"map":8,"mark":[3,12],"marker":8,"match":[0,3,4,8,10,14],"matter":7,"max":12,"mc":12,"md":[2,4,14],"mean":[6,12],"measur":[3,8],"mechan":[3,8],"median":12,"medium":12,"menu":[6,7,9,10],"merg":12,"messag":[11,14],"metadata":[3,7,10],"mhz":12,"microsecond":12,"might":12,"migrad":12,"minim":12,"minimis":12,"mino":12,"minuit2":12,"mirror":4,"miss":4,"mix":13,"mode":[5,8,10,13],"model":[0,1,2,4,6,7,8,9,14],"modeless":[2,9,11],"modern":7,"modifi":13,"monochrom":8,"more":[7,8,12,14],"most":[5,8],"mous":5,"msr":[1,2,3,4,7,9,10,11,12,13,14],"msr2data":[0,3,4,7,10],"multi":[3,4,8,12],"multipl":6,"multipli":1,"muon":[1,3,7],"musrfit":[1,2,3,4,7,8,10,11,12],"musrfit_startup":10,"musrflow":[0,2,3,5,6,7,10,11,14],"musrus":[0,2],"musrview":[3,4,7,9,10,12],"must":[2,13,14],"name":[1,3,5,7,8,10,12],"nativ":[3,7,8,9,12],"ndf":[11,12],"need":[2,7,8],"neither":0,"never":[0,5,8,10,14],"new":[8,12,14],"newest":8,"newli":8,"next":[1,2,6,8,10,12,13],"node":2,"non":10,"none":12,"normal":[0,1,5,8,12,13],"note":[4,8,14],"noth":[0,2,4,12],"notic":11,"npm":2,"number":[2,7,8],"numer":[8,12],"object":12,"off":12,"offer":[8,11,12],"offset":12,"old":12,"oldest":8,"omit":8,"onc":[1,2,6,8,12],"one":[1,2,3,5,6,7,9,12,13,14],"ones":[2,12],"onli":[1,2,8,11,12,13,14],"onto":8,"opac":8,"open":[0,4,6,7,8,9,10,11,12,14],"oper":11,"opt":12,"option":[0,2,3,4,7,14],"order":[8,11,12,13],"ordinari":1,"organis":4,"origin":[4,8],"oscil":12,"other":[1,8,11,13],"otherwis":0,"out":[8,11,12],"outcom":[4,14],"outlier":12,"output":[3,10,11,12],"over":[7,10,11,12],"overlai":[0,14],"overlaid":[8,14],"overrid":[8,12],"overview":4,"overwrit":6,"own":[0,3,6,7,8,9,12],"ownership":[4,5],"pack":12,"packag":[2,4,7,11,12],"padlock":6,"page":[3,4,7,9,12],"pair":12,"palett":[0,8],"pan":[5,8],"pane":[1,11],"panel":[0,5,14],"par":[3,7,11,12],"par4":12,"par7":12,"paramet":[0,2,3,4,6,7,9,10,11,12],"parr":12,"part":[1,3,8],"parti":0,"pass":0,"past":[0,9],"pastel":8,"path":[0,2,8,9,10,12],"payload":0,"per":[1,8,9,11,13],"perform":14,"perman":11,"phase":[3,12],"phi":12,"physic":[7,8,12,13],"pick":8,"picker":8,"place":14,"plain":8,"plot":[0,3,4,6,7,9,11,13],"plotli":[5,8],"plottabl":14,"plu":[3,8,12],"point":[2,14],"pointer":8,"polici":12,"pop":11,"popul":[0,8],"portabl":[3,7,10],"power":12,"predefin":8,"prefer":[0,4,7,9,14],"prefix":[4,8],"prepar":[3,4,6,12],"prerequisit":4,"preselect":8,"present":[8,13],"press":[1,2,5,7,8],"preview":[4,6,12],"previou":12,"previous":13,"primari":11,"print":3,"problem":4,"process":11,"produc":[0,2,3,7,8,9,11,12],"progress":12,"project":[2,3],"protocol":9,"provid":[5,7,8],"psi":[0,2,10,14],"public":10,"put":10,"q":[5,8],"qualiti":12,"question":2,"quick":[4,7,9],"ran":11,"rang":[0,3,4,5,6,7,8,13],"rate":12,"rather":[8,12],"ratio":[1,12],"raw":0,"re":[8,12,14],"reachabl":14,"read":[0,1,3,7,8,10,12,13,14],"readabl":[11,14],"readm":[4,14],"real":[6,8,12,14],"reason":14,"rebuild":[8,12,14],"rebuilt":[0,8],"recent":8,"recipi":0,"recognis":[6,8],"recolour":8,"record":[3,11,12,14],"recreat":0,"redraw":8,"refer":[0,1,3,7,12],"referenc":1,"refin":1,"refit":[3,8,12,14],"reflect":1,"refresh":[8,14],"regener":6,"regular":12,"reimplement":7,"reject":13,"relat":[0,1],"relax":12,"releas":2,"relev":[7,11],"remain":0,"rememb":[0,10],"remov":[1,8,12],"renam":8,"render":[1,7,8],"replac":[6,8,12],"report":[2,4,12],"reposit":8,"repositori":[2,4],"repres":[1,8],"reproduc":[0,11],"request":8,"requir":[2,12],"reread":[8,14],"reset":[5,8,14],"resolut":[12,14],"resolv":[3,7,8,10,12,14],"respect":12,"rest":8,"restor":[0,3,4,7,8,9],"restyl":8,"result":[2,4,6,7,8,10,12,14],"return":[6,12,13],"reus":[3,12,14],"revert":8,"right":[2,7,8],"role":8,"root":[3,7,9,10,11,12,14],"rotat":[3,12],"rout":[8,12],"row":[1,8,12,13,14],"rpm":2,"rrf":[0,3,7,12],"run":[0,1,3,4,6,7,8,9,10,13,14],"runner":2,"runtim":2,"sai":[8,9],"salman":[2,4,14],"same":[0,1,2,3,4,5,7,8,10,11,12,14],"save":[6,7,8,9,10,12],"scale":12,"scan":[0,8],"scana_par":8,"scanb_par":8,"scatter":8,"scope":8,"scratch":8,"search":10,"second":12,"section":[2,7],"see":[0,3,4,5,7,8,11,12,13,14],"seed":[3,10],"select":[0,2,4,6,7,11],"sender":0,"sensibl":10,"sent":0,"separ":[4,8,12],"sequenc":12,"seri":[3,4,11,14],"serial":8,"serv":2,"server":[0,2,4,6,7,8,9,10,11,14],"session":[0,2,7,10],"set":[0,3,4,5,6,7,9,10,13,14],"setup":[0,10,14],"sever":[8,12],"sgkt":12,"shadow":8,"share":[3,4,7,9,12,13,14],"shift":[5,8,13],"ship":0,"short":[2,7,11],"shortcut":4,"shorten":11,"should":14,"show":[1,3,6,7,8,10,11,12,13,14],"shown":[6,8,12],"side":[8,9,11,14],"signal":[3,12],"silent":[6,12],"simplex":12,"sinc":13,"singl":[0,3,7,8,10,12,13],"six":12,"size":8,"skip":[3,8,12,14],"slash":12,"slkt":12,"small":8,"smart":8,"so":[0,1,3,5,6,7,8,9,11,12,13],"some":[4,12,13],"someth":8,"somewher":10,"sourc":[0,6,8,14],"space":5,"special":3,"specialis":10,"specif":[8,9,10],"spectra":[3,7,9,11,12],"spectromet":12,"spectroscopi":[3,7],"speed":5,"spin":[3,12],"split":1,"spread":12,"squar":8,"stack":8,"stage":8,"stai":[8,11,12,13],"stand":12,"standard":[5,10,13],"stanza":0,"start":[3,4,7,8,9,10,11,12],"startup":[10,14],"state":[0,5,8,11,12],"static":12,"statist":[3,11],"statu":[4,12,14],"step":[3,7,8,9,12,14],"still":[8,12],"store":[10,13],"strategi":12,"stretch":12,"stretchco":12,"strictli":12,"stripe":[8,14],"strkt":12,"strktexp":12,"strktsexp":12,"strong":12,"style":0,"subtract":3,"success":[11,12],"suffix":[8,10],"sum":12,"summari":12,"summaris":12,"support":4,"surrend":6,"surviv":8,"swatch":8,"switch":12,"symbol":8,"sync":8,"synchronis":[7,11],"syntax":[1,12],"system":0,"t":8,"t0":[4,7],"tab":[0,1,2,4,6,7,8,9,11,12,13],"tabl":[0,2,3,4,7,11,12,14],"tag":8,"take":[8,10,12,13],"target":0,"task":5,"temperatur":8,"templat":[6,11],"ters":11,"tesla":12,"text":[1,3,5,6,8,9,11,12,14],"tf":8,"than":[8,12],"thei":[1,2,4,5,7,8,11,12,13],"theirs":8,"them":[1,8,10,13,14],"theori":[1,3,12],"therefor":0,"thi":[0,1,2,3,4,6,7,8,9,10,11,12,13,14],"third":0,"those":[8,14],"three":[1,8,12],"through":[3,6,9,12],"tick":8,"time":[0,1,7,8,12,13],"titl":8,"togeth":12,"toggl":[5,8],"token":13,"tool":[2,3,4,5,7,9,10,14],"toolbar":[6,7,8,12],"top":[0,8],"total":8,"toward":8,"toyab":12,"trace":0,"track":2,"transform":[3,12],"transient":11,"treat":3,"tree":[2,7,9,10,12,14],"troubleshoot":4,"truth":6,"twice":[8,12],"two":[3,4,6,8,12,13,14],"type":[1,3,5,8,12],"typic":[1,7],"u":[5,8],"unaffect":12,"uncertainti":[3,8],"unchang":[4,13],"uncheck":[8,14],"under":[1,4,8,9,10,11,14],"underneath":8,"unexpect":11,"unifi":8,"uniform":12,"unit":[3,12],"unless":8,"unlock":[6,14],"unmatch":8,"unspecifi":12,"until":[6,14],"untouch":[0,12],"up":[5,8,11,12],"updat":[1,8],"upload":8,"upper":8,"url":[0,2,3],"us":[0,1,3,4,6,7,8,10,11,12,13,14],"usabl":11,"user":[8,9],"usual":[5,10],"valid":[12,14],"valu":[0,1,3,7,8,10,11,12,13,14],"vari":[7,8],"variabl":[0,8],"variant":12,"varieti":12,"verifi":[1,7,14],"version":14,"vertic":8,"via":[9,12],"view":[0,3,4,7],"viewer":[3,7],"visibl":[6,8],"visual":12,"vm":12,"wa":[0,6,8,11,14],"wai":[8,11,12,13],"warn":[12,14],"weak":12,"web":[3,4,6,7,8,10,11,12],"webpag":9,"well":[0,5],"went":11,"were":11,"what":[1,4,8,9,11,14],"whatev":0,"when":[0,2,8,10,11,12,13],"whenev":8,"where":[9,10,12,14],"whether":[5,8,11],"which":[3,6,8,12],"while":[0,5,6,8,10,11,12],"who":0,"whole":[8,11],"whose":[12,13],"win":[8,10],"window":[0,2,3,4,7,9,12],"within":8,"without":[0,1,8,10,11,12,13],"work":[0,2,5,7,8,10,12,14],"workflow":[1,4,7,9],"worst":[11,12],"would":[6,13],"wrap":[2,4],"writabl":14,"write":[2,3,6,7,10,12],"written":[10,13],"wrong":[4,11],"x":[4,5,12,14],"xml":[10,14],"y":[5,8,12],"year":[0,2,7,12],"yet":8,"you":[1,4,6,8,10,12,13,14],"your":[0,2,7,8,11,12],"zaher":[2,4,14],"zoom":[5,8],"\u00b5sr":[7,8],"\u03bb\u2081":8,"\u03c7\u00b2":[11,12]},"titles":["Configuration sharing","Constraints","Getting started","Glossary","muSRFlow User Manual","Keyboard shortcuts","MSR editor","Overview","Parameters and parameter plots","Web and desktop editions","Preferences","Results and diagnostics","Runs and fitting","t0 / background","Troubleshooting"],"titleterms":{"A":7,"On":0,"The":[2,8,11],"action":12,"app":2,"asymmetri":13,"axi":8,"background":13,"bar":11,"cannot":14,"choos":8,"column":8,"command":11,"configur":[0,8,14],"constraint":1,"content":4,"coupl":1,"custom":1,"data":[8,14],"desktop":[0,2,9],"detail":11,"diagnost":11,"dialog":[8,11],"differ":14,"edit":[2,7,8,9],"editor":[5,6],"empti":14,"exampl":1,"execut":11,"field":1,"file":[6,8,11,14],"first":7,"fit":[7,12,13,14],"frequenc":1,"from":14,"gener":5,"get":[2,7],"glossari":3,"group":13,"gui":6,"guid":2,"handl":6,"hang":14,"hood":7,"i":[0,14],"instal":2,"keyboard":[5,8],"larmor":1,"link":14,"load":14,"log":11,"look":14,"machin":14,"magnet":1,"manual":4,"miss":14,"model":12,"msr":[5,6],"multi":13,"multipl":8,"musrflow":4,"note":[0,5],"noth":14,"one":8,"open":2,"option":[8,12],"origin":14,"outcom":11,"overlai":8,"overview":7,"ownership":6,"page":14,"panel":8,"paramet":[1,5,8,14],"per":12,"plot":[5,8,12,14],"prefer":10,"prefix":14,"prepar":14,"prerequisit":2,"preset":8,"preview":1,"problem":14,"quick":2,"rang":12,"rememb":8,"report":14,"restor":14,"result":11,"run":[2,11,12],"select":[5,8,12],"seri":[8,12],"set":[8,12],"share":[0,8],"shortcut":[5,8],"some":14,"start":[2,14],"statist":12,"statu":11,"style":8,"support":2,"t0":13,"tab":5,"tabl":8,"templat":8,"trace":8,"troubleshoot":14,"two":7,"unchang":14,"under":7,"user":4,"view":12,"web":[0,2,9,14],"what":[0,7],"window":[5,8,11],"workflow":6,"wrong":14,"x":8,"you":7}}) \ No newline at end of file diff --git a/docs/source/parameters-plots.rst b/docs/source/parameters-plots.rst index f81ad5b..04fbc2c 100644 --- a/docs/source/parameters-plots.rst +++ b/docs/source/parameters-plots.rst @@ -88,6 +88,17 @@ layout choice. Panels share the chosen X axis. The toolbar holds: Adding files this way is the same overlay mechanism as **Overlay data sets** in *Plot options*; the toolbar shortcut just applies the additions to all panels instead of the active one. + +Overlaid curves get a *smart legend* label that says which physical state +each scan represents instead of only a file name. The label is derived from +the data set's own scan variable and its constant coordinate: an energy scan +(``dataE`` varying) is tagged with its fixed temperature (``(T = 300 K)``), a +temperature scan with its fixed energy for LE-µSR (``(E = 12 keV)``) or with +its field for bulk µSR (``(B = 100 G)``), and a field scan with its fixed +temperature. When no fixed coordinate is present the plain file label is used. +You can also rename a legend entry directly in the plot; a Refresh then keeps +your name instead of rebuilding the default. + * **Plot options** -- expand the layout, X, parameter, style, and displayed series controls for the active panel. diff --git a/index.html b/index.html index ea55a15..abc3a11 100644 --- a/index.html +++ b/index.html @@ -142,7 +142,14 @@
diff --git a/muSRFitParameterPlot.js b/muSRFitParameterPlot.js index 9c0aff9..24c5f01 100644 --- a/muSRFitParameterPlot.js +++ b/muSRFitParameterPlot.js @@ -211,6 +211,56 @@ function detectMusrfitScanVariable(dataset) { }; } +// A compact "fixed-coordinate" legend tag for an overlaid scan, derived from +// the data set's own scan variable: an energy scan is tagged with its constant +// temperature, a temperature scan with its constant energy (LE-µSR) or field +// (bulk µSR), a field scan with its constant temperature or energy. This makes +// the legend say which physical state each curve represents instead of just a +// file name. Returns "" when no unambiguous fixed coordinate is present. +function musrfitParameterFixedCoordinateLegend(dataset) { + if (!dataset || !dataset.columns || !dataset.rows || !dataset.rows.length) return ""; + let scanName = detectMusrfitScanVariable(dataset).name; + let priorities = []; + if (scanName === "dataE") { + priorities = ["dataT", "dataB"]; + } else if (scanName === "dataT") { + priorities = ["dataE", "dataB"]; + } else if (scanName === "dataB") { + priorities = ["dataT", "dataE"]; + } else { + priorities = ["dataT", "dataB", "dataE"]; + } + let shortNames = { dataT: "T", dataB: "B", dataE: "E", dataSpinRot: "SR" }; + let units = { dataT: "K", dataB: "G", dataE: "keV", dataSpinRot: "\u00b0" }; + for (let name of priorities) { + let column = musrfitParameterColumnIndex(dataset, name); + if (column < 0) continue; + let distinct = new Set(musrfitParameterColumnValues(dataset, column) + .filter(function(value) { return Number.isFinite(value); })); + if (distinct.size !== 1) continue; + let value = distinct.values().next().value; + let base = shortNames[name] || name; + let magnitude = Math.abs(value); + let digits = magnitude >= 100 ? 0 : (magnitude >= 10 ? 1 : (magnitude >= 1 ? 2 : 4)); + let number = Number(value.toFixed(digits)); + return base + " = " + number + (units[name] ? " " + units[name] : ""); + } + return ""; +} + +// The default legend prefix for one data set in overlay mode: the data set's +// plain file label plus the fixed-coordinate tag when available (so curves are +// told apart by their physical state too), for example "514_par.dat (T = 4 K)". +function musrfitParameterOverlayPrefix(entry, dataset) { + let label = (entry && entry.label) ? entry.label : "data set"; + let fixed = musrfitParameterFixedCoordinateLegend(dataset); + return fixed ? label + " (" + fixed + ")" : label; +} + +function musrfitParameterLegendOverrideKey(dataSetKey, yName) { + return dataSetKey + "\u0000" + (yName || ""); +} + // Built-in parameter-plot templates are declarative data: a stable identifier, // a human name, the compatible X-variable names, the panel layout, shared-X // behavior, and per-panel semantic parameter roles. Templates are applied by @@ -609,6 +659,7 @@ function validateParameterPlotState(snapshot) { if (typeof snapshot.mainSourceKey !== "string" || !snapshot.mainSourceKey) return false; if (!Array.isArray(snapshot.panelStates) || !Array.isArray(snapshot.registeredDataSets)) return false; if (!isPlainObjectValue(snapshot.styleRegistry)) return false; + if (snapshot.legendNameOverrides !== undefined && !isPlainObjectValue(snapshot.legendNameOverrides)) return false; for (let style of Object.keys(snapshot.styleRegistry)) { if (typeof style !== "string" || !isPlainObjectValue(snapshot.styleRegistry[style])) return false; } @@ -1036,6 +1087,7 @@ function parameterOverlayEntries(panel, registry) { function buildMusrfitParameterOverlayTraces(dataSets, xName, yNames, mode, options) { options = options || {}; let traces = []; + let traceMeta = []; let skipped = []; let paletteId = options.paletteId || "default"; // In overlay mode every trace of a data set shares the data set's color so @@ -1056,6 +1108,7 @@ function buildMusrfitParameterOverlayTraces(dataSets, xName, yNames, mode, optio } let entryColorIndex = Number.isFinite(entry.colorIndex) ? entry.colorIndex : i; let dataSetKey = entry.dataSetKey || entry.key || ""; + let defaultPrefix = musrfitParameterOverlayPrefix(entry, dataset); let nameOffset = 0; for (let name of yNames) { let yIndex = musrfitParameterColumnIndex(dataset, name); @@ -1068,12 +1121,22 @@ function buildMusrfitParameterOverlayTraces(dataSets, xName, yNames, mode, optio options.styleRegistry, options.styleKeyOf && options.styleKeyOf(dataSetKey, name) || "", dataSetKey, style); } let trace = buildMusrfitParameterTrace(dataset, xIndex, yIndex, mode, style); - if (overlayMode) trace.name = (entry.label ? entry.label + ": " : "") + trace.name; + if (overlayMode) { + let defaultName = defaultPrefix + ": " + trace.name; + let override = options.legendNameOf && typeof options.legendNameOf === "function" + ? options.legendNameOf(dataSetKey, name) : ""; + trace.name = override ? override : defaultName; + } traces.push(trace); + traceMeta.push({ + dataSetKey: dataSetKey, + name: name, + defaultName: trace.name + }); nameOffset++; } } - return { traces: traces, skipped: skipped }; + return { traces: traces, skipped: skipped, traceMeta: traceMeta }; } function musrfitParameterYCandidates(dataset, xIndex) { @@ -1598,6 +1661,10 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa // parameterDataSetStyleKey / parameterTraceStyleKey; values are plain // {color, symbol, size, opacity} objects edited from the marker picker. let styleRegistry = {}; + // User-renamed legend entries, keyed by musrfitParameterLegendOverrideKey. + // They override the smart default (file prefix or fixed-coordinate tag) so a + // Refresh does not throw away legend labels the user edited. + let legendNameOverrides = {}; let panelSequence = 0; let windowPaletteId = "default"; let stylePicker = null; @@ -1663,6 +1730,7 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa registeredDataSets: registeredDataSets.map(function(entry) { return { key: entry.key, source: portableParameterSource(entry.source), label: entry.label, colorIndex: entry.colorIndex }; }), + legendNameOverrides: JSON.parse(JSON.stringify(legendNameOverrides)), styleRegistry: typeof styleRegistry === "object" && styleRegistry ? JSON.parse(JSON.stringify(styleRegistry)) : {} }; } @@ -1689,6 +1757,8 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa // Style registry comes in as plain JSON; no need for a structured clone. styleRegistry = snapshot.styleRegistry || {}; + legendNameOverrides = snapshot.legendNameOverrides + && typeof snapshot.legendNameOverrides === "object" ? snapshot.legendNameOverrides : {}; // Rebuild every panel in the saved order. StableIds are read from the // snapshot so style registry keys stay aligned across sessions. @@ -1995,9 +2065,13 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa styleRegistry: styleRegistry, styleKeyOf: function(key, name) { return parameterTraceStyleKey(key, panel.stableId, name); + }, + legendNameOf: function(dataSetKey, name) { + return legendNameOverrides[musrfitParameterLegendOverrideKey(dataSetKey, name)] || ""; } }); let traces = overlayResult.traces; + panel.traceMeta = overlayResult.traceMeta || []; if (panel.note) { panel.note.textContent = overlayResult.skipped.map(function(skipped) { return skipped.label + ": " + skipped.reason; @@ -2041,7 +2115,7 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa plotly.react(panel.chart, traces, layout, { responsive: true, editable: true, - edits: { titleText: false }, + edits: { titleText: false, legendText: true }, displaylogo: false, modeBarButtonsToAdd: [ @@ -2091,6 +2165,33 @@ function showMusrfitParameterPlotWindow(parameterPath, jobName = "", preferredPa if (!yName) return; openParameterStylePicker(panel, yName, clicked.event); }); + // Capture legend-entry renames (Plotly allows editing legend text while + // the plot is editable) so a Refresh keeps the user's labels instead of + // rebuilding the smart defaults. The rename arrives as a plotly_restyle + // whose data carries the new name; we only record names that actually + // differ from the values we just rendered. + panel.chart.on("plotly_restyle", function(restyleEvent) { + let changes = restyleEvent && restyleEvent.data; + if (!changes || !Array.isArray(changes) || !panel.traceMeta) return; + let indices = restyleEvent.traceIndices; + for (let c = 0; c < changes.length; c++) { + let names = changes[c] && changes[c].name; + if (names === undefined || names === null) continue; + let updated = Array.isArray(names) ? names : [names]; + let traceIndex = indices && Array.isArray(indices) ? indices[c] : c; + if (typeof traceIndex !== "number" || traceIndex < 0) continue; + let meta = panel.traceMeta[traceIndex]; + if (!meta || !meta.dataSetKey) continue; + let newName = panel.chart.data[traceIndex] && panel.chart.data[traceIndex].name; + if (typeof newName !== "string" || !newName.trim()) continue; + if (meta.defaultName === newName) continue; + let key = musrfitParameterLegendOverrideKey(meta.dataSetKey, meta.name); + if (legendNameOverrides[key] === newName) continue; + legendNameOverrides[key] = newName; + meta.defaultName = newName; + scheduleParameterPlotStateSave(); + } + }); } } diff --git a/tests/parameter-plot.test.js b/tests/parameter-plot.test.js index ae19445..a6ba354 100644 --- a/tests/parameter-plot.test.js +++ b/tests/parameter-plot.test.js @@ -671,6 +671,67 @@ function testTraceStyleAndOverlayFoundation() { assert.deepStrictEqual(Array.from(leanOverlay.traces, function(t) { return t.name; }), ["Scan A: α", "Scan A: λ (μs⁻¹)", "Lean: λ (μs⁻¹)"]); assert.strictEqual(leanOverlay.skipped.length, 0); + + // Smart legend prefixes: an energy scan is tagged with its constant + // temperature, a temperature scan with its constant energy (LE) or field + // (bulk), and a user rename override replaces the default entirely. + const energyScan = lib.parseMusrfitParameterData([ + "% RUN dataE dataT Alpha dAlpha", + "514 5.0 300 0.30 0.01", + "515 7.5 300 0.29 0.01" + ].join("\n")); + const temperatureScan = lib.parseMusrfitParameterData([ + "% RUN dataT dataE Alpha dAlpha", + "516 10 12.0 0.24 0.01", + "517 20 12.0 0.22 0.01" + ].join("\n")); + const bulkScan = lib.parseMusrfitParameterData([ + "% RUN dataT dataB Alpha dAlpha", + "518 10 100 0.24 0.01", + "519 20 100 0.22 0.01" + ].join("\n")); + // A scan with no fixed coordinate (cold field scan, everything varies). + const fullyVarying = lib.parseMusrfitParameterData([ + "% RUN dataT dataB dataE Alpha dAlpha", + "520 10 100 5.0 0.30 0.01", + "521 20 200 7.5 0.29 0.01" + ].join("\n")); + + assert.strictEqual(lib.musrfitParameterOverlayPrefix( + { label: "E scan" }, energyScan), "E scan (T = 300 K)"); + assert.strictEqual(lib.musrfitParameterOverlayPrefix( + { label: "T scan" }, temperatureScan), "T scan (E = 12 keV)"); + assert.strictEqual(lib.musrfitParameterOverlayPrefix( + { label: "Bulk" }, bulkScan), "Bulk (B = 100 G)"); + assert.strictEqual(lib.musrfitParameterOverlayPrefix( + { label: "Cold" }, fullyVarying), "Cold"); + + const keyD = "path:energy"; + const keyE = "path:temp"; + const smartOverlay = lib.buildMusrfitParameterOverlayTraces( + [{ dataSetKey: keyD, label: "E scan", dataset: energyScan }, + { dataSetKey: keyE, label: "T scan", dataset: temperatureScan }], + "dataT", ["Alpha"], "markers", { paletteId: "default" }); + assert.deepStrictEqual(Array.from(smartOverlay.traces, function(t) { return t.name; }), + ["E scan (T = 300 K): α", "T scan (E = 12 keV): α"]); + assert.strictEqual(smartOverlay.traceMeta.length, 2); + assert.strictEqual(smartOverlay.traceMeta[0].name, "Alpha"); + assert.strictEqual(smartOverlay.traceMeta[0].defaultName, "E scan (T = 300 K): α"); + + // A user-renamed legend entry (persisted override) beats the smart default. + const overrides = {}; + overrides[lib.musrfitParameterLegendOverrideKey(keyE, "Alpha")] = "My temp scan"; + const renamed = lib.buildMusrfitParameterOverlayTraces( + [{ dataSetKey: keyD, label: "E scan", dataset: energyScan }, + { dataSetKey: keyE, label: "T scan", dataset: temperatureScan }], + "dataT", ["Alpha"], "markers", { + paletteId: "default", + legendNameOf: function(dataSetKey, name) { + return overrides[lib.musrfitParameterLegendOverrideKey(dataSetKey, name)] || ""; + } + }); + assert.deepStrictEqual(Array.from(renamed.traces, function(t) { return t.name; }), + ["E scan (T = 300 K): α", "My temp scan"]); } function testParameterStyleEditingFoundation() {