Skip to main content
  • Home
  • Documentation
  • FAQ
  • Downloads
  • Support
  • Current Release Notes
  • Ferret Users Guide
    • Users Guide Index
    • Commands Reference
    • 1. Introduction
    • 2. Data Set Basics
    • 3. Variables & Expressions
    • 4. Grids & Regions
    • 5. Animations & Gif Images
    • 6. Customizing Plots
    • 7. Handling String Data Symbols
    • 8. Working with Special Data Sets
    • 9. Computing Environment
    • 10. Converting to NetCDF
    • 11. Writing External Functions
    • Glossary
    • Appendix A: Functions
    • Appendix B: PPLUS Guide
    • Appendix C: Ferret-Specific PPLUS Enhancements
  • Previous Release Notes
  • Tutorials and Demos
    • Ferret Tour
    • DSG files: Discrete Sampling Geometries Demo
    • Ferret sorting demo
    • Fast Fourier Transforms demo
    • Empirical Orthogonal Functions demo
    • Ferret objective analysis demo
    • Ferret Palette Demo
    • Map projections
    • Ferret polygon vector demo
    • Ferret Graticules demo
    • Ferret Polytube Demo
    • Ferret Polymark Demo
    • Ferret Constant-Array demo
    • Ferret land_detail demo
    • COADS Tour
    • Levitus Tour
    • Use OPeNDAP
    • Ferret binary read demo
  • PyFerret
    • PyFerret Downloads and Install ../../faq/ferret-faqs.html
    • What is PyFerret?
    • Why use PyFerret?
    • PyFerret for the Ferret user
    • PyFerret command syntax: quick-start notes
    • PyFerret for the Python user
    • Graphics in PyFerret ?
    • New Ferret functionality
    • PyFerret Python functions and constants
    • PyFerret Python objects and methods
    • Ferret external functions in Python
    • Ferret Fortran external functions
    • PyFerret metadata-and-data dictionaries
  • OPeNDAP
    • OPeNDAP usage in Ferret
    • Use OPeNDAP Demo
    • Test OPeNDAP

ECAT and ECAT_STR

Appendix A

ECAT and ECAT_STR

ECAT (A, B )

Concatenates the values of two variables into one list on an abstract E axis.

Arguments:

A

variables to concatenate in E

 

B

 

Result Axes:

X

Inherited from variables A and B

 

Y

Inherited from variables A and B

 

Z

Inherited from variables A and B

 

T

Inherited from variables A and B

 

E

Abstract, with length the sum of the length of the E axes of A and B

 

F

Inherited from variables A and B

Note:
This is a grid-changing function.
It is generally advisable to include explicit limits when working with functions that replace axes. for example, consider the function xcat(a,b). Look at the expressions

list/m=10:20 ecat(a,b)

and

list mcat(a[m=16:20],b[m=1:5])

Both will list 10 values in the E direction. The former will list the 10th through 20th data values indices from the entire M range of both variables. The latter will list all of the data that results from concatenating b[m=1:5] onto a[m=16:20].

 

ECAT_STR (sA, sB) concatenates string variables in the X direction. If ECAT is called with string arguments, Ferret runs ECAT_STR. The two arguments to ECAT must be of the same type.

 

yes? let a = esequence({"Q", "R", "S"})
yes? let b = esequence({"U", "V", "W"})
yes? list ecat(a,b)