From 5ec64db2b86530ae29573e672ed3768bf055665e Mon Sep 17 00:00:00 2001 From: salman Date: Tue, 22 Sep 2026 18:12:06 +0200 Subject: [PATCH] Add smart legend labels and preserve user-renamed legend entries MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Overlaid data sets show which physical state each scan represents instead of just a file name: the legend tag is derived from the data set's own scan variable, tagging an energy scan with its constant temperature, a temperature scan with its constant energy (LE-µSR) or field (bulk µSR), and a field scan with its temperature. Legend entries renamed directly in the plot are remembered and survive Refresh instead of being rebuilt from the smart defaults. The Histograms field on the Runs tab gains a hover note documenting the forward/backward pair syntax and the slash-separated multi-group asymmetry option. --- CHANGELOG.md | 6 + .../html/_sources/parameters-plots.rst.txt | 11 ++ docs/_build/html/parameters-plots.html | 11 ++ docs/_build/html/searchindex.js | 2 +- docs/source/parameters-plots.rst | 11 ++ index.html | 9 +- muSRFitParameterPlot.js | 107 +++++++++++++++++- tests/parameter-plot.test.js | 61 ++++++++++ 8 files changed, 213 insertions(+), 5 deletions(-) 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() {