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

FC_ISUBSET

Appendix A

FC_ISUBSET(index_list, lengths, nx, FullData) Returns a subset of a feature collection

 

 

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

 

 

Arguments:

Index_list

Starting indices of the features of interest

 

lengths

Lengths of the features of interest

Arguments:

nx

length of result (sum of lengths in argument 2)

Arguments:

FullData

input data: 1D list from which to select features

Result Axes:

X

CUSTOM: length is the sum of the lengths in arg 2

 

Y

NORMAL

 

Z

NORMAL

 

T

NORMAL

 

E

NORMAL

 

F

NORMAL

Note:
This is a grid-changing function.
It is generally advisable to include explicit limits when working with functions that replace axes.

Example:

Define a list which represents several features:Feature 1 starts with index 1, Feature 2 starts with index 2, Feature 3 starts with index 9.

yes? let alldata = {1,2,3, 31,32,33,34,35, 101,102,103,104,105,106}
 
! Pick out the second and third features.
yes? let indexlist = {4,9}
yes? let lengths = {5, 6}
yes? let nx = `lengths[x=@sum]`
yes? let fci = fc_isubset(indexlist, lengths, nx, alldata)
yes? list fci
VARIABLE : FC_ISUBSET(INDEXLIST, LENGTHS, NX, ALLDATA)
SUBSET : 11 points (X (X))
1 / 1: 31.0
2 / 2: 32.0
3 / 3: 33.0
4 / 4: 34.0
5 / 5: 35.0
6 / 6: 101.0
7 / 7: 102.0
8 / 8: 103.0
9 / 9: 104.0
10 / 10: 105.0
11 / 11: 106.0
 

Note that a similar thing could be accomplished by calling EXPNDI_BY_Z_COUNTS or EXPNDI_BY_M_COUNTS and then applying a mask in the Z or E direction.