diff --git a/CMakeLists.txt b/CMakeLists.txt index 6314cfb4..52b1c3f3 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -5,7 +5,7 @@ if (CMAKE_VERSION GREATER_EQUAL 3.12) cmake_policy(SET CMP0075 NEW) endif (CMAKE_VERSION GREATER_EQUAL 3.12) -project(musrfit VERSION 1.6.3 LANGUAGES C CXX) +project(musrfit VERSION 1.6.4 LANGUAGES C CXX) #--- musrfit specific options ------------------------------------------------- option(dks "build musrfit with DKS (GPU/MIC) support" ON) diff --git a/ChangeLog b/ChangeLog index 389973a8..97be543f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -12,6 +12,12 @@ or https://bitbucket.org/muonspin/musrfit/commits/all +Release of V1.6.4, 2020/08/29 +============================= + +Allow to view time spectra and Fourier theory only calculated at the data points +via the option '-1' or '--one_to_one'. + Release of V1.6.3, 2020/07/27 ============================= diff --git a/doc/html/.buildinfo b/doc/html/.buildinfo index c56e72da..c607e418 100644 --- a/doc/html/.buildinfo +++ b/doc/html/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 8f1b0a921f0f4e1d8c3f85aab9fe7bad +config: 0b93e4185566cd2a81b86f199313e66e tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/doc/html/_downloads/105384a3f798b4479ee2ecadd2e3112e/Makefile.TMyLibrary b/doc/html/_downloads/105384a3f798b4479ee2ecadd2e3112e/Makefile.TMyLibrary deleted file mode 100644 index 73a85c8e..00000000 --- a/doc/html/_downloads/105384a3f798b4479ee2ecadd2e3112e/Makefile.TMyLibrary +++ /dev/null @@ -1,60 +0,0 @@ -#--------------------------------------------------- -# get compilation flags from root-config - -ROOTCFLAGS = $(shell $(ROOTSYS)/bin/root-config --cflags) - -#--------------------------------------------------- - -OS = LINUX -CXX = g++ -CXXFLAGS = -O3 -Wall -Wno-trigraphs -fPIC -LOCALINCLUDE = . -ROOTINCLUDE = $(ROOTSYS)/include -INCLUDES = -I$(LOCALINCLUDE) -I$(ROOTINCLUDE) -LD = g++ -LDFLAGS = -SOFLAGS = -O -shared - -# the output from the root-config script: -CXXFLAGS += $(ROOTCFLAGS) -LDFLAGS += - -# some definitions: headers (used to generate *Dict* stuff), sources, objects,... -OBJS = -OBJS += TMyFunction.o TMyLibraryDict.o - -SHLIB = libTMyLibrary.so - -# make the shared lib: -# -all: $(SHLIB) - -$(SHLIB): $(OBJS) - @echo "---> Building shared library $(SHLIB) ..." - /bin/rm -f $(SHLIB) - $(LD) $(OBJS) $(SOFLAGS) -o $(SHLIB) - @echo "done" - -# clean up: remove all object file (and core files) -# semicolon needed to tell make there is no source -# for this target! -# -clean:; @rm -f $(OBJS) *Dict* core* - @echo "---> removing $(OBJS)" - -# -$(OBJS): %.o: %.cpp - $(CXX) $(INCLUDES) $(CXXFLAGS) -c $< - -# Generate the ROOT CINT dictionary - -TMyLibraryDict.cpp: TMyFunction.h TMyLibraryLinkDef.h - @echo "Generating dictionary $@..." - rootcint -f $@ -c -p -I$(ROOTINCLUDE) $^ - -install: all - @echo "Installing shared lib: libTApproximation.so" -ifeq ($(OS),LINUX) - cp -pv $(SHLIB) $(ROOTSYS)/lib - cp -pv $(LOCALINCLUDE)/*.h $(ROOTSYS)/include -endif diff --git a/doc/html/_downloads/c06f924ba301a43e83dbbdfcfaf54ada/Makefile.TMyLibrary b/doc/html/_downloads/c06f924ba301a43e83dbbdfcfaf54ada/Makefile.TMyLibrary deleted file mode 100644 index 73a85c8e..00000000 --- a/doc/html/_downloads/c06f924ba301a43e83dbbdfcfaf54ada/Makefile.TMyLibrary +++ /dev/null @@ -1,60 +0,0 @@ -#--------------------------------------------------- -# get compilation flags from root-config - -ROOTCFLAGS = $(shell $(ROOTSYS)/bin/root-config --cflags) - -#--------------------------------------------------- - -OS = LINUX -CXX = g++ -CXXFLAGS = -O3 -Wall -Wno-trigraphs -fPIC -LOCALINCLUDE = . -ROOTINCLUDE = $(ROOTSYS)/include -INCLUDES = -I$(LOCALINCLUDE) -I$(ROOTINCLUDE) -LD = g++ -LDFLAGS = -SOFLAGS = -O -shared - -# the output from the root-config script: -CXXFLAGS += $(ROOTCFLAGS) -LDFLAGS += - -# some definitions: headers (used to generate *Dict* stuff), sources, objects,... -OBJS = -OBJS += TMyFunction.o TMyLibraryDict.o - -SHLIB = libTMyLibrary.so - -# make the shared lib: -# -all: $(SHLIB) - -$(SHLIB): $(OBJS) - @echo "---> Building shared library $(SHLIB) ..." - /bin/rm -f $(SHLIB) - $(LD) $(OBJS) $(SOFLAGS) -o $(SHLIB) - @echo "done" - -# clean up: remove all object file (and core files) -# semicolon needed to tell make there is no source -# for this target! -# -clean:; @rm -f $(OBJS) *Dict* core* - @echo "---> removing $(OBJS)" - -# -$(OBJS): %.o: %.cpp - $(CXX) $(INCLUDES) $(CXXFLAGS) -c $< - -# Generate the ROOT CINT dictionary - -TMyLibraryDict.cpp: TMyFunction.h TMyLibraryLinkDef.h - @echo "Generating dictionary $@..." - rootcint -f $@ -c -p -I$(ROOTINCLUDE) $^ - -install: all - @echo "Installing shared lib: libTApproximation.so" -ifeq ($(OS),LINUX) - cp -pv $(SHLIB) $(ROOTSYS)/lib - cp -pv $(LOCALINCLUDE)/*.h $(ROOTSYS)/include -endif diff --git a/doc/html/_images/mupp-gui-0-new.png.svg b/doc/html/_images/mupp-gui-0-new.png.svg deleted file mode 100644 index 6a40244f..00000000 --- a/doc/html/_images/mupp-gui-0-new.png.svg +++ /dev/null @@ -1,1303 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - 1 - - 2 - - 3 - - 4 - - 5 - - 6 - - 7 - - 8 - - 9 - - 10 - - 11 - - 12 - - 13 - - 14 - - diff --git a/doc/html/_sources/acknowledgement.rst.txt b/doc/html/_sources/acknowledgement.rst.txt deleted file mode 100644 index 7e8c47fa..00000000 --- a/doc/html/_sources/acknowledgement.rst.txt +++ /dev/null @@ -1,22 +0,0 @@ -.. include:: -.. index:: acknowledgment - -.. _acknowledgment: - -Acknowledgements -================ - - -**Bastian M. Wojek** - I am very much indebted to BMW for his rigorous testing of ``musrfit``, his many useful suggestions, contributions, and for the - largest part of the user manual of ``musrfit`` which makes it accessible to a broader audience! Many thanks Bastian! - -**Uldis Locans** - I am very much indebted to Uldis work on :ref:`DKS ` enabling the GPU support for ``musrfit``. His kind, calm, and - extremely competent way to deal with his projects as well as to deal with the chaos of physicists way to think is admirable. Many thanks Uldis! - -**Zaher Salman** - Thanks for his beta-NMR and web-interface contributions to ``musrfit``! - -**Robert Scheuermann** - Thanks for his constant contructive input on ``musrfit``! diff --git a/doc/html/_sources/any2many.rst.txt b/doc/html/_sources/any2many.rst.txt deleted file mode 100644 index 6b5fd201..00000000 --- a/doc/html/_sources/any2many.rst.txt +++ /dev/null @@ -1,8 +0,0 @@ -.. include:: -.. index:: any2many - -any2many - a Universal |mgr|\SR-file-format converter -===================================================== - -``any2many`` allows to convert most |mgr|\SR-file-formats from one to the other. -For a detailed description see :ref:`here `. \ No newline at end of file diff --git a/doc/html/_sources/bugtracking.rst.txt b/doc/html/_sources/bugtracking.rst.txt deleted file mode 100644 index 55a5ff54..00000000 --- a/doc/html/_sources/bugtracking.rst.txt +++ /dev/null @@ -1,9 +0,0 @@ -.. index:: bugtracking -.. _bugtracking: - -Bugtracking -=========== - -For reporting bugs or requesting new features and improvements please use -the `bitbucket-repo `_ (preferred) -or send an e-mail to A. Suter at PSI. diff --git a/doc/html/_sources/cite.rst.txt b/doc/html/_sources/cite.rst.txt deleted file mode 100644 index 5a71e6f1..00000000 --- a/doc/html/_sources/cite.rst.txt +++ /dev/null @@ -1,18 +0,0 @@ -.. include:: -.. index:: cite -.. _cite: - -How to Cite ``musrfit``? -======================== - -Since quite some effort is going into the development and maintenance of the ``musrfit`` package, you should at least acknowledge it in your publication if you have used it to analyze your data. Even better of course is to cite it properly by the reference given beneath - - * A.\ Suter, B.M. Wojek, "Musrfit: A Free Platform-Independent Framework for |mgr|\SR Data Analysis", Physics Procedia **30**, 69 (2012). ``_ - -The GPU high speed ``musrfit`` version is utilizing ``DKS``. In case you are using this version, please also add the following citations - - * A.\ Adelmann, U. Locans, A. Suter, "The Dynamic Kernel Scheduler—Part 1", Computer Physics Communications **207**, 83 (2016). ``_ - * U.\ Locans, *et al.*, "Real-time computation of parameter fitting and image reconstruction using graphical processing units", Computer Physics Communications **215**, 71 (2017). ``_ - * U.\ Locans and A.\ Suter, "Musrfit – Real Time Parameter Fitting Using GPUs", JPS Conf. Proc. *21*, 011051 (2018). ``_ - - diff --git a/doc/html/_sources/index.rst.txt b/doc/html/_sources/index.rst.txt deleted file mode 100644 index b4ed7d2f..00000000 --- a/doc/html/_sources/index.rst.txt +++ /dev/null @@ -1,31 +0,0 @@ -.. musrfit docu documentation master file, created by - sphinx-quickstart on Sun Jun 17 11:00:32 2018. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to the musrfit documentation! -===================================== - -.. toctree:: - :maxdepth: 2 - - cite - tutorial - user-manual - user-libs - setup-standard - setup-dks - musredit - mupp - msr2data - any2many - musr-root - acknowledgement - bugtracking - - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`search` diff --git a/doc/html/_sources/msr2data.rst.txt b/doc/html/_sources/msr2data.rst.txt deleted file mode 100644 index 8e77bbca..00000000 --- a/doc/html/_sources/msr2data.rst.txt +++ /dev/null @@ -1,374 +0,0 @@ -.. include:: -.. index:: msr2data - -.. _msr2data: - -msr2data - A Program for Automatically Processing Multiple ``musrfit`` msr Files -================================================================================ - -``msr2data`` (originally written by B. M. Wojek) is a program implemented in ``C++``. Its purpose is -to process multiple msr files (input files for ``musrfit``) with the same parameters and summarize the fitting -results either in a *TRIUMF DB* [#f1]_ or a *column ASCII* file. This allows essentially to - -#. Collect the fit parameters. -#. Generate *new* input msr files based on old ones. - -.. [#f1] For an abridged description of this format see `here `_. The DB files - produced by ``msr2data`` can be viewed for instance with :ref:`mupp ` or |mgr|\View `see here `_, however, - they are not completely backward-compatible to the original ``db language`` since the parameter names can be longer than five or - six characters! In order to establish this backward compatibility (if needed) the user has to ensure the correct length of the - parameter names in the msr files! - -.. _msr2data-basic-usage: - -Basic Types of Usage --------------------- - -Apart from numerous :ref:`optional parameters ` that might be set, in principle there are four different ways of calling ``msr2data``. -These differ in how the list of runs which should be processed is supplied: - -**msr2data [optional parameters]** - A single run number. -**msr2data [optional parameters]** - An interval of run numbers is specified through the first and the last run number. The condition ```` < ```` is not necessary. -**msr2data \[ \] [optional parameters]** - Where ```` is one or a combination of the following: - - #. ``, , , ... `` : run numbers, *e.g.* 123 124, - #. ``-`` : a range, *e.g.* 123-125 -> 123 124 125, - #. ``::`` : a sequence, *e.g.* 123:127:2 -> 123 125 127. ```` has to be a positive integer. - #. A ```` can also combine (1)-(3), *e.g.* 123 128-130 133, etc. - -**msr2data [optional parameters]** - An ASCII file containing a list of run numbers and optional external parameters is passed to ``msr2data``. For the structure of the ASCII file - see :ref:`below `. - -All four basic types of calling ``msr2data`` contain the *mandatory* file-name ```` passed right after the list of runs. The meaning of -this ```` should become clear after giving examples for all four cases: - -.. code-block:: bash - - $ msr2data 8472 _tf_h13 - -generates the DB file ``out.db`` (can be changed by using the -o option) from ``8472_tf_h13.msr``. - -.. code-block:: bash - - $ msr2data 8472 8474 _tf_h13 - -generates the DB file ``out.db`` (can be changed by using the -o option) from ``8472_tf_h13.msr``, ``8473_tf_h13.msr``, and ``8474_tf_h13.msr``. - -.. code-block:: bash - - $ msr2data [8472 8470] _tf_h13 - -generates the DB file ``out.db`` (can be changed by using the -o option) from ``8472_tf_h13.msr`` and ``8470_tf_h13.msr``. - -.. code-block:: bash - - $ msr2data [8470:8474:2] _tf_h13 - -generates the DB file ``out.db`` (can be changed by using the -o option) from ``8470_tf_h13.msr``, ``8472_tf_h13.msr``, and ``8474_tf_h13.msr``. - -.. _run-list-file_structure: - -Run List File Structure -+++++++++++++++++++++++ - -.. code-block:: bash - - $ msr2data run.list _tf_h13 - -generates the DB file ``out.db`` (can be changed by using the -o option) from all runs listed in the ASCII file ``run.list`` in the working directory. -In this file it is also possible to include *external* parameters which should be put in the resulting DB file. The structure of the ``run.list`` is the following: - -:: - - RUN VAR1 VAR2 VAR3 ... - 8460 200 27.1 46.2 ... - 8472 205 27.1 46.3 ... - 8453 210 27.2 45.9 ... - · · · · - · · · · - · · · · - -*The first not commented and not empty line determines the parameter names and labels and has to be present!* - -It is allowed to add comments (with a preceding '#') or empty lines to the run-list file. - -The following should be mentioned together with the above examples: - -* The output files in the examples above are only newly created if they did *not* exist before invoking ``msr2data``. - If the files were already present the msr file data would be appended! -* If the files have been newly created, also the DB file header is written. If the files were present before, only - the data blocks are appended. The output of the header can either be forced or completely suppressed with the ``header`` - and ``noheader`` options as shall be seen later. -* If the ``musrfit`` output files do not have an ```` as specified above like ``8472.msr`` one has to call ``msr2data`` like in the following example: - - .. code-block:: bash - - $ msr2data 8472 8460 "" - -.. _msr2data-opt-param: - -Optional Parameters -------------------- - -As mentioned already above there are some optional parameters which change the behavior of ``msr2data`` and can be passed in any order. Here is a complete list: - -**data** - The output file format is changed to a simple column ASCII file (default output file name: out.dat). -**new** - An existing output file is deleted before new information is written to it. -**header** - Force the output of the file header even if the output file was present before. -**noheader** - The output of the file header is suppressed—also if the output file is newly created. - If either both or none of the header options are given, ``msr2data`` writes the file header only to new files - and it solely appends the data blocks to an existing output file assuming that the header is present already. -**nosummary** - There will be no attempt to read additional information like the temperature or the applied magnetic field from - the data files even if these information were present there. -**paramList ** - option used to select the parameters which shall be exported. ```` is a list of parameter numbers to be exported. - Allowed lists are: ``-``, *e.g.* ``1-16`` will export parameters 1 to 16. Space separated numbers, *e.g.:* ``1 3 5``. - A combination of both is possible, *e.g.* ``1-16 19 31 62``, and so on. -**-o, -o ** - The processed data will be written to the file ```` instead of the default ``out.db`` or ``out.dat``. - If ```` is equal to none (case-insensitive) the parameter data are not appended to any output file. -**fit** - Additionally to the final data collection ``msr2data`` will invoke ``musrfit`` to fit the specified runs. - All msr files are assumed to be present, none is newly generated! -**fit-