RefList utilities

RefList utilities — Reflection list utilities

Synopsis

#include "reflist-utils.h"


int                 write_reflist                       (const char *filename,
                                                         RefList *list);
void                write_reflections_to_file           (FILE *fh,
                                                         RefList *list);
RefList *           read_reflections                    (const char *filename);
RefList *           read_reflections_from_file          (FILE *fh);
RefList *           asymmetric_indices                  (RefList *in,
                                                         const SymOpList *sym);
RefList *           res_cutoff                          (RefList *list,
                                                         UnitCell *cell,
                                                         double min,
                                                         double max);

Description

There are some utility functions associated with the core RefList.

Details

write_reflist ()

int                 write_reflist                       (const char *filename,
                                                         RefList *list);

This function writes the contents of list to file,

Reflections which have a redundancy of zero will not be written.

The resulting list can be read back with read_reflections_from_file() or read_reflections().

This is a convenience function which simply opens filename and then calls write_reflections_to_file.

filename :

Filename

list :

The reflection list to write

Returns :

zero on success, non-zero on failure.

write_reflections_to_file ()

void                write_reflections_to_file           (FILE *fh,
                                                         RefList *list);

This function writes the contents of list to fh,

Reflections which have a redundancy of zero will not be written.

The resulting list can be read back with read_reflections_from_file().

fh :

File handle to write to

list :

The reflection list to write

read_reflections ()

RefList *           read_reflections                    (const char *filename);

read_reflections_from_file ()

RefList *           read_reflections_from_file          (FILE *fh);

asymmetric_indices ()

RefList *           asymmetric_indices                  (RefList *in,
                                                         const SymOpList *sym);

This function creates a newly allocated copy of in, but indexed using the asymmetric indices according to sym instead of the original indices. The original indices are stored and can be retrieved using get_symmetric_indices() if required.

in :

A RefList

sym :

A SymOpList

Returns :

the new RefList, or NULL on failure.

res_cutoff ()

RefList *           res_cutoff                          (RefList *list,
                                                         UnitCell *cell,
                                                         double min,
                                                         double max);

Applies a resolution cutoff to list, returning the new version and freeing the old version.

list :

A RefList

Returns :

A new RefList with resolution cutoff applied