NCEPLIBS-bufr  11.7.0
 All Data Structures Files Functions Variables Pages
conwin.f File Reference

Go to the source code of this file.

Functions/Subroutines

subroutine conwin (LUN, INC1, INC2)
 THIS SUBROUTINE SEARCHES CONSECUTIVE SUBSET BUFFER SEGMENTS FOR AN ELEMENT IDENTIFIED IN THE USER STRING AS A CONDITIONAL NODE (I.E. More...
 

Detailed Description

Author
WOOLLEN
Date
1994-01-06

Definition in file conwin.f.

Function/Subroutine Documentation

subroutine conwin (   LUN,
  INC1,
  INC2 
)

THIS SUBROUTINE SEARCHES CONSECUTIVE SUBSET BUFFER SEGMENTS FOR AN ELEMENT IDENTIFIED IN THE USER STRING AS A CONDITIONAL NODE (I.E.

AN ELEMENT WHICH MUST MEET A CONDITION IN ORDER TO BE READ FROM OR WRITTEN TO A DATA SUBSET). IF A CONDITIONAL ELEMENT IS FOUND AND IT CONFORMS TO THE CONDITION, THEN THE INTERNAL SUBSET BUFFER INDICES OF THE "WINDOW" (SEE BELOW REMARKS) ARE RETURNED TO THE CALLER FOR PROCESSING.

THE FOUR CONDITIONS WHICH CAN BE EXERCISED ARE: '<' - LESS THAN '>' - GREATER THAN '=' - EQUAL '!' - NOT EQUAL

EACH CONDITION IN A STRING IS APPLIED TO ONE ELEMENT, AND ALL CONDITIONS ARE 'AND'ED TO EVALUATE AN OUTCOME. FOR EXAMPLE, IF THE CONDITION STRING IS: "POB<500 TOB>30 TQM<4" THEN THE ONLY LEVELS OF DATA READ OR WRITTEN ARE THOSE WITH PRESSURE LT 500 MB, TEMPERATURE GT 30 DEG, AND TEMPERATURE QUALITY MARK < 4.

PROGRAM HISTORY LOG: 1994-01-06 J. WOOLLEN – ORIGINAL AUTHOR 1998-07-08 J. WOOLLEN – IMPROVED MACHINE PORTABILITY 1999-11-18 J. WOOLLEN – THE NUMBER OF BUFR FILES WHICH CAN BE OPENED AT ONE TIME INCREASED FROM 10 TO 32 (NECESSARY IN ORDER TO PROCESS MULTIPLE BUFR FILES UNDER THE MPI) 2003-11-04 S. BENDER – ADDED REMARKS/BUFRLIB ROUTINE INTERDEPENDENCIES 2003-11-04 D. KEYSER – MAXJL (MAXIMUM NUMBER OF JUMP/LINK ENTRIES) INCREASED FROM 15000 TO 16000 (WAS IN VERIFICATION VERSION); UNIFIED/PORTABLE FOR WRF; ADDED DOCUMENTATION (INCLUDING HISTORY) 2010-04-27 J. WOOLLEN – CORRECT LOGICAL FLAW AND ADD DOCUMENTATION 2014-12-10 J. ATOR – USE MODULES INSTEAD OF COMMON BLOCKS

USAGE: CALL CONWIN (LUN, INC1, INC2) INPUT ARGUMENT LIST: LUN - INTEGER: I/O STREAM INDEX INTO INTERNAL MEMORY ARRAYS INC1 - INTEGER: SUBSET BUFFER START INDEX INC2 - INTEGER: SUBSET BUFFER ENDING INDEX

OUTPUT ARGUMENT LIST: INC1 - INTEGER: SUBSET BUFFER START INDEX INC2 - INTEGER: SUBSET BUFFER ENDING INDEX

REMARKS:

SEE THE DOCBLOCK IN BUFR ARCHIVE LIBRARY SUBROUTINE GETWIN FOR AN EXPLANATION OF "WINDOWS" WITHIN THE CONTEXT OF A BUFR DATA SUBSET.

FUNCTION CONWIN WORKS WITH FUNCTION INVCON TO IDENTIFY SUBSET BUFFER SEGMENTS WHICH CONFORM TO THE SET OF CONDITIONS.

THIS ROUTINE CALLS: GETWIN INVCON THIS ROUTINE IS CALLED BY: UFBEVN UFBIN3 UFBRW Normally not called by any application programs.

Definition at line 64 of file conwin.f.

References getwin(), and invcon().

Referenced by ufbevn(), ufbin3(), and ufbrw().