readxyzfile

[x, y, z] = readxyzfile(xyzfilename, xyzfilelocation, zscale, domain, xmin, xmax, ymin, ymax, savedata, outfilename, outfilelocation)

Description

Read and extract x (longitude), y (latitude) and z (elevation) data from ASCII gridded (tabular) xyz file
Use readdatafile function for more options

Inputs

xyzfilename
Name of xyz file between ‘ ‘ mark, example: ‘xyzfile.xyz’
xyz file should be in form of 3 coloumn format
xyzfilelocation=pwd;
Location of xyz file between ‘ ‘ mark, example: ‘C:’
zscale=1;
Scale z (elevation) data by factor of zscale
domain=’all’;
Define a domain to be extracted from data
‘all’: all xyz data in input file are extracted
‘domain’: only data within a defined domain are extracted
xmin=-180;
Minimum x (longitude) of domain to be extracted
xmax=180;
Maximum x (longitude) of domain to be extracted
ymin=-90;
Minimum y (latitude) of domain to be extracted
ymax=90;
Maximum y (latitude) of domain to be extracted
savedata=’no’;
Define if save xyz data in a file or not in outfilelocation folder
‘no’: does not save
‘yes’: save xyz data as csv file
outfilename=’xyzdata.csv’;
Name of output file between ‘ ‘ mark, example: ‘xyzdata.csv’
outfilename should have ‘.csv’ extension
outfilelocation=pwd;
Location of output file between ‘ ‘ mark, example: ‘C:’

Outputs

x
x (longitude) data extracted from xyz file
y
y (latitude) data extracted from xyz file
z
z (elevation) data extracted from xyz file

Examples

xyzfilename='xyzfile.xyz'; %e.g. xyzfilename='PersianGulf_ETOPO1.xyz'
xyzfilelocation='C:\'; %e.g. xyzfilelocation='C:\datafolder'
[x,y,z]=readxyzfile(xyzfilename,xyzfilelocation);

xyzfilename='xyzfile.xyz'; %e.g. xyzfilename='PersianGulf_ETOPO1.xyz'
xyzfilelocation='C:\'; %e.g. xyzfilelocation='C:\datafolder'
[x,y,z]=readxyzfile(xyzfilename,xyzfilelocation,1,'all',-180,180,-90,90,'no');