IBP banding data system: Internal maintenance specification

This method checks the location or station code following the “@” at the beginning of the page header line. If the parent compiler has a .location attribute that is not None, we expect that location's location code; otherwise we expect the parent compiler's .station code.

# - - -   P a g e H e a d e r . c h e c k S i t e   - - -

    @staticmethod
    def checkSite(compiler, scan, rawSite):
        '''Verify correct location or station code.

          [ (compiler is a BaseCompiler object) and
            (scan is a Scan object) and
            (rawSite is a string) ->
              if (compiler.location is not None) and
              (rawSite matches compiler.location.locCode, case
              insensitive) ->
                return True
              else if (compiler.location is None) and
              (rawSite matches compiler.station.staNo) ->
                return True
              else ->
                Log()  +:=  error message
                return False ]
        '''
        #-- 1 --
        if  compiler.location is None:
            if (compiler.station.staNo != rawSite):
                scan.error("Wrong staation code '%s': expecting "
                    "'%s'" % (rawSite, compiler.station.staNo))
                return False
            else:
                return True
        else:
            if (compiler.location.locCode.upper() !=
                  rawSite.upper()):
                scan.error("Wrong location code '%s': expecting "
                    "'%s'" % (rawSite, compiler.location.locCode))
                return False
            else:
                return True