# Job: Import Beam Shift

## **At A Glance**

Add beam shifts to existing exposures.

## **Description**

The Import Beam Shift job is a new job as of CryoSPARC v4.4, created to add EPU session beam shift information to existing exposures datasets in CryoSPARC, without need for re-importing the movies/micrographs from scratch. For new movie and micrograph imports, beam shift info can be directly imported in the [Import Movies](https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/import/job-import-movies) and [Import Micrographs](https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/import/job-import-micrographs) jobs.

{% hint style="info" %}
For additional information on importing movies with XML files, refer to the [EPU AFIS Beam Shift Tutorial](https://guide.cryosparc.com/processing-data/tutorials-and-case-studies/tutorial-epu-afis-beam-shift-import).
{% endhint %}

## **Inputs**

### Exposures

An existing exposure (movie and/or micrograph) dataset in CryoSPARC.

## **Commonly Adjusted Parameters**

### EPU XML metadata path

An absolute path, wildcard-expression (e.g. `/mount/data/somewhere/*.xml`) for importing EPU XML files with beam shift. Only `.xml` files are supported.

### Path matching parameters

These four parameters exist to assist in matching movie/micrograph paths (stored in `movie_blob/path` or `micrograph_blob/path`, respectively) to the XML file paths imported from the above `EPU XML metadata path` wildcard expression. Examples of the trimmed file paths will be printed to the event log to help determine the number of characters. The values of these parameters is most quickly determined by running this job with all defaults, and observing the event log. See the [Import Micrographs](https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/job-import-micrographs#linking-micrographs-to-input-movies) page for more information on how to use parameters like these.

* `Length of movie filename prefix to cut for XML correspondence`**:** Use this field to specify the number of characters to cut off the prefix of the imported movie filename, to match with the XML filename.
* `Length of movie filename suffix to cut for XML correspondence`**:** Use this field to specify the number of characters to cut off the suffix of the imported movie filename, to match with the XML filename.
* `Length of XML filename prefix to cut for movie correspondence`**:** Use this field to specify the number of characters to cut off the prefix of the XML filename, to match with the imported movie filename.
* `Length of XML filename suffix to cut for movie correspondence`**:** Use this field to specify the number of characters to cut off the suffix of the XML filename, to match with the imported movie filename.

## **Outputs**

* Exposures dataset with imported beam shift values

## **Common Next Steps**

* [CTF Estimation](https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/ctf-estimation/job-patch-ctf-estimation)
* [Exposure Group Utilities](https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/ctf-refinement/job-exposure-group-utilities)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.cryosparc.com/processing-data/all-job-types-in-cryosparc/import/job-import-beam-shift.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.