From ba6a1130304634537a3af094aee278fac77f39b3 Mon Sep 17 00:00:00 2001 From: Thomas White Date: Thu, 9 Feb 2023 09:10:48 +0100 Subject: Tutorial: be clear about working directory The tutorial won't work, if followed exactly, unless the mask is in the working directory. Saving it next to the geometry file, but in a different folder, won't work. Fixes: https://gitlab.desy.de/thomas.white/crystfel/-/issues/77 --- doc/articles/tutorial.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/articles/tutorial.rst b/doc/articles/tutorial.rst index 117bc272..a6b7a4cf 100644 --- a/doc/articles/tutorial.rst +++ b/doc/articles/tutorial.rst @@ -33,6 +33,10 @@ Let's get started! 1. Download some data ===================== +Start by creating an empty directory to work in. You'll start by downloading a +few data files into your working directory. The files are large (38 Gb for the +file suggested below), so make sure you have enough disk space available. + There are many serial crystallography datasets available from the `Coherent X-ray Imaging Data Bank `_. For this tutorial, we'll use `dataset 103 `_. This datasaet is from an @@ -43,7 +47,6 @@ You can download as much data as you have disk space for, but one file is enough to demonstrate the principles. Here, we will use file `run7.JF06T32V01.h5 `_. -This file is 38 Gb in size, so make sure you have enough disk space available. Note also that the download can take some time to complete, even if you have a fast internet connection. @@ -59,13 +62,14 @@ features to CrystFEL and deprecate others. The geometry file on the website will still work fine, but we provide here an updated file which will work slightly more smoothly. If you've downloaded CrystFEL, you'll find it in `doc/examples/jf-swissfel-16M.geom `_. -Otherwise, click the link to download a copy. +Otherwise, click the link to download a copy, and save it in your working +directory. Finally, you'll need a *bad pixel map* which contains the information about which pixels of the detector cannot be trusted. This file is also available from the CXIDB. Download it here - `run47.JF06T32V01.mask.h5 `_ -- and save it alongside the geometry and data files. +- and save it in your working directory, alongside the geometry and data files. Advanced -------- @@ -91,6 +95,11 @@ the file provided here, they are as follows: Provided that CrystFEL has been installed properly, you can start the graphical user interface (GUI) by running the command ``crystfel`` at a command line. +Make sure that you do this from the working directory, for example:: + + $ cd my-working-directory + $ crystfel + An empty workspace should open, which looks like the picture below. If not, see `INSTALL.md <../../INSTALL.md>`_ for details, or ask your facility or lab's computing team. -- cgit v1.2.3