Your Questions Answered!
- Can I run my copy of Datasqueeze on more than one computer?
Your licence allows you to run the full version on at most 5 computers. The spirit of this rule is that a research unit (an academic research group, a synchrotron beamline, an analytical unit in a company, etc.) should not have to buy more than one copy, but that a large institution (university or university department, a synchrotron, a company, etc.) should not just buy one copy and use it for dozens or hundreds of computers. Contact us for detailed information on site licences.
- Can I run Datasqueeze from a central server?
See the previous question. There is nothing to prevent you from running Datasqueeze in an X-windows environment from a central server as long as no more than 5 computers have access to it. The program should not be installed on a larger central server to which many users have access.
- On what types of Windows will Datasqueeze run?
The program will run on all versions of Windows, as long as Java 1.8 or above is installed.
- Will Datasqueeze on my Unix/Linux machine?
It should run fine on any Linux machine that has Java 1.8 or above installed. It might very well run on another flavor of Unix with Java correctly installed, but this has not been tested--contact us if you make it work!! The one caveat is that printing is not currently supported for Linux.
- Will Datasqueeze run on a computer that is not PC, Macintosh, or Unix?
It should, as long as Java 1.8 or above is installed, but this has not been tested. In any case, some aspects of the program (e.g., the locations of files) are operating-system dependent, so things might not work optimally.
- What is the difference between Trial and Paid versions?
The trial version will only run for 10 days. After that you must pay if you wish to continue using the program.
http://www.datasqueezesoftware.com/purchase.html to upgrade.
Otherwise they are identical.
- I only get part of the graphical interface that I should have--it
seems to run off the screen. What is wrong?
Datasqueeze will not work unless the screen resolution is set to at least
1024x768. Assuming that you have a monitor capable of this resolution, you will need to
use the Control Panel or System Preferences to increase the resolution.
- Windows: when I try to launch Datasqueeze I get a panel saying
"Unable to launch Java Application" or a message saying something about "Main class not found". What is wrong?
You probably have an older version of Java running--Datasqueeze expects
at least Java 1.8, or possibly your computer came bundled with JavaSoft.
Go to the Java site to download the latest version.
See instructions for upgrading
your version of Java.
- Linux: Datasqueeze refuses to start,
with an error message saying
something about a classpath What is wrong?
You probably have an older version of Java running--Datasqueeze expects
at least Java 1.8. See instructions for upgrading
your version of Java.
- What kinds of data file can Datasqueeze read?
Click here for the complete list of currently supported
- Datasqueeze does not read data files produced by my detector. What can I do?
We are continuously adding more format as the demand arises; contact us if there is a particular data format you would like to see added.
- I saved my data as a GIF (or JPG or PNG) file. I can read it back with Datasqueeze,
but the data are quite different. What is wrong?
Graphics files are really intended only as a way of reading in non-xray data, for example
produced as a Fourier transform of some optical image. A graphics file is not the
same as the original data file. A typical data file is at least 1024x1024 pixels, and has a depth
of at least 16 bits (depending on the detector type). Graphics images are generally much
smaller (so spatial resolution has been lost) and have much less dynamic range. Additionally,
note that Datasqueeze expects grayscale images. It converts the image color to an
intensity by adding the red, blue, and green components. If you start with a
color image, this is almost certainly not how the data were originally encoded.
- Can Datasqueeze read in graphics images that are not TIFF, GIF,
JPG, or PNG?
Not right now--expansion of this feature will be driven by customer demand.
- Datasqueeze returns an error when opening a file that I think is valid. What should I do?
There are several possible origins for this problem:
- Your file may have been corrupted. This can happen, for example, if you use FTP or a similar protocol
to transfer the file from one computer to another. When doing this, you should always using
the "binary" option if it exists, rather than "Auto" or "Text."
If you suspect that your file may be corrupted, try transferring it back to the original datataking
computer and see if the original software that wrote it can read it.
- You may be looking at a graphical image of the file rather than the data file itself.
With rare exceptions, a graphics image (jpeg, gif, etc.) has far less information content
than the original data file, and in any case is in a different format. Look at the size--a typical x-ray
data file is at least 1MB, and often much larger.
- If your problem is none of the above, it is possible that this is a data file format not currently
recognized by Datasqueeze. Please contact contact us
with as much
information as you can provide about the file you are trying to read.
- My image plate data seem to consist mostly of zeros, even though I know that
there is really structure there. What is wrong?
The Fuji image plate data are recorded in logarithic form. When they are read back in, they
are restored to linear form by exponention (i.e., Icalc = A x 10^(Imeas/I0)).
Depending on the range of the data, it is possible that many or most of your data points
are less than 1 (such as 0.01). Try multiplying the data by some large number such as 10000 when you
open the file.
- What are x-center and y-center?
In most diffraction applications, the primary beam is blocked by a beam stop. The beam center is the position at which the beam would have hit if it were not blocked. It will be at the center of any Bragg rings. Often this is close to the physical center of the detector, although sometimes it is near one edge of the detector. X-center and Y-center are the values of the pixels corresponding to the center of the diffraction pattern. So for example for a 1024 x 1024 pixel2 detector with the beam exactly in the center, X-center and Y-center would both be equal to 512.
- What is the q-range?
It is the value of q (= 4 pi sin(theta) / lambda) corresponding to the maximum horizontal range of the detector. This is set once for a particular data set to determine the relationship between the distance in pixels between a feature of interest and the origin and the q-value corresponding to that feature.
- What is a Bruker standards file and how do I use it?
You are supplied with a file called agbe.std, which is a text file containing powder diffraction information on Silver Behenate, a common calibration standard. If you have previously calibrated your detector with AgBe you can use this file with the Calibrate window to easily establish the center, q-range, etc., of your detector. If you have used some other calibration standard, you can easily use any text editor to create a standards file of your own, using agbe.std as a model.
Note however that this is one place where the
number format is not locale-dependent; the d-spacings should all
use the American format. That is, a d-spacing that is a little over
45 Angstroms should be written as 45.3 rather than 45,3.
- Diffraction patterns that should be circular look oval. What is
wrong, and what can be done about it?
This can come about in one of several ways. The most common is that
your detector is not exactly perpendicular to the incident beam. It is also possible
that the x- and y-directions have different gains, or equivalent that the pixels are not
exactly square. All of these can be easily corrected by Datasqueeze, either manually
or by using the supplied wizard. The Tilt/Azimuth
combination on the Image and Calibrate windows correct for a detector that is
tilted an arbitrary amount about an arbitrary axis relative to the central beam.
- When I go to make a plot it does not graph the full range that I selected.
Check the "Delta" value (the increment corresponding to the spacing between points). If it is larger than the full range of the plot then you will only get 1 or 2 points. If it is much smaller than your plot might actually consist of thousands of points, and the program cuts off with a maximum number of points. You should typically set the "Delta" so that you have something like 100 points in your plot, but also so that the increment is not smaller than one pixel.
- When I go to make a plot I get something crazy-looking that oscillates rapidly.
See the previous question. If the "Delta" increment is smaller than one pixel then some points will have data associated with them and some will not.
- The text file that is produced by saving plots seems to have
a lot of blank lines (every other one).
Did you transfer your file from one computer to another? These extra newline characters
are sometimes inserted by ftp applications (e.g. Fetch, WS_FTP, Filezilla) if it recognizes the file as being
"text." Try telling the ftp that the file is "binary". This is a slower, but more reliable
way, of transferring files.
The problem arises because different operating sytems have different ideas of what constitutes
a "new line." Datasqueeze inserts "\r\n", which seems to work on all the operating systems
we have tried, but is sometimes translated by ftp applications into "\n\n".
- Peaks do not Appear at Expected Q-Values or Angles.
This is almost certainly a calibration problem. You need to know enough about your detector to set
several parameters. Go to the Calibrate window. First, you need to set Lambda (the wavelength).
This is crucial! After that, you have several options:
- You can set the Q-range. This is, roughly speaking, the value of Q at one edge of the detector
if the beamstop is in the center. You optimize it until peaks appear at the right position. See the
manual entry on Calibration for more details.
- You can set 2theta-max. This accomplishes the same thing as setting Q-range, for those who are more
comfortable using the language of angles than the language of momentum transfer.
- You can set both the sample-detector distance and the detector radius. (The radius should always be the
same for a given detector, but the sample-detector distance may vary from one measurement to another).
- Peaks are broadened or distorted.
If plotted peaks appear broad or distorted even though the powder diffraction rings in the false color image are
sharp, this is almost certainly a calibration problem. The best way to set the calibration is to use the Calibration Wizard,
but if you want to set things manual there are two obvious things to check:
- The beam center (X-center and Y-center in the Calibration window) may not be completely set.
Note that the beam center is not in general exactly at the geometrical center of the beam stop.
Use the "Circle" option in the Image window to see whether the powder diffraction rings are really centered.
Or, make radial plots over limited ranges of Chi and verify that the peaks come at the same positions independent of Chi.
- It is also possible that the diffraction rings are not perfectly circular--see the discussion of Oval
patterns above. You may need to change the Tilt in the Calibration window.
- I want to make a Qx-Qy plot through a fiber pattern that is somewhat tilted. Is there a way to do this?
Yes, there is a "Chi Offset" feature that allows you to change the definition of the orientation that we call the "equator".