Understanding file formats in Grapher (GPJ, GRF, and GRT)

Grapher saves project files in three formats: GRF, GPJ, and GRT files. You can choose which extension to use when saving (click File | Save as and change the Save as type). The file format you will want to use is dependent on your needs.

Grapher Files (GRF)

Grapher GRF files save all information necessary to reproduce the graph with a link to the data. When you save a GRF, Grapher retains all scaling, formatting, and parameters for the graph within the file. GRF files do not store the data internally in the file.

If you share a GRF file, you will also need to share the data file(s) used to create the graph.  If the data file is renamed or removed, you will be prompted to select a new data file when the GRF file is opened.

Use this format if your data often changes (daily, weekly, or monthly reports for example), or if you need to link to an external data source.

Grapher Project Files (GPJ)

Grapher GPJ files store all the information necessary to reproduce the graph, including embedded data. All scaling, formatting, and parameters for the graph are preserved in the file.

If you share a GPJ file, you do not need to share your data files.  If your data changes, those changes will not automatically be reflected when a GPJ file is opened.  To update the graph with new data, select the graph and then click Graph Tools | Worksheet | Reload.

The GPJ format is best used to contain your plot and worksheet data in a single file for easy sharing, and when the data does not change often. 

Grapher Template Files (GRT)

Grapher GRT files store all the information necessary to reproduce the graph, except the data. A saved template file does not refer to any specific data file. When you save a GRT, all of the scaling, formatting, and parameters for the graph are saved and you can populate the template with any dataset. 

If you share a GRT file, you can share your data file(s) to recreate the original graph.  In most cases, other users will use their own datasets with your file to create graphs based on your template specifications.

Use Grapher’s GRT format when you need to recreate graphs using different datasets while maintaining the layout and styling of the original.  For example, you may want to create a template of a graph that you include in all reports to a client or regulatory agency.