Learn R Programming
micromapST (version 1.1.1)

messages: micromapST Generated Warning and Error Messages

Description

micromapST verifies as much of its operation and the data provided by the user to try and identify and document to the user problems before they cause an R warning or error exception and throw a R like cryptic message. Each message, warning and error message is documented with the general form of the message and a friendly explanation and advice on what may be wrong and how to fix the issue identified.

The micromapST messages all start with "***" to help quickly find them in the warnings() logs and general output.

The general format of the messages is: 

    ***XXXX NNNNNN text of message
  
      or
    
    ***XXXX NNNNNN CC text of message
 
   
  where the XXXX is the message alphanumeric identifier, NNNNNN is the name of the function or glyph issuing the message
  and CC is the glyph graphic column number in the panelDesc structure.
  The four alphanumeric message identifier following the "***" is a unique message identifer
  to help find the explanation in this document and to help discuss problems 
  over the email more accurately.  
  It's always best to include the log of the preparation and execution of micromapST 
  as well as the data used when requesting help.
  The first two digits/characters of the message identifier indicates which logical segment 
  of the package generated the message:
  

        
        
        
        
        
   
  The second field of the message contains the name of the section of code 
  generating the message.  If a glyph generated the message, the name of the 
  glyph (type=xxx) and the panel column number are displayed to help you focus 
  on the parameters and data that may need to be inspected.  Each message contains 
  specific information (like panelDesc named list, checked value, etc.) to help 
  identify the cause of the message and help lead the user to a fix.
  
  The remainder of the message contain a text explanation of the issue and a list of 
  parameters: glyph column number/name, data row or column, variable name, 
  and value related to the issue.

Arguments
Details

  
  Conventions:
  
  The user provides the data.frames for the statsDFrame and panelDesc structures.  In this document, there variables
  are represented by the generic terms of statsDFrame and panelDesc.  In the messages produced by the 
  package, these values are replaced with the names of the user variables provided in the micromapST call.
  
  The following values are also substituted with the real run values at time of execution:
  

        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
        
   
  
  The following is a listing of all micromapST generated messages and a description of possible causes and solutions.
  


    
    
    
    
    
 
 
  Back to the details section - Rest of the details dection 
 
     End of details section.