section of proposal writing, specifically multi-model

docs/details.rst

@@ -41,16 +41,18 @@ There are a number of peripherals attached to ``xf06bm-ws5``:
 + A screen. This is the rather large screen mounted in the corner of
   the hutch. It can be moved around somewhat for better viewing.
 
-+ A reasonably loud speaker. This is the Nylavee sitting on top of the
-  DIODE box above the beampipe next to the teddy bear in soldier
-  clothing. 
++ A reasonably loud speaker.  This is the black ball-shaped item
+  sitting on the frame of the upstream portion of the diagnostic
+  module.
 
-+ A good microphone. This is the Blue Yeti on stand above the IT
-  chamber on the XAS table. It has good noise cancellation so the din
-  from the XSpress3 should not effect voice quality.
++ A good microphone. This is the Blue Yeti on stand above the I\
+  :sub:`t` chamber on the XAS table. It has good noise cancellation so
+  the din from the XSpress3 should not effect voice quality.  It is,
+  however, important that the speaker face the microphone rather than
+  the screen.
 
 + A decent camera. This is the Nexigo mounted overhead next to the
-  Axis webcam.
+  Axis webcam and looking at the table.
 
 
 While these devices are all connected to ``xf06bm-ws5`` and powered
@@ -63,13 +65,6 @@ screen.
 support, Bruce will usually initiate the Zoom call and have the hutch
 computer join in.
 
-Note that the speaker is a Bluetooth speaker.  It shows up as SK100
-when you go into Settings and run a Bluetooth probe.  The USB cable is
-for power only.
-
-.. note:: To connect the speaker, select it in Settings then the
-	  volume button on the right end of the speaker must be
-	  pressed twice.
 
 
 
@@ -109,7 +104,10 @@ below 5 keV or above 21 keV, it is a poor use of time to make changes
 to the gas content of the ion chambers.  This is because it takes
 quite some time for the volume of the ion chamber to equillibrate.
 
-N\ :sub:`2` is adequate for almost all experiments at BMM.
+N\ :sub:`2` is adequate for almost all experiments at BMM.  For Tc or
+Ru, it is helpful to use about 20% Ar.  For Sc or lower, 50% He might
+be helpful.  But remember that purging the ion chambers takes
+**hours**.
 
 
 
@@ -187,7 +185,33 @@ pointed to in databroker.  See:
 Pilatus 100K
 ------------
 
-.. todo:: Need to verify what's on the wiki page.
+How files saving works
+~~~~~~~~~~~~~~~~~~~~~~
+
++ tiff files to /disk2
++ /disk2 is mounted on xf06bm-ioc1
++ tiff and hdf5 AD plugins write files to proposal directories
++ in bsui, there are pilatus and pilatus_tiff objects.  normally use
+  pilatus, puilatus_tiff is helpful for testing tiff file writing,
+  which is used by IBM
+
+
+
+Moving the detector between end stations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
++ power cables (strip and detector)
++ ethernet cables
++ GN2 line
++ grounding line
+
+The NFS server might need to be restarted after rebooting.  As root on
+xf06bm-pilatus100k, do
+
+.. code:: bash
+
+   /etc/init.d/nfsserver restart
+
 
 
 
@@ -333,6 +357,10 @@ temperature.
 <https://www.aps.anl.gov/files/download/DET/Detector-Pool/Spectroscopic-Detectors/Vortex_SDD/Vortex_ME4/Vtx-ME4%20Multi-El%20User%20Manual%20Rev.4.pdf>`__
 (link to copy at APS detector pool).
 
+There is a copy of the Vortex manual at BMM.  Look in ``/nsls2/data3/bmm/legacy/products/ME7/``,
+the file is called ``Vtx-Multi-El User Manual Rev 15.0_Oct 16, 2023.pdf``.
+
+
 DM3 CAT6 Patch Panel
 --------------------
 
@@ -419,6 +447,8 @@ Logitech controller
 
    Explain how to configure buttons in CSS
 
+.. todo::  Left joystick will be used for detector YZ.  Not X!
+
 
 Motor controllers
 -----------------

docs/index.rst

@@ -30,6 +30,7 @@ BMM is NIST's :red:`B`\ eamline for :red:`M`\ aterials :red:`M`\ easurement.
    :caption: Running the beamline
 
    intro.rst
+   proposal.rst
    before.rst
    data.rst
    instruments.rst

docs/proposal.rst

@@ -0,0 +1,115 @@
+..
+   This document was developed primarily by a NIST employee. Pursuant
+   to title 17 United States Code Section 105, works of NIST employees
+   are not subject to copyright protection in the United States. Thus
+   this repository may not be licensed under the same terms as Bluesky
+   itself.
+
+   See the LICENSE file for details.
+
+.. _proposal:
+
+Proposal Writing for BMM
+========================
+
+XAS Experiments
+---------------
+
+`Bruce Ravel <mailto:[email protected]>`__ supports XAS experiments at
+BMM.  If you have any questions about the capabilities of the beamline
+for XAS experiments or questions about an XAS proposal, contact him.
+
+When writing a proposal for beamtime, it is important to remember that
+you are justifying your *need for beamtime*.  This, then, is of a
+different sort than a funding proposal.  While justifying the
+importance of your science is certainly a part of the beamtime
+proposal, the main purpose is to tell the review panel and the
+beamline staff how you intend to use your beamtime effectively.
+
++ Explicitly state how many samples you intend to bring.
++ Explicitly state what the differences are between the samples.
++ If you will be measuring under *in situ* conditions |nd|
+  temperature, electrochemical potential, gas flow, or anything else
+  |nd| state what those conditions are.
++ If you are measuring a dopant, state the concentration of the dopant.
++ If you are measuring a low concentration sample |nd| for example the
+  amount of arsenic in a natural sample |nd| provide an estimate of
+  the concentration.  Even better, do elemental analysis of an aloquat
+  in the electron microscope or with ICP.
++ If you are measuring a thin film sample, state the thickness of the
+  sample and the areal dimensions of the sample.
++ If you have a matrix of sample conditions |nd| for example a range
+  of dopants, a range of absorption edges, and a range of annealing
+  conditions |nd| do the math.  Tell the reader how many XAS
+  emasurements are required.
++ Make sensible estimates about your time requirements.  Be prepared
+  to prioritize your samples if you are unable to get the full time
+  your request.
+
+.. admonition:: Ask questions early!
+   :class: note
+
+   If you have any questions about beamline capabilities, measurement
+   times, experimental feasibility, or any other issue pertinent to
+   your beamtime proposal, contact the beamline staff well before the
+   proposal deadline.
+
+XRD Experiments
+---------------
+
+`Vesna Stanic <mailto:[email protected]>`__ and `Jean Jordan-Sweet
+<[email protected]>`__ support scattering experiments at BMM.  If you have
+any questions about the capabilities of the beamline for scattering
+experiments or questions about a scattering proposal, contact them.
+
+BMM is equipped with a 6-circle psi goniometer, a strip detector, a
+small area detector, and point detectors.  This installation supports
+diffraction in the Bragg geometry and is optimized for reflectivity,
+pole figures, truncation rods, and other surface scattering
+measurements. 
+
+If you are looking for any
+scattering experiment in the Laue geometry, consider applying for time
+at `QAS <https://www.bnl.gov/nsls2/beamlines/beamline.php?r=7-BM>`__,
+`PDF <https://www.bnl.gov/nsls2/beamlines/beamline.php?r=28-ID-1>`__,
+or `XPD
+<https://www.bnl.gov/nsls2/beamlines/beamline.php?r=28-ID-2>`__.
+
+To be very clear, `pair distribution function analysis
+<https://doi.org/10.1098/rsta.2018.0413>`__ is not available at BMM.
+Any proposal requesting PDF analysis will be denied at feasibility
+review.
+
+.. admonition:: Ask questions early!
+   :class: note
+
+   If you have any questions about beamline capabilities, measurement
+   times, experimental feasibility, or any other issue pertinent to
+   your beamtime proposal, contact the beamline staff well before the
+   proposal deadline.
+
+
+Multi-modal Experiments
+-----------------------
+
+From time to time, users want to do both spectroscopy and scattering
+at BMM.  NSLS-II allows a user to request multiple measurement types
+in a single proposal.  This is called a "multi-modal" experiment.
+
+However, asking for XAS and XRD in a single proposal at BMM is an
+edge-case for the NSLS-II multi-modal program.
+
+It turns out that there is no way to request a multi-modal proposal
+where *different* measurement techniques are performed at the *same*
+beamline.  Thus, there is no way to send both parts of the multi-modal
+proposal to the relevant proposal review panels.
+
+As a result, if you wish to request both spectroscopy and scattering
+at BMM, you need to write **two proposals**.  That is the only way to
+route your work through the review system correctly.
+
+.. caution::
+
+   A proposal requesting both XAS and XRD at BMM will be denied at
+   feasibility and a link to this web page with be given as the
+   reason.