read_scrip_grid.h File Reference

#include "basic_grid.h"

Include dependency graph for read_scrip_grid.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
struct yac_basic_grid_data	yac_read_scrip_basic_grid_data (char const *grid_filename, char const *mask_filename, char const *grid_name, int valid_mask_value, int use_ll_edges)
struct yac_basic_grid *	yac_read_scrip_basic_grid (char const *grid_filename, char const *mask_filename, char const *grid_name, int valid_mask_value, char const *name, int use_ll_edges, size_t *cell_coord_idx, size_t **duplicated_cell_idx, yac_int **orig_cell_global_ids, size_t *nbr_duplicated_cells)
struct yac_basic_grid *	yac_read_scrip_basic_grid_parallel (char const *grid_filename, char const *mask_filename, MPI_Comm comm, char const *grid_name, int valid_mask_value, char const *name, int use_ll_edges, size_t *cell_coord_idx, size_t **duplicated_cell_idx, yac_int **orig_cell_global_ids, size_t *nbr_duplicated_cells)
void	yac_read_scrip_grid_information (char const *grid_filename, char const *mask_filename, char const *grid_name, int valid_mask_value, size_t *num_vertices, size_t *num_cells, int **num_vertices_per_cell, double **x_vertices, double **y_vertices, double **x_cells, double **y_cells, int **cell_to_vertex, int **cell_core_mask, size_t **duplicated_cell_idx, size_t **orig_cell_idx, size_t *nbr_duplicated_cells)

Function Documentation

yac_read_scrip_basic_grid()

struct yac_basic_grid * yac_read_scrip_basic_grid	(	char const *	grid_filename,
		char const *	mask_filename,
		char const *	grid_name,
		int	valid_mask_value,
		char const *	name,
		int	use_ll_edges,
		size_t *	cell_coord_idx,
		size_t **	duplicated_cell_idx,
		yac_int **	orig_cell_global_ids,
		size_t *	nbr_duplicated_cells )

reads in grid data from a SCRIP formated file

Parameters

[in]	grid_filename	name of the SCRIP grid netcdf file
[in]	mask_filename	name of the SCRIP mask netcdf file
[in]	grid_name	name of the grid in the file
[in]	valid_mask_value	value that marks cells as valid
[in]	name	name of the grid
[in]	use_ll_edges	if possible represent all edges using lon/lat circles
[out]	cell_coord_idx	index at which cell centers are registerd in the basic grid
[out]	duplicated_cell_idx	indices of all duplicated cells
[out]	orig_cell_global_ids	global ids of the original cells
[out]	nbr_duplicated_cells	number of duplicated cells

Returns

basic grid

Remarks

This routine will allocate the arrays duplicated_cell_idx and orig_cell_global_ids. The user is responsible for freeing them.

NULL is a valid argument for cell_coord_idx, duplicated_cell_idx, orig_cell_global_ids, and nbr_duplicated_cells

Definition at line 943 of file read_scrip_grid.c.

Here is the call graph for this function:

yac_read_scrip_basic_grid_data()

struct yac_basic_grid_data yac_read_scrip_basic_grid_data	(	char const *	grid_filename,
		char const *	mask_filename,
		char const *	grid_name,
		int	valid_mask_value,
		int	use_ll_edges )

reads in an grid in SCRIP format

Parameters

[in]	grid_filename	name of the SCRIP grid netcdf file
[in]	mask_filename	name of the SCRIP mask netcdf file
[in]	grid_name	name of the grid in the file
[in]	valid_mask_value	value that marks cells as valid
[in]	use_ll_edges	if possible represent all edges using lon/lat circles

Returns

yac_basic_grid_data structure that contains the grid

Definition at line 879 of file read_scrip_grid.c.

Here is the call graph for this function:

Here is the caller graph for this function:

yac_read_scrip_basic_grid_parallel()

struct yac_basic_grid * yac_read_scrip_basic_grid_parallel	(	char const *	grid_filename,
		char const *	mask_filename,
		MPI_Comm	comm,
		char const *	grid_name,
		int	valid_mask_value,
		char const *	name,
		int	use_ll_edges,
		size_t *	cell_coord_idx,
		size_t **	duplicated_cell_idx,
		yac_int **	orig_cell_global_ids,
		size_t *	nbr_duplicated_cells )

reads in grid data from a SCRIP formated file in parallel and applies a IO decomposition to it

Parameters

[in]	grid_filename	name of the SCRIP grid netcdf file
[in]	mask_filename	name of the SCRIP mask netcdf file
[in]	comm	MPI communicator containing all proceses that will get a part of the grid
[in]	grid_name	name of the grid in the file
[in]	valid_mask_value	value that marks cells as valid
[in]	name	name of the grid
[in]	use_ll_edges	if possible represent all edges using lon/lat circles
[out]	cell_coord_idx	index at which cell centers are registerd in the basic grid
[out]	duplicated_cell_idx	indices of all duplicated cells
[out]	orig_cell_global_ids	global ids of the original cells
[out]	nbr_duplicated_cells	number of duplicated cells

Returns

basic grid

Remarks

This routine will allocate the arrays duplicated_cell_idx and orig_cell_global_ids. The user is responsible for freeing them.

NULL is a valid argument for cell_coord_idx, duplicated_cell_idx, orig_cell_global_ids, and nbr_duplicated_cells

Definition at line 890 of file read_scrip_grid.c.

Here is the call graph for this function:

Here is the caller graph for this function:

yac_read_scrip_grid_information()

void yac_read_scrip_grid_information	(	char const *	grid_filename,
		char const *	mask_filename,
		char const *	grid_name,
		int	valid_mask_value,
		size_t *	num_vertices,
		size_t *	num_cells,
		int **	num_vertices_per_cell,
		double **	x_vertices,
		double **	y_vertices,
		double **	x_cells,
		double **	y_cells,
		int **	cell_to_vertex,
		int **	cell_core_mask,
		size_t **	duplicated_cell_idx,
		size_t **	orig_cell_idx,
		size_t *	nbr_duplicated_cells )

reads in an grid in SCRIP format

Parameters

[in]	grid_filename	name of the SCRIP grid netcdf file
[in]	mask_filename	name of the SCRIP mask netcdf file
[in]	grid_name	name of the grid in the file
[in]	valid_mask_value	value that marks cells as valid
[out]	num_vertices	number of vertices in the grid
[out]	num_cells	number of cells in the grid
[out]	num_vertices_per_cell	number of vertices per cell
[out]	x_vertices	longitude coordinates of the vertices
[out]	y_vertices	latitude coordinates of the vertices
[out]	x_cells	longitude coordinates of cell points
[out]	y_cells	latitude coordinates of cell points
[out]	cell_to_vertex	vertices indices per cell
[out]	cell_core_mask	cell core mask
[out]	duplicated_cell_idx	indices of all duplicated cells
[out]	orig_cell_idx	indices of the original cells
[out]	nbr_duplicated_cells	number of duplicated cells

Remarks

NULL is a valid argument for duplicated_cell_idx, orig_cell_idx, and nbr_duplicated_cells

Definition at line 658 of file read_scrip_grid.c.

Here is the call graph for this function:

Here is the caller graph for this function: