4898794edd81be5285ea6e544acbedeaeb31bf78 max Tue Nov 23 08:10:57 2021 -0800 Fixing pointers to README file for license in all source code files. refs #27614 diff --git src/hg/visiGene/visiGeneLoad/visiGeneLoad.c src/hg/visiGene/visiGeneLoad/visiGeneLoad.c index 3a22b93..3c18609 100644 --- src/hg/visiGene/visiGeneLoad/visiGeneLoad.c +++ src/hg/visiGene/visiGeneLoad/visiGeneLoad.c @@ -1,1325 +1,1325 @@ /* visiGeneLoad - Load data into visiGene database. */ /* Copyright (C) 2013 The Regents of the University of California - * See README in this or parent directory for licensing information. */ + * See kent/LICENSE or http://genome.ucsc.edu/license/ for licensing information. */ #include "common.h" #include "linefile.h" #include "hash.h" #include "options.h" #include "obscure.h" #include "ra.h" #include "jksql.h" #include "dystring.h" /* Variables you can override from command line. */ char *database = "visiGene"; boolean doLock = FALSE; void usage() /* Explain usage and exit. */ { errAbort( "visiGeneLoad - Load data into visiGene database\n" "usage:\n" " visiGeneLoad setInfo.ra itemInfo.tab captions.txt\n" "Please see visiGeneLoad.doc for description of the .ra, .tab and .txtfiles\n" "Options:\n" " -database=%s - Specifically set database\n" " -lock - Lock down database during update - about 10%% faster but all\n" " web queries will stall until it finishes.\n" , database ); } static struct optionSpec options[] = { {"database", OPTION_STRING,}, {"lock", OPTION_BOOLEAN,}, {NULL, 0}, }; struct hash *hashRowOffsets(char *line) /* Given a space-delimited line, create a hash keyed by the words in * line with values the position of the word (0 based) in line */ { struct hash *hash = hashNew(0); char *word; int wordIx = 0; while ((word = nextWord(&line)) != 0) { hashAdd(hash, word, intToPt(wordIx)); wordIx += 1; } return hash; } char *getVal(char *fieldName, struct hash *raHash, struct hash *rowHash, char **row, char *defaultVal) /* Return value in row if possible, else in ra, else in default. * If no value and no default return an error. */ { char *val = NULL; struct hashEl *hel = hashLookup(rowHash, fieldName); if (hel != NULL) { int rowIx = ptToInt(hel->val); val = trimSpaces(row[rowIx]); } else { val = hashFindVal(raHash, fieldName); if (val == NULL) { if (defaultVal != NULL) val = defaultVal; else errAbort("Can't find value for field %s", fieldName); } } return val; } static char *requiredItemFields[] = {"fileName", "submitId"}; static char *requiredSetFields[] = {"contributor", "submitSet"}; static char *requiredFields[] = {"imageWidth", "imageHeight", "fullDir", "thumbDir", "taxon", "age", "probeColor", }; /* static char *optionalFields[] = { "abName", "abDescription", "abSubmitId", "abTaxon", "abUrl", "bodyPart", "copyright", "embedding", "fixation", "fPrimer", "genbank", "gene", "genotype", "imagePos", "itemUrl", "minAge", "maxAge", "journal", "journalUrl", "locusLink", "paneLabel", "permeablization", "preparationNotes", "priority", "refSeq", "rPrimer", "sectionIx", "sectionSet", "sex", "sliceType", "specimenName", "specimenNotes", "strain", "publication", "pubUrl", "setUrl", "seq", "uniProt", }; */ char *hashValOrDefault(struct hash *hash, char *key, char *defaultVal) /* Lookup key in hash and return value, or return default if it doesn't exist. */ { char *val = hashFindVal(hash, key); if (val == NULL) val = defaultVal; return val; } int findExactSubmissionId(struct sqlConnection *conn, char *submitSetName, char *contributors) /* Find ID of submissionSet that matches all parameters. Return 0 if none found. */ { char query[1024]; sqlSafef(query, sizeof(query), "select id from submissionSet " "where contributors = \"%s\" " "and name = \"%s\" " , contributors, submitSetName); verbose(2, "query %s\n", query); return sqlQuickNum(conn, query); } int findOrAddIdTable(struct sqlConnection *conn, char *table, char *field, char *value, struct hash *cache) /* Get ID associated with field.value in table. */ { char query[256]; int id; if (value == NULL || value[0] == 0) return 0; else { struct hashEl *hel = hashLookup(cache, value); if (hel != NULL) { id = ptToInt(hel->val); } else { char *escValue = makeEscapedString(value, '"'); sqlSafef(query, sizeof(query), "select id from %s where %s = \"%s\"", table, field, escValue); id = sqlQuickNum(conn, query); if (id == 0) { sqlSafef(query, sizeof(query), "insert into %s values(default, \"%s\")", table, escValue); verbose(2, "%s\n", query); sqlUpdate(conn, query); id = sqlLastAutoId(conn); } freeMem(escValue); hashAddInt(cache, value, id); } return id; } } int findOrAddSubmissionSource(struct sqlConnection *conn, char *name, char *acknowledgement, char *setUrl, char *itemUrl, char *abUrl) /* Return submissionSource table id. If necessary creating row in * submissionSource table. */ { char query[256]; sqlSafef(query, sizeof(query), "select id from submissionSource where name = \"%s\"", name); int id = sqlQuickNum(conn, query); if (id == 0) { struct dyString *dy = dyStringNew(0); sqlDyStringPrintf(dy, "insert into submissionSource values(default, "); dyStringPrintf(dy, "\"%s\", ", name); dyStringPrintf(dy, "\"%s\", ", acknowledgement); dyStringPrintf(dy, "\"%s\", ", setUrl); dyStringPrintf(dy, "\"%s\",", itemUrl); dyStringPrintf(dy, "\"%s\")", abUrl); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); dyStringFree(&dy); id = sqlLastAutoId(conn); } return id; } int doJournal(struct sqlConnection *conn, char *name, char *url) /* Update journal table if need be. Return journal ID. */ { if (name[0] == 0) return 0; else { struct dyString *dy = dyStringNew(0); int id = 0; sqlDyStringPrintf(dy, "select id from journal where name = '%s'", name); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into journal set"); dyStringPrintf(dy, " id=default,\n"); dyStringPrintf(dy, " name=\"%s\",\n", name); dyStringPrintf(dy, " url=\"%s\"\n", url); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } } int createSubmissionId(struct sqlConnection *conn, char *name, char *contributors, char *publication, char *pubUrl, int submissionSource, char *journal, char *journalUrl, int copyright, int year, struct hash *contributorCache) /* Add submission and contributors to database and return submission ID */ { struct slName *slNameListFromString(char *s, char delimiter); struct slName *contribList = NULL, *contrib; int submissionSetId; int journalId = doJournal(conn, journal, journalUrl); struct dyString *dy = dyStringNew(0); char query[1024]; sqlDyStringPrintf(dy, "insert into submissionSet set"); dyStringPrintf(dy, " id = default,\n"); dyStringPrintf(dy, " name = \"%s\",\n", name); dyStringPrintf(dy, " contributors = \"%s\",\n", contributors); dyStringPrintf(dy, " year = %d,\n", year); dyStringPrintf(dy, " publication = \"%s\",\n", publication); dyStringPrintf(dy, " pubUrl = \"%s\",\n", pubUrl); dyStringPrintf(dy, " journal = %d,\n", journalId); dyStringPrintf(dy, " copyright = %d,\n", copyright); dyStringPrintf(dy, " submissionSource = %d\n", submissionSource); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); submissionSetId = sqlLastAutoId(conn); contribList = slNameListFromComma(contributors); for (contrib = contribList; contrib != NULL; contrib = contrib->next) { int contribId = findOrAddIdTable(conn, "contributor", "name", skipLeadingSpaces(contrib->name), contributorCache); sqlSafef(query, sizeof(query), "insert into submissionContributor values(%d, %d)", submissionSetId, contribId); verbose(2, "%s\n", query); sqlUpdate(conn, query); } slFreeList(&contribList); dyStringFree(&dy); return submissionSetId; } int saveSubmissionSet(struct sqlConnection *conn, struct hash *raHash, struct hash *copyrightCache, struct hash *contributorCache, int *submissionSourceId) /* Create submissionSet, submissionContributor, and contributor records. */ { char *contributor = hashMustFindVal(raHash, "contributor"); char *name = hashMustFindVal(raHash, "submitSet"); char *year = hashValOrDefault(raHash, "year", "0"); char *submissionSource = hashMustFindVal(raHash, "submissionSource"); char *publication = hashValOrDefault(raHash, "publication", ""); char *pubUrl = hashValOrDefault(raHash, "pubUrl", ""); char *setUrl = hashValOrDefault(raHash, "setUrl", ""); char *itemUrl = hashValOrDefault(raHash, "itemUrl", ""); char *abUrl = hashValOrDefault(raHash, "abUrl", ""); char *journal = hashValOrDefault(raHash, "journal", ""); char *journalUrl = hashValOrDefault(raHash, "journalUrl", ""); char *acknowledgement = hashValOrDefault(raHash, "acknowledgement", ""); char *copyright = hashFindVal(raHash, "copyright"); int copyrightId = 0; *submissionSourceId = findOrAddSubmissionSource(conn, submissionSource, acknowledgement, setUrl, itemUrl, abUrl); int submissionId = findExactSubmissionId(conn, name, contributor); if (copyright != NULL) copyrightId = findOrAddIdTable(conn, "copyright", "notice", copyright, copyrightCache); if (submissionId != 0) return submissionId; else return createSubmissionId(conn, name, contributor, publication, pubUrl, *submissionSourceId, journal, journalUrl, copyrightId, atoi(year), contributorCache); } int cachedId(struct sqlConnection *conn, char *tableName, char *fieldName, struct hash *cache, char *raFieldName, struct hash *raHash, struct hash *rowHash, char **row) /* Get value for named field, and see if it exists in table. If so * return associated id, otherwise create new table entry and return * that id. */ { char *value = getVal(raFieldName, raHash, rowHash, row, ""); if (value[0] == 0) return 0; return findOrAddIdTable(conn, tableName, fieldName, value, cache); } boolean optionallyAddOr(struct dyString *dy, char *field, char *val, boolean needOr) /* Add field = 'val', optionally preceded by or to dy. */ { if (val[0] == 0) return needOr; if (needOr) dyStringAppend(dy, " or "); dyStringPrintf(dy, "%s = '%s'", field, val); return TRUE; } int doSectionSet(struct sqlConnection *conn, struct hash *sectionSetCache, char *sectionSet) /* Update section set table if necessary. Return section set id */ { int id = 0; if (sectionSet[0] != 0 && !sameString(sectionSet, "0")) { char query[256]; id = atoi(sectionSet); sqlSafef(query, sizeof(query), "select id from sectionSet where id=%d", id); if (!sqlQuickNum(conn, query)) { sqlSafef(query, sizeof(query), "insert into sectionSet values(%d)", id); sqlUpdate(conn, query); } } return id; } int doGene(struct lineFile *lf, struct sqlConnection *conn, char *gene, char *locusLink, char *refSeq, char *uniProt, char *genbank, char *taxon) /* Update gene table if necessary, and return gene ID. */ { struct dyString *dy = dyStringNew(0); boolean needOr = FALSE; int geneId = 0; int bestScore = 0; struct sqlResult *sr; char **row; verbose(3, "doGene %s %s %s %s %s %s\n", gene, locusLink, refSeq, uniProt, genbank, taxon); /* Make sure that at least one field specifying gene is * specified. */ if (gene[0] == 0 && locusLink[0] == 0 && refSeq[0] == 0 && uniProt[0] == 0 && genbank[0] == 0) errAbort("No gene, locusLink, refSeq, uniProt, or genbank " " specified line %d of %s", lf->lineIx, lf->fileName); /* Create query string that will catch relevant existing genes. */ sqlDyStringPrintf(dy, "select id,name,locusLink,refSeq,genbank,uniProt from gene "); dyStringPrintf(dy, "where taxon = %s and (", taxon); needOr = optionallyAddOr(dy, "name", gene, needOr); needOr = optionallyAddOr(dy, "locusLink", locusLink, needOr); needOr = optionallyAddOr(dy, "refSeq", refSeq, needOr); needOr = optionallyAddOr(dy, "uniProt", uniProt, needOr); needOr = optionallyAddOr(dy, "genbank", genbank, needOr); verbose(2, "gene query: %s\n", dy->string); dyStringPrintf(dy, ")"); /* Loop through query results finding ID that best matches us. * The locusLink/refSeq ID's are worth 8, the genbank 4, the * uniProt 2, and the name 1. This scheme will allow different * genes with the same name and even the same uniProt ID to * cope with alternative splicing. */ sr = sqlGetResult(conn, dy->string); while ((row = sqlNextRow(sr)) != NULL) { int id = sqlUnsigned(row[0]); int score = 0; char *nameOne = row[1]; char *locusLinkOne = row[2]; char *refSeqOne = row[3]; char *genbankOne = row[4]; char *uniProtOne = row[5]; verbose(3, "id %d, nameOne %s, locusLinkOne %s, refSeqOne %s, genbankOne %s, uniProtOne %s\n", id, nameOne, locusLinkOne, refSeqOne, genbankOne, uniProtOne); /* If disagree on locusLink, or refSeq ID, then this is not the * gene for us */ verbose(3, "test locusLink '%s' & locusLinkOne '%s'\n", locusLink, locusLinkOne); if (locusLink[0] != 0 && locusLinkOne[0] != 0 && differentString(locusLink, locusLinkOne)) continue; verbose(3, "test refSeq '%s' & refSeqOne '%s'\n", refSeq, refSeqOne); if (refSeq[0] != 0 && refSeqOne[0] != 0 && differentString(refSeq, refSeqOne)) continue; verbose(3, "past continues\n"); /* If we've agreed on locusLink or refSeq ID, then this is the * gene for us. */ if (locusLink[0] != 0 || refSeq[0] != 0) score += 8; if (genbank[0] != 0 && genbankOne[0] != 0 && sameString(genbank, genbankOne)) score += 4; if (uniProt[0] != 0 && uniProtOne[0] != 0 && sameString(uniProt, uniProtOne)) score += 2; if (gene[0] != 0 && nameOne[0] != 0 && sameString(gene, nameOne)) score += 1; verbose(3, "score %d, bestScore %d\n", score, bestScore); if (score > bestScore) { bestScore = score; geneId = id; } } sqlFreeResult(&sr); if (geneId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into gene set\n"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " name = '%s',\n", gene); sqlDyStringPrintf(dy, " locusLink = '%s',\n", locusLink); sqlDyStringPrintf(dy, " refSeq = '%s',\n", refSeq); sqlDyStringPrintf(dy, " genbank = '%s',\n", genbank); sqlDyStringPrintf(dy, " uniProt = '%s',\n", uniProt); sqlDyStringPrintf(dy, " taxon = %s\n", taxon); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); geneId = sqlLastAutoId(conn); } else { char *oldName; /* Handle updating name field - possibly creating a synonym. */ dyStringClear(dy); sqlDyStringPrintf(dy, "select name from gene where id = %d", geneId); oldName = sqlQuickString(conn, dy->string); if (gene[0] != 0) { if (oldName[0] == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "update gene set" ); sqlDyStringPrintf(dy, " name = '%s'", gene); sqlDyStringPrintf(dy, " where id = %d", geneId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } else if (differentWord(oldName, gene)) { dyStringClear(dy); sqlDyStringPrintf(dy, "select count(*) from geneSynonym where "); sqlDyStringPrintf(dy, "gene = %d and name = '%s'", geneId, gene); if (sqlQuickNum(conn, dy->string) == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into geneSynonym " "values(%d,\"%s\")", geneId, gene); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } } } /* Update other fields. */ dyStringClear(dy); sqlDyStringPrintf(dy, "update gene set\n"); if (locusLink[0] != 0) sqlDyStringPrintf(dy, " locusLink = '%s',", locusLink); if (refSeq[0] != 0) sqlDyStringPrintf(dy, " refSeq = '%s',", refSeq); if (genbank[0] != 0) sqlDyStringPrintf(dy, " genbank = '%s',", genbank); if (uniProt[0] != 0) sqlDyStringPrintf(dy, " uniProt = '%s',", uniProt); sqlDyStringPrintf(dy, " taxon = '%s'", taxon); sqlDyStringPrintf(dy, " where id = %d", geneId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); geneId = geneId; freez(&oldName); } dyStringFree(&dy); return geneId; } void doAntibodySource(struct sqlConnection *conn, int antibody, int submissionSource, char *abSubmitId) /* Update antibodySource table if necessary and return antibody ID. */ { if (antibody > 0 && abSubmitId != NULL && abSubmitId[0] != 0) { struct dyString *dy = dyStringNew(0); /* Try to hook up with existing antibody record. */ sqlDyStringPrintf(dy, "select abSubmitId from antibodySource"); sqlDyStringPrintf(dy, " where antibody=%d and submissionSource=%d", antibody, submissionSource); char *submitId = sqlQuickString(conn, dy->string); if (submitId != NULL) { if (submitId[0] != 0) { if (differentString(submitId,abSubmitId)) { dyStringClear(dy); sqlDyStringPrintf(dy, "update antibodySource set abSubmitId = '%s'", abSubmitId); sqlDyStringPrintf(dy, " where antibody = %d and submissionSource=%d", antibody, submissionSource); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } } } else { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into antibodySource set"); sqlDyStringPrintf(dy, " antibody = %d,",antibody); sqlDyStringPrintf(dy, " submissionSource = %d,", submissionSource); sqlDyStringPrintf(dy, " abSubmitId = '%s'", abSubmitId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } freez(&submitId); dyStringFree(&dy); } } int doAntibody(struct sqlConnection *conn, char *abName, char *abDescription, char *abTaxon) /* Update antibody table if necessary and return antibody ID. */ { int antibodyId = 0; if (abName[0] != 0) { int bestScore = 0; struct sqlResult *sr; char **row; struct dyString *dy = dyStringNew(0); /* Try to hook up with existing antibody record. */ sqlDyStringPrintf(dy, "select id,name,description,taxon from antibody"); sqlDyStringPrintf(dy, " where name = '%s'", abName); sr = sqlGetResult(conn, dy->string); while ((row = sqlNextRow(sr)) != NULL) { int id = sqlUnsigned(row[0]); /* char *name = row[1]; */ char *description = row[2]; char *taxon = row[3]; int score = 1; if (abTaxon[0] != '0' && taxon[0] != '0') { if (differentString(taxon, abTaxon)) continue; else score += 2; } if (description[0] != 0 && abDescription[0] != 0) { if (differentString(description, abDescription)) continue; else score += 4; } if (score > bestScore) { bestScore = score; antibodyId = id; } } sqlFreeResult(&sr); if (antibodyId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into antibody set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " name = '%s',\n", abName); sqlDyStringPrintf(dy, " description = '%s',\n", abDescription); if (abTaxon[0] == 0) abTaxon = "0"; sqlDyStringPrintf(dy, " taxon = '%s'", abTaxon); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); antibodyId = sqlLastAutoId(conn); } else { if (abDescription[0] != 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "update antibody set description = '%s'", abDescription); sqlDyStringPrintf(dy, " where id = %d", antibodyId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } if (abTaxon[0] != 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "update antibody set taxon = '%s'", abTaxon); sqlDyStringPrintf(dy, " where id = %d", antibodyId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } } dyStringFree(&dy); } return antibodyId; } int doProbe(struct lineFile *lf, struct sqlConnection *conn, int geneId, int antibodyId, char *fPrimer, char *rPrimer, char *seq, int bacId) /* Update probe table and probeType table if need be and return probe ID. */ { int probeTypeId = 0; int probeId = 0; struct dyString *dy = dyStringNew(0); char *probeType = "RNA"; boolean gotPrimers = (rPrimer[0] != 0 && fPrimer[0] != 0); verbose(3, "doProbe %d %d %s %s %s\n", geneId, antibodyId, fPrimer, rPrimer, seq); touppers(fPrimer); touppers(rPrimer); touppers(seq); if (gotPrimers || seq[0] != 0) { if (antibodyId != 0) errAbort("Probe defined by antibody and RNA line %d of %s", lf->lineIx, lf->fileName); } else if (antibodyId) { probeType = "antibody"; } else if (bacId) { probeType = "BAC"; } /* Handle probe type */ sqlDyStringPrintf(dy, "select id from probeType where name = '%s'", probeType); probeTypeId = sqlQuickNum(conn, dy->string); if (probeTypeId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into probeType values(default, '%s')", probeType); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); probeTypeId = sqlLastAutoId(conn); } dyStringClear(dy); sqlDyStringPrintf(dy, "select id from probe "); sqlDyStringPrintf(dy, "where gene=%d and antibody=%d ", geneId, antibodyId); sqlDyStringPrintf(dy, "and probeType=%d ", probeTypeId); sqlDyStringPrintf(dy, "and fPrimer='%s' and rPrimer='%s' ", fPrimer, rPrimer); sqlDyStringPrintf(dy, "and seq='%s' ", seq); sqlDyStringPrintf(dy, "and bac=%d", bacId); verbose(2, "query: %s\n", dy->string); probeId = sqlQuickNum(conn, dy->string); if (probeId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into probe set"); sqlDyStringPrintf(dy, " id=default,\n"); sqlDyStringPrintf(dy, " gene=%d,\n", geneId); sqlDyStringPrintf(dy, " antibody=%d,\n", antibodyId); sqlDyStringPrintf(dy, " probeType=%d,\n", probeTypeId); sqlDyStringPrintf(dy, " fPrimer='%s',\n", fPrimer); sqlDyStringPrintf(dy, " rPrimer='%s',\n", rPrimer); sqlDyStringPrintf(dy, " seq='%s',\n", seq); sqlDyStringPrintf(dy, " bac=%d\n", bacId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); probeId = sqlLastAutoId(conn); } dyStringFree(&dy); return probeId; } int doCaption(struct lineFile *lf, struct sqlConnection *conn, char *captionExtId, struct hash *captionTextHash, struct hash *captionIdCache) /* If captionExtId is non-empty then return internal id for * caption. If this is first time we've seen the caption then * put the text in the caption table and assign an ID to it. */ { if (captionExtId == NULL || captionExtId[0] == 0) return 0; else if (hashLookup(captionIdCache, captionExtId)) return hashIntVal(captionIdCache, captionExtId); else { char *captionText = hashFindVal(captionTextHash, captionExtId); int id; struct dyString *query = dyStringNew(0); if (captionText == NULL) errAbort("captionId %s line %d of %s not found in caption text file", captionExtId, lf->lineIx, lf->fileName); sqlDyStringPrintf(query, "insert into caption values(default, '%s')", captionText); verbose(2, "%s\n", query->string); sqlUpdate(conn, query->string); dyStringFree(&query); id = sqlLastAutoId(conn); hashAddInt(captionIdCache, captionExtId, id); return id; } } int doImageFile(struct lineFile *lf, struct sqlConnection *conn, char *fileName, int fullDir, int thumbDir, int submissionSetId, char *submitId, char *priority, int captionId, int imageWidth, int imageHeight) /* Update image file record if necessary and return image file ID. */ { int imageFileId = 0; struct dyString *dy = newDyString(0); sqlDyStringPrintf(dy, "select id from imageFile where "); sqlDyStringPrintf(dy, "fileName='%s' and fullLocation=%d", fileName, fullDir); imageFileId = sqlQuickNum(conn, dy->string); if (imageFileId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into imageFile set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " fileName = '%s',\n", fileName); sqlDyStringPrintf(dy, " priority = '%s',\n", priority); sqlDyStringPrintf(dy, " fullLocation = %d,\n", fullDir); sqlDyStringPrintf(dy, " thumbLocation = %d,\n", thumbDir); sqlDyStringPrintf(dy, " submissionSet = %d,\n", submissionSetId); sqlDyStringPrintf(dy, " submitId = '%s',\n", submitId); sqlDyStringPrintf(dy, " caption = %d,\n", captionId); sqlDyStringPrintf(dy, " imageWidth = %d,\n", imageWidth); sqlDyStringPrintf(dy, " imageHeight = %d\n", imageHeight); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); imageFileId = sqlLastAutoId(conn); } dyStringFree(&dy); return imageFileId; } int doStrain(struct lineFile *lf, struct sqlConnection *conn, char *taxon, char *strain) /* Return strain id, creating a new table entry if necessary. */ { int id = 0; struct dyString *dy = newDyString(0); sqlDyStringPrintf(dy, "select id from strain where "); sqlDyStringPrintf(dy, "taxon=%s and name='%s'", taxon, strain); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into strain set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " taxon = '%s',\n", taxon); sqlDyStringPrintf(dy, " name = '%s'", strain); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } int doGenotype(struct lineFile *lf, struct sqlConnection *conn, char *taxon, int strainId, char *genotype) /* Unpack genotype string, alphabatize it, return id associated * with it if possible, otherwise create associated genes and * alleles then genotype, and return genotypeId. */ { int id = 0; struct dyString *dy = newDyString(0); struct slName *geneAlleleList = commaSepToSlNames(genotype), *el; struct dyString *alphabetical = newDyString(0); slSort(&geneAlleleList, slNameCmp); for (el = geneAlleleList; el != NULL; el = el->next) dyStringPrintf(alphabetical, "%s,", el->name); sqlDyStringPrintf(dy, "select id from genotype where "); sqlDyStringPrintf(dy, "taxon='%s' and strain=%d and alleles='%s'", taxon, strainId, alphabetical->string); id = sqlQuickNum(conn, dy->string); if (id == 0) { /* Create main genotype record. */ dyStringClear(dy); sqlDyStringPrintf(dy, "insert into genotype set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " taxon = '%s',\n", taxon); sqlDyStringPrintf(dy, " strain = %d,\n", strainId); sqlDyStringPrintf(dy, " alleles = '%s'", alphabetical->string); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); /* Create additional records for each component of genotype. */ if (!sameString(genotype, "wild type")) { for (el = geneAlleleList; el != NULL; el = el->next) { int geneId = 0, alleleId = 0; char *gene, *allele; /* Parse gene:allele */ gene = el->name; allele = strchr(gene, ':'); if (allele == NULL) errAbort("Malformed genotype %s (missing :)", genotype); *allele++ = 0; /* Get or make gene ID. */ dyStringClear(dy); sqlDyStringPrintf(dy, "select id from gene where "); sqlDyStringPrintf(dy, "name = '%s' and taxon='%s'", gene, taxon); geneId = sqlQuickNum(conn, dy->string); if (geneId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into gene set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " name = '%s',\n", gene); sqlDyStringPrintf(dy, " locusLink = '',\n"); sqlDyStringPrintf(dy, " refSeq = '',\n"); sqlDyStringPrintf(dy, " genbank = '',\n"); sqlDyStringPrintf(dy, " uniProt = '',\n"); sqlDyStringPrintf(dy, " taxon = '%s'", taxon); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); geneId = sqlLastAutoId(conn); } /* Get or make allele ID. */ dyStringClear(dy); sqlDyStringPrintf(dy, "select id from allele where "); sqlDyStringPrintf(dy, "gene = %d and name = '%s'", geneId, allele); alleleId = sqlQuickNum(conn, dy->string); if (alleleId == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into allele set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " gene = %d,\n", geneId); sqlDyStringPrintf(dy, " name = '%s'", allele); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); alleleId = sqlLastAutoId(conn); } /* Add genotypeAllele record. */ dyStringClear(dy); sqlDyStringPrintf(dy, "insert into genotypeAllele set "); sqlDyStringPrintf(dy, "genotype = %d, allele=%d\n", id, alleleId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } } } slFreeList(&geneAlleleList); dyStringFree(&alphabetical); dyStringFree(&dy); return id; } static void veryClose(struct dyString *query, char *field, char *val) /* Append clause to query to select field to be within a very * small number to val (which is an ascii floating point value) */ { double x = atof(val); double e = 0.000001; sqlDyStringPrintf(query, "%s > %f and %s < %f and ", field, x-e, field, x+e); } int doSpecimen(struct lineFile *lf, struct sqlConnection *conn, char *name, char *taxon, int genotype, int bodyPart, int sex, char *age, char *minAge, char *maxAge, char *notes) /* Add specimen to table if it doesn't already exist. */ { int id = 0; struct dyString *dy = newDyString(0); if (minAge[0] == 0) minAge = age; if (maxAge[0] == 0) maxAge = age; sqlDyStringPrintf(dy, "select id from specimen where "); sqlDyStringPrintf(dy, "name = '%s' and ", name); sqlDyStringPrintf(dy, "taxon = '%s' and ", taxon); sqlDyStringPrintf(dy, "genotype = %d and ", genotype); sqlDyStringPrintf(dy, "bodyPart = %d and ", bodyPart); sqlDyStringPrintf(dy, "sex = %d and ", sex); veryClose(dy, "age", age); veryClose(dy, "minAge", minAge); veryClose(dy, "maxAge", maxAge); sqlDyStringPrintf(dy, "notes = '%s'", notes); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into specimen set "); sqlDyStringPrintf(dy, "id = default,\n"); sqlDyStringPrintf(dy, "name = '%s',\n", name); sqlDyStringPrintf(dy, "taxon = '%s',\n", taxon); sqlDyStringPrintf(dy, "genotype = %d,\n", genotype); sqlDyStringPrintf(dy, "bodyPart = %d,\n", bodyPart); sqlDyStringPrintf(dy, "sex = %d,\n", sex); sqlDyStringPrintf(dy, "age = '%s',\n", age); sqlDyStringPrintf(dy, "minAge = '%s',\n", minAge); sqlDyStringPrintf(dy, "maxAge = '%s',\n", maxAge); sqlDyStringPrintf(dy, "notes = '%s'", notes); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } int doPreparation(struct lineFile *lf, struct sqlConnection *conn, int fixation, int embedding, int permeablization, int sliceType, char *notes) /* Add preparation to table if it doesn't already exist. */ { int id = 0; struct dyString *dy = newDyString(0); sqlDyStringPrintf(dy, "select id from preparation where "); sqlDyStringPrintf(dy, "fixation = %d and ", fixation); sqlDyStringPrintf(dy, "embedding = %d and ", embedding); sqlDyStringPrintf(dy, "permeablization = %d and ", permeablization); sqlDyStringPrintf(dy, "sliceType = %d and ", sliceType); sqlDyStringPrintf(dy, "notes = '%s'", notes); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into preparation set"); sqlDyStringPrintf(dy, " id = default,\n"); sqlDyStringPrintf(dy, " fixation = %d,\n", fixation); sqlDyStringPrintf(dy, " embedding = %d,\n", embedding); sqlDyStringPrintf(dy, " permeablization = %d,\n", permeablization); sqlDyStringPrintf(dy, " sliceType = %d,\n", sliceType); sqlDyStringPrintf(dy, " notes = '%s'", notes); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } int doImage(struct lineFile *lf, struct sqlConnection *conn, int submissionSet, int imageFile, int imagePos, char *paneLabel, int sectionSet, int sectionIx, int specimen, int preparation) /* Update image table. */ { int id = 0; struct dyString *dy = newDyString(0); sqlDyStringPrintf(dy, "select id from image where "); sqlDyStringPrintf(dy, "submissionSet = %d and ", submissionSet); sqlDyStringPrintf(dy, "imageFile = %d and ", imageFile); sqlDyStringPrintf(dy, "imagePos = %d and ", imagePos); sqlDyStringPrintf(dy, "paneLabel = '%s' and ", paneLabel); sqlDyStringPrintf(dy, "sectionSet = %d and ", sectionSet); sqlDyStringPrintf(dy, "sectionIx = %d and ", sectionIx); sqlDyStringPrintf(dy, "specimen = %d and ", specimen); sqlDyStringPrintf(dy, "preparation = %d", preparation); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into image set "); sqlDyStringPrintf(dy, "id=default,"); sqlDyStringPrintf(dy, "submissionSet = %d,", submissionSet); sqlDyStringPrintf(dy, "imageFile = %d,", imageFile); sqlDyStringPrintf(dy, "imagePos = %d,", imagePos); sqlDyStringPrintf(dy, "paneLabel = '%s',", paneLabel); sqlDyStringPrintf(dy, "sectionSet = %d,", sectionSet); sqlDyStringPrintf(dy, "sectionIx = %d,", sectionIx); sqlDyStringPrintf(dy, "specimen = %d,", specimen); sqlDyStringPrintf(dy, "preparation = %d", preparation); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } int doImageProbe(struct sqlConnection *conn, int image, int probe, int probeColor) /* Update image probe table if need be */ { struct dyString *dy = dyStringNew(0); int id = 0; sqlDyStringPrintf(dy, "select id from imageProbe where "); sqlDyStringPrintf(dy, "image=%d and probe=%d and probeColor=%d", image, probe, probeColor); id = sqlQuickNum(conn, dy->string); if (id == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into imageProbe set"); sqlDyStringPrintf(dy, " id=default,"); sqlDyStringPrintf(dy, " image=%d,", image); sqlDyStringPrintf(dy, " probe=%d,", probe); sqlDyStringPrintf(dy, " probeColor=%d\n", probeColor); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); id = sqlLastAutoId(conn); } dyStringFree(&dy); return id; } void doExpression(struct lineFile *lf, struct sqlConnection *conn, int imageProbe, char *bodyPart, struct hash *bodyPartCache, char *level, char *cellType, struct hash *cellTypeCache, char *cellSubtype, struct hash *cellSubtypeCache, char *expressionPattern, struct hash *expressionPatternCache) /* Add item to expression table, possibly body part table too. */ { struct dyString *dy = dyStringNew(0); int bodyPartId = findOrAddIdTable(conn, "bodyPart", "name", bodyPart, bodyPartCache); int cellTypeId = findOrAddIdTable(conn, "cellType", "name", cellType, cellTypeCache); int cellSubtypeId = findOrAddIdTable(conn, "cellSubtype", "name", cellSubtype, cellSubtypeCache); int expressionPatternId = findOrAddIdTable(conn, "expressionPattern", "description", expressionPattern, expressionPatternCache); double lev = atof(level); if (lev < 0 || lev > 1.0) errAbort("expression level %s out of range (0 to 1) line %d of %s", level, lf->lineIx, lf->fileName); sqlDyStringPrintf(dy, "select count(*) from expressionLevel where "); sqlDyStringPrintf(dy, "imageProbe=%d and bodyPart=%d", imageProbe, bodyPartId); if (sqlQuickNum(conn, dy->string) == 0) { dyStringClear(dy); sqlDyStringPrintf(dy, "insert into expressionLevel set"); sqlDyStringPrintf(dy, " imageProbe=%d,", imageProbe); sqlDyStringPrintf(dy, " bodyPart=%d,", bodyPartId); sqlDyStringPrintf(dy, " level=%f,", lev); sqlDyStringPrintf(dy, " cellType=%d,", cellTypeId); sqlDyStringPrintf(dy, " cellSubtype=%d,", cellSubtypeId); sqlDyStringPrintf(dy, " expressionPattern=%d", expressionPatternId); verbose(2, "%s\n", dy->string); sqlUpdate(conn, dy->string); } dyStringFree(&dy); } struct hash *readCaptions(char *fileName) /* Read in caption file which is composed of lines of * format <id><tab><caption><newline> * into a hash with id's for keys, captions for values. */ { struct lineFile *lf = lineFileOpen(fileName, TRUE); struct hash *hash = hashNew(16); char *line; while (lineFileNextReal(lf, &line)) { char *key = nextWord(&line); hashAdd(hash, key, makeEscapedString(line, '"')); } lineFileClose(&lf); return hash; } void visiGeneLoad(char *setRaFile, char *itemTabFile, char *captionFile) /* visiGeneLoad - Load data into visiGene database. */ { struct hash *raHash = raReadSingle(setRaFile); struct hash *rowHash; struct lineFile *lf = lineFileOpen(itemTabFile, TRUE); char *line, *words[256]; struct sqlConnection *conn = sqlConnect(database); int rowSize; int submissionSetId; int submissionSourceId = 0; struct hash *captionTextHash = readCaptions(captionFile); int imageProbeId = 0; /* Local caches of values from some simple id/value tables. */ struct hash *fullDirCache = newHash(0); struct hash *thumbDirCache = newHash(0); struct hash *bodyPartCache = newHash(0); struct hash *cellTypeCache = newHash(0); struct hash *cellSubtypeCache = newHash(0); struct hash *expressionPatternCache = newHash(0); struct hash *sexCache = newHash(0); struct hash *copyrightCache = newHash(0); struct hash *contributorCache = newHash(0); struct hash *embeddingCache = newHash(0); struct hash *fixationCache = newHash(0); struct hash *permeablizationCache = newHash(0); struct hash *probeColorCache = newHash(0); struct hash *bacCache = newHash(0); struct hash *sliceTypeCache = newHash(0); struct hash *sectionSetCache = newHash(0); struct hash *captionIdHash = newHash(0); /* Read first line of tab file, and from it get all the field names. */ if (!lineFileNext(lf, &line, NULL)) errAbort("%s appears to be empty", lf->fileName); if (line[0] != '#') errAbort("First line of %s needs to start with #, and then contain field names", lf->fileName); rowHash = hashRowOffsets(line+1); rowSize = rowHash->elCount; if (rowSize >= ArraySize(words)) errAbort("Too many fields in %s", lf->fileName); /* Check that have all required fields */ { char *fieldName; int i; for (i=0; i<ArraySize(requiredSetFields); ++i) { fieldName = requiredSetFields[i]; if (!hashLookup(raHash, fieldName)) errAbort("Field %s is not in %s", fieldName, setRaFile); } for (i=0; i<ArraySize(requiredItemFields); ++i) { fieldName = requiredItemFields[i]; if (!hashLookup(rowHash, fieldName)) errAbort("Field %s is not in %s", fieldName, itemTabFile); } for (i=0; i<ArraySize(requiredFields); ++i) { fieldName = requiredFields[i]; if (!hashLookup(rowHash, fieldName) && !hashLookup(raHash, fieldName)) errAbort("Field %s is not in %s or %s", fieldName, setRaFile, itemTabFile); } } /* Lock down the database for faster update speed. */ if (doLock) sqlHardLockAll(conn, TRUE); /* Create/find submission record. */ submissionSetId = saveSubmissionSet(conn, raHash, copyrightCache, contributorCache, &submissionSourceId); if (submissionSourceId<1) errAbort("submissionSourceId unexpected value: %d",submissionSourceId); /* Process rest of tab file. */ while (lineFileNextReal(lf, &line)) { int wordCount; if (isspace(line[0])) /* Add to info on previous line. */ { char *command; if (imageProbeId == 0) errAbort("Can't begin %s with an indented line", lf->fileName); line = skipLeadingSpaces(line); wordCount = chopTabs(line, words); command = words[0]; if (sameString(command, "expression")) { char *bodyPart, *level; char *cellType = "", *cellSubtype = "", *expressionPattern=""; if (wordCount < 3) lineFileExpectWords(lf, 3, wordCount); bodyPart = words[1]; level = words[2]; if (wordCount >= 4) cellType = words[3]; if (wordCount >= 5) cellSubtype = words[4]; if (wordCount >= 6) expressionPattern = words[5]; if (wordCount >= 7) lineFileExpectWords(lf, 6, wordCount); doExpression(lf, conn, imageProbeId, bodyPart, bodyPartCache, level, cellType, cellTypeCache, cellSubtype, cellSubtypeCache, expressionPattern, expressionPatternCache); } else { errAbort("Unknown command %s line %d of %s", command, lf->lineIx, lf->fileName); } } else /* Fresh imageProbe. */ { wordCount = chopTabs(line, words); lineFileExpectWords(lf, rowSize, wordCount); /* Find/add fields that are in simple id/name type tables. */ int fullDir = cachedId(conn, "fileLocation", "name", fullDirCache, "fullDir", raHash, rowHash, words); int thumbDir = cachedId(conn, "fileLocation", "name", thumbDirCache, "thumbDir", raHash, rowHash, words); int bodyPart = cachedId(conn, "bodyPart", "name", bodyPartCache, "bodyPart", raHash, rowHash, words); int embedding = cachedId(conn, "embedding", "description", embeddingCache, "embedding", raHash, rowHash, words); int fixation = cachedId(conn, "fixation", "description", fixationCache, "fixation", raHash, rowHash, words); int permeablization = cachedId(conn, "permeablization", "description", permeablizationCache, "permeablization", raHash, rowHash, words); int probeColor = cachedId(conn, "probeColor", "name", probeColorCache, "probeColor", raHash, rowHash, words); int sex = cachedId(conn, "sex", "name", sexCache, "sex", raHash, rowHash, words); int sliceType = cachedId(conn, "sliceType", "name", sliceTypeCache, "sliceType", raHash, rowHash, words); int bac = cachedId(conn, "bac", "name", bacCache, "bac", raHash, rowHash, words); /* Get required fields in tab file */ char *fileName = getVal("fileName", raHash, rowHash, words, NULL); char *submitId = getVal("submitId", raHash, rowHash, words, NULL); char *imageWidth = getVal("imageWidth", raHash, rowHash, words, NULL); char *imageHeight = getVal("imageHeight", raHash, rowHash, words, NULL); /* Get required fields that can live in tab or .ra file. */ char *taxon = getVal("taxon", raHash, rowHash, words, NULL); char *age = getVal("age", raHash, rowHash, words, NULL); /* Get other fields from input (either tab or ra file) */ char *abName = getVal("abName", raHash, rowHash, words, ""); char *abDescription = getVal("abDescription", raHash, rowHash, words, ""); char *abTaxon = getVal("abTaxon", raHash, rowHash, words, "0"); char *abSubmitId = getVal("abSubmitId", raHash, rowHash, words, ""); char *fPrimer = getVal("fPrimer", raHash, rowHash, words, ""); char *genbank = getVal("genbank", raHash, rowHash, words, ""); char *gene = getVal("gene", raHash, rowHash, words, ""); char *genotype = getVal("genotype", raHash, rowHash, words, "wild type"); char *imagePos = getVal("imagePos", raHash, rowHash, words, "0"); /* char *journal = getVal("journal", raHash, rowHash, words, ""); */ /* char *journalUrl = getVal("journalUrl", raHash, rowHash, words, ""); */ char *locusLink = getVal("locusLink", raHash, rowHash, words, ""); char *minAge = getVal("minAge", raHash, rowHash, words, ""); char *maxAge = getVal("maxAge", raHash, rowHash, words, ""); char *paneLabel = getVal("paneLabel", raHash, rowHash, words, ""); char *preparationNotes = getVal("preparationNotes", raHash, rowHash, words, ""); char *priority = getVal("priority", raHash, rowHash, words, "200"); char *refSeq = getVal("refSeq", raHash, rowHash, words, ""); char *rPrimer = getVal("rPrimer", raHash, rowHash, words, ""); char *sectionSet = getVal("sectionSet", raHash, rowHash, words, ""); char *sectionIx = getVal("sectionIx", raHash, rowHash, words, "0"); char *seq = getVal("seq", raHash, rowHash, words, ""); char *specimenName = getVal("specimenName", raHash, rowHash, words, ""); char *specimenNotes = getVal("specimenNotes", raHash, rowHash, words, ""); char *strain = getVal("strain", raHash, rowHash, words, ""); char *uniProt = getVal("uniProt", raHash, rowHash, words, ""); char *captionExtId = getVal("captionId", raHash, rowHash, words, ""); /* Some ID's we have to calculate individually. */ int sectionId = 0; int geneId = 0; int antibodyId = 0; int probeId = 0; int captionId = 0; int imageFileId = 0; int strainId = 0; int genotypeId = 0; int specimenId = 0; int preparationId = 0; int imageId = 0; verbose(3, "line %d of %s: gene %s, fileName %s\n", lf->lineIx, lf->fileName, gene, fileName); sectionId = doSectionSet(conn, sectionSetCache, sectionSet); geneId = doGene(lf, conn, gene, locusLink, refSeq, uniProt, genbank, taxon); antibodyId = doAntibody(conn, abName, abDescription, abTaxon); doAntibodySource(conn, antibodyId, submissionSourceId, abSubmitId); probeId = doProbe(lf, conn, geneId, antibodyId, fPrimer, rPrimer, seq, bac); captionId = doCaption(lf, conn, captionExtId, captionTextHash, captionIdHash); imageFileId = doImageFile(lf, conn, fileName, fullDir, thumbDir, submissionSetId, submitId, priority, captionId, atoi(imageWidth), atoi(imageHeight)); strainId = doStrain(lf, conn, taxon, strain); genotypeId = doGenotype(lf, conn, taxon, strainId, genotype); specimenId = doSpecimen(lf, conn, specimenName, taxon, genotypeId, bodyPart, sex, age, minAge, maxAge, specimenNotes); preparationId = doPreparation(lf, conn, fixation, embedding, permeablization, sliceType, preparationNotes); imageId = doImage(lf, conn, submissionSetId, imageFileId, atoi(imagePos), paneLabel, sectionId, atoi(sectionIx), specimenId, preparationId); imageProbeId = doImageProbe(conn, imageId, probeId, probeColor); } } if (doLock) sqlHardUnlockAll(conn); } int main(int argc, char *argv[]) /* Process command line. */ { optionInit(&argc, argv, options); if (argc != 4) usage(); database = optionVal("database", database); doLock = optionExists("lock"); visiGeneLoad(argv[1], argv[2], argv[3]); return 0; }