Trees       Indices       Help   
Package ais :: Module ais_msg_19
[hide private]
[frames] | no frames]

Module ais_msg_19

source code

Autogenerated python functions to serialize/deserialize binary messages.

Generated by: ./aisxmlbinmsg2py.py

Need to then wrap these functions with the outer AIS packet and then convert the whole binary blob to a NMEA string. Those functions are not currently provided in this file.

serialize: python to ais binary deserialize: ais binary to python

The generated code uses translators.py, binary.py, and aisstring.py which should be packaged with the resulting files.

Requires:

Author: xmlbinmsg

Version: 4791

Status: under development

License: Generated code has no license

To Do: FIX: put in a description of the message here with fields and types.

Date: 2008-01-09

Classes [hide private]
  Testb_pos_and_shipdata_broken
Use testvalue tag text from each type to build test case the b_pos_and_shipdata_broken message
Functions [hide private]
BitVector
encode(params, validate=False)
Create a b_pos_and_shipdata_broken binary message payload to pack into an AIS Msg b_pos_and_shipdata_broken.		 source code
dict
decode(bv, validate=False)
Unpack a b_pos_and_shipdata_broken message		 source code
 
decodeMessageID(bv, validate=False) source code
 
decodeRepeatIndicator(bv, validate=False) source code
 
decodeUserID(bv, validate=False) source code
 
decodeSpare(bv, validate=False) source code
 
decodeSOG(bv, validate=False) source code
 
decodePositionAccuracy(bv, validate=False) source code
 
decodelongitude(bv, validate=False) source code
 
decodelatitude(bv, validate=False) source code
 
decodeCOG(bv, validate=False) source code
 
decodeTrueHeading(bv, validate=False) source code
 
decodeTimeStamp(bv, validate=False) source code
 
decodeSpare2(bv, validate=False) source code
 
decodename(bv, validate=False) source code
 
decodeshipandcargo(bv, validate=False) source code
 
decodedimA(bv, validate=False) source code
 
decodedimB(bv, validate=False) source code
 
decodedimC(bv, validate=False) source code
 
decodedimD(bv, validate=False) source code
 
decodefixtype(bv, validate=False) source code
 
decodeRAIM(bv, validate=False) source code
 
decodeDTE(bv, validate=False) source code
 
decodeSpare3(bv, validate=False) source code
 
printHtml(params, out=sys.stdout) source code
 
printKml(params, out=sys.stdout)
KML (Keyhole Markup Language) for Google Earth, but without the header/footer		 source code
stdout
printFields(params, out=sys.stdout, format='std', fieldList=None, dbType='postgres')
Print a b_pos_and_shipdata_broken message to stdout.		 source code
str
sqlCreateStr(outfile=sys.stdout, fields=None, extraFields=None, addCoastGuardFields=True, dbType='postgres')
Return the SQL CREATE command for this message type		 source code
sqlhelp.create
sqlCreate(fields=None, extraFields=None, addCoastGuardFields=True, dbType='postgres')
Return the sqlhelp object to create the table.		 source code
str
sqlInsertStr(params, outfile=sys.stdout, extraParams=None, dbType='postgres')
Return the SQL INSERT command for this message type		 source code
sqlhelp.insert
sqlInsert(params, extraParams=None, dbType='postgres')
Give the SQL INSERT statement		 source code
str
latexDefinitionTable(outfile=sys.stdout)
Return the LaTeX definition table for this message type		 source code
str
textDefinitionTable(outfile=sys.stdout, delim='\t')
Return the text definition table for this message type		 source code
dict
testParams()
Return a params file base on the testvalue tags.		 source code
 
addMsgOptions(parser) source code
Variables [hide private]
  TrueBV = BitVector(bitstring= "1")
Why always rebuild the True bit? This should speed things up a bunch
  FalseBV = BitVector(bitstring= "0")
Why always rebuild the False bit? This should speed things up a bunch
  fieldList = ('MessageID', 'RepeatIndicator', 'UserID', 'Spare'...
  fieldListPostgres = ('MessageID', 'RepeatIndicator', 'UserID',...
  toPgFields = {'latitude': 'Position', 'longitude': 'Position'}
Go to the Postgis field names from the straight field name
  fromPgFields = {'Position': ('longitude', 'latitude')}
Go from the Postgis field names to the straight field name
  pgTypes = {'Position': 'POINT'}
Lookup table for each postgis field name to get its type.
  RepeatIndicatorEncodeLut = {'default': '0', 'do not repeat any...
  RepeatIndicatorDecodeLut = {'0': 'default', '3': 'do not repea...
  SOGEncodeLut = {'102.2 knots or higher': '102.2'}
  SOGDecodeLut = {'102.2': '102.2 knots or higher'}
  PositionAccuracyEncodeLut = {'high (less than 10 m)': '1', 'lo...
  PositionAccuracyDecodeLut = {'0': 'low (greater than 10 m)', '...
  TimeStampEncodeLut = {'dead reckoning': '62', 'inoperative': '...
  TimeStampDecodeLut = {'60': 'not available/default', '61': 'ma...
  shipandcargoEncodeLut = {'High speed craft (HSC), Hazardous ca...
  shipandcargoDecodeLut = {'20': 'Wing in ground (WIG), all ship...
  dimCEncodeLut = {'63 m or greater': '63'}
  dimCDecodeLut = {'63': '63 m or greater'}
  dimDEncodeLut = {'63 m or greater': '63'}
  dimDDecodeLut = {'63': '63 m or greater'}
  fixtypeEncodeLut = {'Chayka': '5', 'GLONASS': '2', 'GPS': '1',...
  fixtypeDecodeLut = {'0': 'undefined', '1': 'GPS', '2': 'GLONAS...
  RAIMEncodeLut = {'in use': 'True', 'not in use': 'False'}
  RAIMDecodeLut = {'False': 'not in use', 'True': 'in use'}
  DTEEncodeLut = {'available': '0', 'not available': '1'}
  DTEDecodeLut = {'0': 'available', '1': 'not available'}
  dbTableName = 'b_pos_and_shipdata_broken'
Database table name
Function Details [hide private]

encode(params, validate=False)

source code 

Create a b_pos_and_shipdata_broken binary message payload to pack into an AIS Msg b_pos_and_shipdata_broken.

Fields in params:
  • MessageID(uint): AIS message number. Must be 19 (field automatically set to "19")
  • RepeatIndicator(uint): Indicated how many times a message has been repeated
  • UserID(uint): Unique ship identification number (MMSI)
  • Spare(uint): Reseverd for definition by a compentent regional or local authority. Should be set to zero. (field automatically set to "0")
  • SOG(udecimal): Speed over ground
  • PositionAccuracy(uint): Accuracy of positioning fixes
  • longitude(decimal): Location of the vessel East West location
  • latitude(decimal): Location of the vessel North South location
  • COG(udecimal): Course over ground
  • TrueHeading(uint): True heading (relative to true North)
  • TimeStamp(uint): UTC second when the report was generated
  • Spare2(uint): Not used. Should be set to zero. Researched for future use. (field automatically set to "0")
  • name(aisstr6): Vessel name
  • shipandcargo(uint): what
  • dimA(uint): Distance from bow to reference position
  • dimB(uint): Distance from reference position to stern
  • dimC(uint): Distance from port side to reference position
  • dimD(uint): Distance from reference position to starboard side
  • fixtype(uint): Method used for positioning
  • RAIM(bool): Receiver autonomous integrity monitoring flag
  • DTE(uint): Data terminal ready
  • Spare3(uint): Not used. Should be set to zero (field automatically set to "0")
Parameters:
  • params - Dictionary of field names/values. Throws a ValueError exception if required is missing
  • validate - Set to true to cause checking to occur. Runs slower. FIX: not implemented.
Returns: BitVector
encoded binary message (for binary messages, this needs to be wrapped in a msg 8

Note: The returned bits may not be 6 bit aligned. It is up to you to pad out the bits.

decode(bv, validate=False)

source code 

Unpack a b_pos_and_shipdata_broken message

Fields in params:
  • MessageID(uint): AIS message number. Must be 19 (field automatically set to "19")
  • RepeatIndicator(uint): Indicated how many times a message has been repeated
  • UserID(uint): Unique ship identification number (MMSI)
  • Spare(uint): Reseverd for definition by a compentent regional or local authority. Should be set to zero. (field automatically set to "0")
  • SOG(udecimal): Speed over ground
  • PositionAccuracy(uint): Accuracy of positioning fixes
  • longitude(decimal): Location of the vessel East West location
  • latitude(decimal): Location of the vessel North South location
  • COG(udecimal): Course over ground
  • TrueHeading(uint): True heading (relative to true North)
  • TimeStamp(uint): UTC second when the report was generated
  • Spare2(uint): Not used. Should be set to zero. Researched for future use. (field automatically set to "0")
  • name(aisstr6): Vessel name
  • shipandcargo(uint): what
  • dimA(uint): Distance from bow to reference position
  • dimB(uint): Distance from reference position to stern
  • dimC(uint): Distance from port side to reference position
  • dimD(uint): Distance from reference position to starboard side
  • fixtype(uint): Method used for positioning
  • RAIM(bool): Receiver autonomous integrity monitoring flag
  • DTE(uint): Data terminal ready
  • Spare3(uint): Not used. Should be set to zero (field automatically set to "0")
Parameters:
  • bv (BitVector) - Bits defining a message
  • validate - Set to true to cause checking to occur. Runs slower. FIX: not implemented.
Returns: dict
params

printFields(params, out=sys.stdout, format='std', fieldList=None, dbType='postgres')

source code 

Print a b_pos_and_shipdata_broken message to stdout.

Fields in params:
  • MessageID(uint): AIS message number. Must be 19 (field automatically set to "19")
  • RepeatIndicator(uint): Indicated how many times a message has been repeated
  • UserID(uint): Unique ship identification number (MMSI)
  • Spare(uint): Reseverd for definition by a compentent regional or local authority. Should be set to zero. (field automatically set to "0")
  • SOG(udecimal): Speed over ground
  • PositionAccuracy(uint): Accuracy of positioning fixes
  • longitude(decimal): Location of the vessel East West location
  • latitude(decimal): Location of the vessel North South location
  • COG(udecimal): Course over ground
  • TrueHeading(uint): True heading (relative to true North)
  • TimeStamp(uint): UTC second when the report was generated
  • Spare2(uint): Not used. Should be set to zero. Researched for future use. (field automatically set to "0")
  • name(aisstr6): Vessel name
  • shipandcargo(uint): what
  • dimA(uint): Distance from bow to reference position
  • dimB(uint): Distance from reference position to stern
  • dimC(uint): Distance from port side to reference position
  • dimD(uint): Distance from reference position to starboard side
  • fixtype(uint): Method used for positioning
  • RAIM(bool): Receiver autonomous integrity monitoring flag
  • DTE(uint): Data terminal ready
  • Spare3(uint): Not used. Should be set to zero (field automatically set to "0")
Parameters:
  • params - Dictionary of field names/values.
  • out - File like object to write to
Returns: stdout
text to out

sqlCreateStr(outfile=sys.stdout, fields=None, extraFields=None, addCoastGuardFields=True, dbType='postgres')

source code 
Return the SQL CREATE command for this message type
Parameters:
  • outfile - file like object to print to.
  • fields - which fields to put in the create. Defaults to all.
  • extraFields - A sequence of tuples containing (name,sql type) for additional fields
  • addCoastGuardFields (bool) - Add the extra fields that come after the NMEA check some from the USCG N-AIS format
  • dbType - Which flavor of database we are using so that the create is tailored ('sqlite' or 'postgres')
Returns: str
sql create string

See Also: sqlCreate

sqlCreate(fields=None, extraFields=None, addCoastGuardFields=True, dbType='postgres')

source code 
Return the sqlhelp object to create the table.
Parameters:
  • fields - which fields to put in the create. Defaults to all.
  • extraFields - A sequence of tuples containing (name,sql type) for additional fields
  • addCoastGuardFields (bool) - Add the extra fields that come after the NMEA check some from the USCG N-AIS format
  • dbType - Which flavor of database we are using so that the create is tailored ('sqlite' or 'postgres')
Returns: sqlhelp.create
An object that can be used to generate a return

sqlInsertStr(params, outfile=sys.stdout, extraParams=None, dbType='postgres')

source code 
Return the SQL INSERT command for this message type
Parameters:
  • params - dictionary of values keyed by field name
  • outfile - file like object to print to.
  • extraParams - A sequence of tuples containing (name,sql type) for additional fields
Returns: str
sql create string

See Also: sqlCreate

sqlInsert(params, extraParams=None, dbType='postgres')

source code 
Give the SQL INSERT statement
Parameters:
  • params - dict keyed by field name of values
  • extraParams - any extra fields that you have created beyond the normal ais message fields
Returns: sqlhelp.insert
insert class instance

To Do: allow optional type checking of params?

Warning: this will take invalid keys happily and do what???

latexDefinitionTable(outfile=sys.stdout)

source code 
Return the LaTeX definition table for this message type
Parameters:
  • outfile (file obj) - file like object to print to.
Returns: str
LaTeX table string via the outfile

textDefinitionTable(outfile=sys.stdout, delim='\t')

source code 
Return the text definition table for this message type
Parameters:
  • outfile (file obj) - file like object to print to.
Returns: str
text table string via the outfile

testParams()

source code 
Return a params file base on the testvalue tags.
Returns: dict
params based on testvalue tags

Variables Details [hide private]

fieldList

Value:
('MessageID',
 'RepeatIndicator',
 'UserID',
 'Spare',
 'SOG',
 'PositionAccuracy',
 'longitude',
 'latitude',
...

fieldListPostgres

Value:
('MessageID',
 'RepeatIndicator',
 'UserID',
 'Spare',
 'SOG',
 'PositionAccuracy',
 'Position',
 'COG',
...

RepeatIndicatorEncodeLut

Value:
{'default': '0', 'do not repeat any more': '3'}

RepeatIndicatorDecodeLut

Value:
{'0': 'default', '3': 'do not repeat any more'}

PositionAccuracyEncodeLut

Value:
{'high (less than 10 m)': '1', 'low (greater than 10 m)': '0'}

PositionAccuracyDecodeLut

Value:
{'0': 'low (greater than 10 m)', '1': 'high (less than 10 m)'}

TimeStampEncodeLut

Value:
{'dead reckoning': '62',
 'inoperative': '63',
 'manual input': '61',
 'not available/default': '60'}

TimeStampDecodeLut

Value:
{'60': 'not available/default',
 '61': 'manual input',
 '62': 'dead reckoning',
 '63': 'inoperative'}

shipandcargoEncodeLut

Value:
{'High speed craft (HSC), Hazardous catagory A': '41',
 'High speed craft (HSC), Hazardous catagory B': '42',
 'High speed craft (HSC), Hazardous catagory C': '43',
 'High speed craft (HSC), Hazardous catagory D': '44',
 'High speed craft (HSC), No additional information': '49',
 'High speed craft (HSC), Reserved for future use': '48',
 'High speed craft (HSC), all ships of this type': '40',
 'Wing in ground (WIG), Hazardous catagory A': '21',
...

shipandcargoDecodeLut

Value:
{'20': 'Wing in ground (WIG), all ships of this type',
 '21': 'Wing in ground (WIG), Hazardous catagory A',
 '22': 'Wing in ground (WIG), Hazardous catagory B',
 '23': 'Wing in ground (WIG), Hazardous catagory C',
 '24': 'Wing in ground (WIG), Hazardous catagory D',
 '25': 'Wing in ground (WIG), Reserved for future use',
 '26': 'Wing in ground (WIG), Reserved for future use',
 '27': 'Wing in ground (WIG), Reserved for future use',
...

fixtypeEncodeLut

Value:
{'Chayka': '5',
 'GLONASS': '2',
 'GPS': '1',
 'Loran-C': '4',
 'combined GPS/GLONASS': '3',
 'integrated navigation system': '6',
 'surveyed': '7',
 'undefined': '0'}

fixtypeDecodeLut

Value:
{'0': 'undefined',
 '1': 'GPS',
 '2': 'GLONASS',
 '3': 'combined GPS/GLONASS',
 '4': 'Loran-C',
 '5': 'Chayka',
 '6': 'integrated navigation system',
 '7': 'surveyed'}

   Trees       Indices       Help   
Generated by Epydoc 3.0beta1 on Fri Jan 11 11:03:02 2008 http://epydoc.sourceforge.net