docs: def mysql(
              self,
              tableNamePrefix="TNS",
              dirPath=None):
          """*Render the results as MySQL Insert statements*
  
          **Key Arguments:**
              - ``tableNamePrefix`` -- the prefix for the database table names to assign the insert statements to. Default *TNS*.
              - ``dirPath`` -- the path to the directory to save the rendered results to. Default *None*
  
          **Return:**
              - `mysqlSources` -- the top-level transient data
              - `mysqlPhot` -- all photometry associated with the transients
              - `mysqlSpec` -- all spectral data associated with the transients
              - `mysqlFiles`  -- all files associated with the matched transients found on the tns
  
          **Usage:**
  
              To render the results in mysql insert format:
  
              .. code-block:: python
  
                  mysqlSources, mysqlPhot, mysqlSpec, mysqlFiles  = tns.mysql("TNS")
                  print mysqlSources
  
              .. code-block:: text
  
                  INSERT INTO `TNS_sources` (TNSId,TNSName,dateCreated,decDeg,decSex,discDate,discMag,discMagFilter,discSurvey,discoveryName,hostName,hostRedshift,objectUrl,raDeg,raSex,separationArcsec,separationEastArcsec,separationNorthArcsec,specType,transRedshift) VALUES ("2016asf" ,"SN2016asf" ,"2016-09-20T11:22:13" ,"31.1126" ,"+31:06:45.36" ,"2016-03-06 08:09:36" ,"17.1" ,"V-Johnson" ,"ASAS-SN" ,"ASASSN-16cs" ,"KUG 0647+311" ,null ,"http://wis-tns.weizmann.ac.il/object/2016asf" ,"102.653041667" ,"06:50:36.73" ,"0.66" ,"-0.13" ,"0.65" ,"SN Ia" ,"0.021")  ON DUPLICATE KEY UPDATE  TNSId="2016asf", TNSName="SN2016asf", dateCreated="2016-09-20T11:22:13", decDeg="31.1126", decSex="+31:06:45.36", discDate="2016-03-06 08:09:36", discMag="17.1", discMagFilter="V-Johnson", discSurvey="ASAS-SN", discoveryName="ASASSN-16cs", hostName="KUG 0647+311", hostRedshift=null, objectUrl="http://wis-tns.weizmann.ac.il/object/2016asf", raDeg="102.653041667", raSex="06:50:36.73", separationArcsec="0.66", separationEastArcsec="-0.13", separationNorthArcsec="0.65", specType="SN Ia", transRedshift="0.021", updated=1, dateLastModified=NOW() ;
  
              You can save the results to file by passing in a directory path within which to save the files to. The four flavours of data (sources, photometry, spectra and files) are saved to separate files but all data can be assoicated with its transient source using the transient's unique `TNSId`.
  
              .. code-block:: python
  
                  tns.mysql("TNS", "~/tns")
  
              .. image:: https://i.imgur.com/CozySPW.png
                  :width: 800px
                  :alt: mysql output
          """
          if dirPath:
              p = self._file_prefix()
  
              createStatement = """
  CREATE TABLE `%(tableNamePrefix)s_sources` (
    `primaryId` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'An internal counter',
    `TNSId` varchar(20) NOT NULL,
    `TNSName` varchar(20) DEFAULT NULL,
    `dateCreated` datetime DEFAULT NULL,
    `decDeg` double DEFAULT NULL,
    `decSex` varchar(45) DEFAULT NULL,
    `discDate` datetime DEFAULT NULL,
    `discMag` double DEFAULT NULL,
    `discMagFilter` varchar(45) DEFAULT NULL,
    `discSurvey` varchar(100) DEFAULT NULL,
    `discoveryName` varchar(100) DEFAULT NULL,
    `objectUrl` varchar(200) DEFAULT NULL,
    `raDeg` double DEFAULT NULL,
    `raSex` varchar(45) DEFAULT NULL,
    `specType` varchar(100) DEFAULT NULL,
    `transRedshift` double DEFAULT NULL,
    `updated` tinyint(4) DEFAULT '0',
    `dateLastModified` datetime DEFAULT NULL,
    `hostName` VARCHAR(100) NULL DEFAULT NULL,
    `hostRedshift` DOUBLE NULL DEFAULT NULL, 
    `survey` VARCHAR(100) NULL DEFAULT NULL,
    PRIMARY KEY (`primaryId`),
    UNIQUE KEY `tnsid` (`TNSId`)
  ) ENGINE=MyISAM AUTO_INCREMENT=0 DEFAULT CHARSET=latin1;
              """ % locals()
  
              mysqlSources = self.sourceResults.mysql(
                  tableNamePrefix + "_sources", filepath=dirPath + "/" + p + "sources.sql", createStatement=createStatement)
  
              createStatement = """
  CREATE TABLE `%(tableNamePrefix)s_photometry` (
    `primaryId` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'An internal counter',
    `TNSId` varchar(20) NOT NULL,
    `dateCreated` datetime DEFAULT CURRENT_TIMESTAMP,
    `exptime` double DEFAULT NULL,
    `filter` varchar(100) DEFAULT NULL,
    `limitingMag` tinyint(4) DEFAULT NULL,
    `mag` double DEFAULT NULL,
    `magErr` double DEFAULT NULL,
    `magUnit` varchar(100) DEFAULT NULL,
    `objectName` varchar(100) DEFAULT NULL,
    `obsdate` datetime DEFAULT NULL,
    `reportAddedDate` datetime DEFAULT NULL,
    `suggestedType` varchar(100) DEFAULT NULL,
    `survey` varchar(100) DEFAULT NULL,
    `telescope` varchar(100) DEFAULT NULL,
    `updated` tinyint(4) DEFAULT '0',
    `dateLastModified` datetime DEFAULT NULL,
    `remarks` VARCHAR(800) NULL DEFAULT NULL,
    `sourceComment` VARCHAR(800) NULL DEFAULT NULL,
    PRIMARY KEY (`primaryId`),
    UNIQUE KEY `tnsid_survey_obsdate` (`TNSId`,`survey`,`obsdate`),
    UNIQUE INDEX `u_tnsid_survey_obsdate` (`TNSId` ASC, `survey` ASC, `obsdate` ASC),
    UNIQUE INDEX `u_tnsid_obsdate_objname` (`TNSId` ASC, `obsdate` ASC, `objectName` ASC)
  ) ENGINE=MyISAM AUTO_INCREMENT=0 DEFAULT CHARSET=latin1;
              """ % locals()
  
              mysqlPhot = self.photResults.mysql(
                  tableNamePrefix + "_photometry", filepath=dirPath + "/" + p + "phot.sql", createStatement=createStatement)
  
              createStatement = """
  CREATE TABLE `%(tableNamePrefix)s_spectra` (
    `primaryId` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'An internal counter',
    `TNSId` varchar(45) NOT NULL,
    `TNSuser` varchar(45) DEFAULT NULL,
    `dateCreated` datetime DEFAULT CURRENT_TIMESTAMP,
    `exptime` double DEFAULT NULL,
    `obsdate` datetime DEFAULT NULL,
    `reportAddedDate` datetime DEFAULT NULL,
    `specType` varchar(100) DEFAULT NULL,
    `survey` varchar(100) DEFAULT NULL,
    `telescope` varchar(100) DEFAULT NULL,
    `transRedshift` double DEFAULT NULL,
    `updated` tinyint(4) DEFAULT '0',
    `dateLastModified` datetime DEFAULT NULL,
    `remarks` VARCHAR(800) NULL DEFAULT NULL,
    `sourceComment` VARCHAR(800) NULL DEFAULT NULL,
    PRIMARY KEY (`primaryId`),
    UNIQUE KEY `u_tnsid_survey_obsdate` (`TNSId`,`survey`,`obsdate`),
    UNIQUE KEY `u_id_user_obsdate` (`TNSId`,`TNSuser`,`obsdate`)
  ) ENGINE=MyISAM AUTO_INCREMENT=0 DEFAULT CHARSET=latin1;
              """ % locals()
  
              mysqlSpec = self.specResults.mysql(
                  tableNamePrefix + "_spectra", filepath=dirPath + "/" + p + "spec.sql", createStatement=createStatement)
  
              createStatement = """
  CREATE TABLE `%(tableNamePrefix)s_files` (
    `primaryId` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'An internal counter',
    `TNSId` varchar(100) NOT NULL,
    `dateCreated` datetime DEFAULT CURRENT_TIMESTAMP,
    `dateObs` datetime DEFAULT NULL,
    `filename` varchar(200) DEFAULT NULL,
    `spec1phot2` tinyint(4) DEFAULT NULL,
    `url` varchar(800) DEFAULT NULL,
    `updated` tinyint(4) DEFAULT '0',
    `dateLastModified` datetime DEFAULT NULL,
    `comment` VARCHAR(800) NULL DEFAULT NULL,
    PRIMARY KEY (`primaryId`),
    UNIQUE KEY `tnsid_url` (`TNSId`,`url`)
  ) ENGINE=MyISAM AUTO_INCREMENT=0 DEFAULT CHARSET=latin1;
              """ % locals()
  
              mysqlFiles = self.relatedFilesResults.mysql(
                  tableNamePrefix + "_files", filepath=dirPath + "/" + p + "relatedFiles.sql", createStatement=createStatement)
          else:
              mysqlSources = self.sourceResults.mysql(
                  tableNamePrefix + "_sources")
              mysqlPhot = self.photResults.mysql(tableNamePrefix + "_photometry")
              mysqlSpec = self.specResults.mysql(tableNamePrefix + "_spectra")
              mysqlFiles = self.relatedFilesResults.mysql(
                  tableNamePrefix + "_files")
          return mysqlSources, mysqlPhot, mysqlSpec, mysqlFiles