@sjcrh/proteinpaint-types 2.80.0 → 2.81.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjcrh/proteinpaint-types",
-  "version": "2.80.0",
+  "version": "2.81.5",
   "type": "module",
   "description": "Shared type definitions between ProteinPaint server and client code",
   "main": "src/index.ts",

package/src/dataset.ts

@@ -17,26 +17,40 @@ type KeyLabel = {
 
 /** a set of categories about a vcf INFO field */
 export type InfoFieldCategories = {
+	/** category key from an INFO field of a vcf file */
 	[index: string]: {
+		/** Color used for rendering labels and backgrounds in the legend, tables, etc. */
 		color: string
+		/** Human readable label */
 		label?: string
+		/** Shown in the legend on label click */
 		desc: string
+		/** When .color is used as the background, denoted whether
+		 * to use 'white', 'black', or other color for the text */
 		textcolor?: string
-		name?: string
 	}
 }
 
 type NumericFilterEntry = {
+	/** '<' or '>' for filtering */
 	side: string
+	/** value for filtering */
 	value: number
 }
 
 type AFEntry = {
+	/** human readable label */
 	name: string
-	locusinfo: { key: string }
+	/**  */
+	locusinfo: {
+		/** usually the data dictionary value  (e.g. AF_EXAC for ExAC frequency) */
+		key: string
+	}
+	/** key/values for filtering */
 	numericfilter: NumericFilterEntry[]
 }
 
+/** Specific allele freq info for ClinVar */
 export type ClinvarAF = {
 	[index: string]: AFEntry
 }
@@ -44,25 +58,37 @@ export type ClinvarAF = {
 /*** types supporting Queries type ***/
 
 type InfoFieldEntry = {
+	/** Human readable name to display */
 	name: string
+	/** vcf INFO field */
 	key: string
+	/** a set of categories about a vcf INFO field */
 	categories?: InfoFieldCategories
+	/** seperator (e.g. '&', '|' ) between join values */
 	separator?: string
 }
 
 /*
 type GenomicPositionEntry = {
-		chr: string
-		start: number
-		stop: number
+                chr: string
+                start: number
+                stop: number
 }
 */
 
-type Chr2bcffile = { [index: string]: string }
+type Chr2bcffile = {
+	/** index is the chr (e.g. 'chr1', 'chr2', etc.)
+	 * value is the bcf file path */
+	[index: string]: string
+}
+
 type bcfMafFile = {
 	/** bcf file for only variants, no samples and FORMAT */
 	bcffile: string
-	/** maf file for sample mutations. bcf header contents with FORMAT and list of samples are copied into this maf as headers followed by the maf header starting with #chr, pos, ref, alt and sample. Each column after sample corresponds to the information in FORMAT. file is bgzipped and tabix indexed (tabix -c"#" -s 1 -b 2 -e 2 <maf.gz>) */
+	/** maf file for sample mutations. bcf header contents with FORMAT and list of samples are
+	 * copied into this maf as headers followed by the maf header starting with #chr, pos, ref,
+	 * alt and sample. Each column after sample corresponds to the information in FORMAT. file
+	 * is bgzipped and tabix indexed (tabix -c"#" -s 1 -b 2 -e 2 <maf.gz>) */
 	maffile: string
 }
 
@@ -84,11 +110,8 @@ type SnvindelByRange = {
 	tempflag_sampleNameInVcfHeader?: boolean
 }
 
-type SvfusionByRange = {
-	file?: string
-}
-
 type URLEntry = {
+	/** base URL, including the host and possibly other queries */
 	base?: string
 	key?: string
 	namekey?: string
@@ -97,29 +120,33 @@ type URLEntry = {
 }
 
 type SkewerRim = {
+	/** only enabled for 'format' */
 	type: string
+	/** 'origin' */
 	formatKey: string
+	/** 'somatic' or 'germline', generally germline */
 	rim1value: string
+	/** 'somatic' or 'germline', generally somatic */
 	noRimValue: string
 }
 
 type GdcApi = {
+	/** Represents the configuration for accessing the GDC API. */
 	gdcapi?: boolean
 }
 
-type M2Csq = GdcApi & {
-	by: string
-}
-
-type SnvIndelFormatEntry = {
-	ID: string
-	Description: string
-	Number: string | number
-	Type: string
-}
-
 type SnvIndelFormat = {
-	[index: string]: SnvIndelFormatEntry
+	[index: string]: {
+		/* has value for a non-GT field indicating the variant 
+        is annotated to this sample*/
+		ID: string
+		Description: string
+		/** 'R' or 1. do not parse values here based on Number="R"
+        as we don't need to compute on the format values on backend
+        client will parse the values for display */
+		Number: string | number
+		Type: string
+	}
 }
 
 type FilterValues = {
@@ -229,13 +256,12 @@ type SnvIndelQuery = {
 	infoUrl?: URLEntry[]
 	skewerRim?: SkewerRim
 	format4filters?: string[]
-	m2csp?: M2Csq
 	format?: SnvIndelFormat
 	variant_filter?: VariantFilter
 	populations?: Population[]
 	/** NOTE **
-	this definition can appear either in queries.snvindel{} or termdb{}
-	so that it can work for a termdb-less ds, e.g. clinvar, where termdbConfig cannot be made */
+this definition can appear either in queries.snvindel{} or termdb{}
+so that it can work for a termdb-less ds, e.g. clinvar, where termdbConfig cannot be made */
 	ssmUrl?: UrlTemplateSsm
 	m2csq?: {
 		gdcapi?: boolean
@@ -247,27 +273,37 @@ type SnvIndelQuery = {
 }
 
 type SvFusion = {
-	byrange: SvfusionByRange
+	byrange: {
+		/** file paths for sv fusion data */
+		file?: string
+	}
 }
 
 type SingleSampleMutationQuery = {
 	src: 'native' | 'gdcapi' | string
-	/** which property of client mutation object to retrieve sample identifier for querying single sample data with */
+	/** which property of client mutation object to retrieve sample identifier for
+	 * querying single sample data with */
 	sample_id_key: string
 	/** only required for src=native */
 	folder?: string
-	/** quick fix to hide chrM from disco, due to reason e.g. this dataset doesn't have data on chrM */
+	/** quick fix to hide chrM from disco, due to reason e.g. this dataset doesn't
+	 * have data on chrM */
 	discoSkipChrM?: true
 }
 
 type NIdataQuery = {
+	/** Reference obj for NI data query. */
 	Ref1: NIdataQueryRef
 }
 
 type NIdataQueryRef = {
+	/** file path for the reference file */
 	referenceFile: string
+	/** file path for the sample file */
 	samples: string
+	/** Parameters for slice indices in the mass brain imaging plot */
 	parameters?: NIdataQueryRefParams
+	/** optional terms to show as table columns and annotate samples */
 	sampleColumns?: { termid: string }[]
 }
 
@@ -297,7 +333,14 @@ export type GeneArgumentEntry = {
 	/** value of the input or checkbox
 	 * required if type is string. Otherwise, optional
 	 */
-	value?: string | boolean | number | { type: string; value: string[] | null }
+	value?:
+		| string
+		| boolean
+		| number
+		| {
+				type: string
+				value: string[] | null
+		  }
 	options?: {
 		/** Type of dom element to render underneath the radio
 		 * 'text': creates a text area input
@@ -317,57 +360,81 @@ export type GeneArgumentEntry = {
 }
 
 type TopVariablyExpressedGenesQuery = {
+	/** Denotes either gdc specific data requests or common
+	 * data request processing */
 	src: 'gdcapi' | 'native' | string
+	/** Specifies the dom element rendered in the menu */
 	arguments?: GeneArgumentEntry[]
 }
 
 type TopMutatedGenes = {
+	/** Specifies the dom element rendered in the menu */
 	arguments?: GeneArgumentEntry[]
 }
 
 type TklstEntry = {
+	/** Determines the column to add the track via the assay names
+	 * shown at the top of the facet table.*/
 	assay?: string
+	/** track type (e.g. bigwig, bedj, etc.) */
 	type: string
+	/** Human readable name */
 	name: string
-	sample?: string
+	/** Corresponding sample id in the data file */
+	sampleID?: string
+	/** data file path */
 	file: string
+	/** The key for the second tier of the facet table*/
 	level1?: string
+	/** The key for the third tier of the facet table*/
+	level2?: string
+	/** Whether the track is shown by default */
 	defaultShown?: boolean
+	/** Track height */
 	stackheight?: number
+	/** Space added to the height of the track */
 	stackspace?: number
+	/** padding-top for the track */
 	toppad?: number
+	/** padding-bottom for the track */
 	bottompad?: number
-	onerow?: number // should be boolean???
+	/** Specifically for bedj tracks. if true, will render all items in a
+	 * single row and do not stack them */
+	onerow?: number | boolean
 }
 
 type TrackLstEntry = {
+	/** creates a facet table if true. */
 	isfacet: boolean
+	/** name shown for the facet table button from Tracks button*/
 	name: string
+	/** tk objs to show on click of the facet table */
 	tklst: TklstEntry[]
 }
 
 type CnvSegment = {
 	byrange: CnvSegmentByRange
 	/****** rendering parameters ****
-	not used as query parameter to filter segments
-	value range for color scaling. default to 5. cnv segment value>this will use solid color
-	*/
+not used as query parameter to filter segments
+value range for color scaling. default to 5. cnv segment value>this will use solid color
+*/
 	absoluteValueRenderMax?: number
 	gainColor?: string
 	lossColor?: string
 
 	/*** filtering parameters ***
-	default max length setting to restrict to focal events; if missing show all */
+default max length setting to restrict to focal events; if missing show all */
 	cnvMaxLength?: number
 
 	/** TODO define value type, if logratio, or copy number */
 
 	/** following two cutoffs only apply to log ratio, cnv gain value is positive, cnv loss value is negative
-	if cnv is gain, skip if value<this cutoff */
+if cnv is gain, skip if value<this cutoff */
 	cnvGainCutoff?: number
 	/** if cnv is loss, skip if value>this cutoff */
 	cnvLossCutoff?: number
 }
+
 type CnvSegmentByRange = {
 	src: 'native' | 'gdcapi' | string
 	/** only for src=native */
@@ -381,13 +448,16 @@ for a given region, the median signal from probes in the region is used to make
 this is alternative to CnvSegment
 
 type Probe2Cnv = {
-		file: string
+                file: string
 }
 */
 
 type RnaseqGeneCount = {
+	/** Name of the HDF5 or text file */
 	file: string
 	samplesFile?: string
+	/** Storage_type for storing data (HDF5 or text). Will deprecate text files in the future */
+	storage_type: 'text' | 'HDF5'
 }
 
 /** the metabolite query */
@@ -401,6 +471,7 @@ export type MetaboliteIntensityQueryNative = {
 	find?: (param: string[]) => void
 	metaboliteIntensity2bins?: { [index: string]: any }
 }
+
 export type MetaboliteIntensityQuery = MetaboliteIntensityQueryNative
 
 /** the geneExpression query */
@@ -418,7 +489,10 @@ export type GeneExpressionQueryNative = {
 	get?: (param: any) => void
 	/** This dictionary is used to store/cache the default bins calculated for a geneExpression term when initialized in the fillTermWrapper */
 	geneExpression2bins?: { [index: string]: any }
+	/** Type of data format HDF5 or bed */
+	storage_type?: 'HDF5' | 'bed'
 }
+
 export type GeneExpressionQuery = GeneExpressionQueryGdc | GeneExpressionQueryNative
 
 export type SingleCellGeneExpressionNative = {
@@ -441,11 +515,11 @@ export type SingleCellSamplesNative = {
 	src: 'native'
 
 	/** logic to decide sample table columns (the one shown on singlecell app ui, displaying a table of samples with sc data)
-	a sample table will always have a sample column, to show sample.sample value
-	firstColumnName allow to change name of 1st column from "Sample" to different, e.g. "Case" for gdc
-	the other two properties allow to declare additional columns to be shown in table, that are for display only
-	when sample.experiments[] are used, a last column of experiment id will be auto added
-	*/
+a sample table will always have a sample column, to show sample.sample value
+firstColumnName allow to change name of 1st column from "Sample" to different, e.g. "Case" for gdc
+the other two properties allow to declare additional columns to be shown in table, that are for display only
+when sample.experiments[] are used, a last column of experiment id will be auto added
+*/
 	firstColumnName?: string
 
 	/** do not use for native ds! gdc-only property. kept as optional to avoid tsc err */
@@ -457,6 +531,7 @@ export type SingleCellSamplesNative = {
 	/** dynamically added getter */
 	get?: (q: any) => any
 }
+
 export type SingleCellSamplesGdc = {
 	src: 'gdcapi'
 	get?: (q: any) => any
@@ -479,8 +554,8 @@ export type SingleCellDataGdc = {
 export type SingleCellDEgeneGdc = {
 	src: 'gdcapi'
 	/** Column name.
-	this must be the colorColumn from one of the plots. so that at the client app, as soon as the plot data have been loaded and maps rendered, client will find out the cell groups based on this columnName value, and show a drop down of these groups on UI. user selects a group, and pass it as request body to backend to get DE genes for this group
-	*/
+this must be the colorColumn from one of the plots. so that at the client app, as soon as the plot data have been loaded and maps rendered, client will find out the cell groups based on this columnName value, and show a drop down of these groups on UI. user selects a group, and pass it as request body to backend to get DE genes for this group
+*/
 	columnName: string
 }
 
@@ -488,6 +563,8 @@ type GDCSingleCellPlot = {
 	name: string
 	colorColumns: ColorColumn[]
 	coordsColumns: { x: number; y: number }
+	/** if true the plot is shown by default. otherwise hidden */
+	selected?: boolean
 }
 
 type ColorColumn = {
@@ -504,21 +581,23 @@ type SingleCellPlot = {
 	/** type of the plot, e.g. tsne or umap, also display as plot name on ui */
 	name: string
 	/** folder in which per-sample files are stored.
-	each file is a tabular text file with all cells (rows) from that sample.
-	all files must have same set of columns
-	file columns include cell types and x/y coords, as described by other parameters
-	*/
+each file is a tabular text file with all cells (rows) from that sample.
+all files must have same set of columns
+file columns include cell types and x/y coords, as described by other parameters
+*/
 	folder: string
 	/** optional suffix to locate the file for a sample, via ${folder}/${sampleName}${fileSuffix}
-	assumes that file name always start with sample name.
-	if not introduce filePrefix
-	*/
+assumes that file name always start with sample name.
+if not introduce filePrefix
+*/
 	fileSuffix?: string
 	/** list of columns in tabular text file that define cell categories and can be used to color the cells in the plot. must have categorical values
 	 */
 	colorColumns: ColorColumn[]
 	/** 0-based column number for x/y coordinate for this plot */
 	coordsColumns: { x: number; y: number }
+	/** if true the plot is shown by default. otherwise hidden */
+	selected?: boolean
 }
 export type SingleCellDataNative = {
 	src: 'native'
@@ -538,9 +617,9 @@ export type SingleCellDataNative = {
 
 export type SingleCellQuery = {
 	/** methods to identify samples with singlecell data,
-	this data allows client-side to display a table with these samples for user to choose from
-	also, sampleView uses this to determine if to invoke the sc plot for a sample
-	*/
+this data allows client-side to display a table with these samples for user to choose from
+also, sampleView uses this to determine if to invoke the sc plot for a sample
+*/
 	samples: SingleCellSamplesGdc | SingleCellSamplesNative
 	/** defines tsne/umap type of clustering maps for each sample
 	 */
@@ -567,8 +646,11 @@ type LdQuery = {
 		/** max range allowed to show data */
 		viewrangelimit: number
 	}[]
+	/** color scale when LD is used to overlay on variants of a locus  */
 	overlay: {
+		/** color for r2 value 1 */
 		color_1: string
+		/** Color for r2 value 0 */
 		color_0: string
 	}
 }
@@ -582,7 +664,6 @@ type SingleSampleGenomeQuantification = {
 		min: number
 		/** max value of Y axis */
 		max: number
-		/** */
 		sample_id_key: string
 		/** folder path of data files per sample */
 		folder: string
@@ -620,7 +701,11 @@ type Mds3Queries = {
 	NIdata?: NIdataQuery
 	geneExpression?: GeneExpressionQuery
 	rnaseqGeneCount?: RnaseqGeneCount
+	/** Used to create the top mutated genes UI in the gene
+	 * set edit ui and data requests. */
 	topMutatedGenes?: TopMutatedGenes
+	/** Used to create the top variably expressed UI in the gene
+	 * set edit ui. Also used for data requests */
 	topVariablyExpressedGenes?: TopVariablyExpressedGenesQuery
 	metaboliteIntensity?: {
 		src: 'native' | 'gdc'
@@ -637,6 +722,7 @@ type Mds3Queries = {
 	ld?: LdQuery
 	singleSampleGenomeQuantification?: SingleSampleGenomeQuantification
 	singleSampleGbtk?: SingleSampleGbtk
+	/** depreciated. replaced by WSImages */
 	DZImages?: DZImages
 	WSImages?: WSImages
 	images?: Images
@@ -650,7 +736,8 @@ type Images = {
 	folder: string
 }
 
-/** deep zoom image shown via openseadragon, with precomputed tiles. this is replaced by WSImages and should not be used anymore */
+/** Depreciated. deep zoom image shown via openseadragon, with precomputed tiles.
+ * this is replaced by WSImages and should not be used anymore */
 export type DZImages = {
 	// type of the image, e.g. H&E
 	type: string
@@ -684,11 +771,17 @@ type SelectCohortValuesEntry = {
 	note?: string
 }
 
-type SelectCohortEntry = {
+export type SelectCohortEntry = {
 	term: { id: string; type: string }
+	/** Title above the cohort introduction/content in the about tab */
+	title?: string
+	/** Text above radio cohort options in the about tab. */
 	prompt: string
 	values: SelectCohortValuesEntry[]
 	description?: string
+	/* If the description is dependent on the user pass a descriptionByUser dict instead */
+	descriptionByUser?: { [index: string]: string }
+	/** subtext shown at the very bottom of the cohort/about tab subheader */
 	asterisk?: string
 	//The profile has clearOnChange. The terms used in the plots are not always the same for the profile.
 	//Therefore when switching cohorts, it is necessary to delete the plots opened and the global filter
@@ -720,9 +813,9 @@ type ScatterPlotsEntry = {
 	colorTW?: { id: string }
 	colorColumn?: ColorColumn
 	/** provide a sampletype term to filter for specific type of samples for subjects with multiple samples and show in the plot.
-	e.g. to only show D samples from all patients
-	this is limited to only one term and doesn't allow switching between multiple terms
-	*/
+e.g. to only show D samples from all patients
+this is limited to only one term and doesn't allow switching between multiple terms
+*/
 	sampleCategory?: {
 		/** categorical term like "sampleType" which describes types of multiple samples from the same subject */
 		tw: { id: string }
@@ -784,7 +877,7 @@ type SortPriorityEntry = {
 }
 
 type SurvivalSettings = {
-	/** filters out all the survival data with Time-to-Event longer than this maxTimeToEvent */
+	/** The max time-to-event to be displayed in plot, hide all the samples with Time-to-Event longer than this maxTimeToEvent */
 	maxTimeToEvent?: number
 }
 
@@ -810,11 +903,14 @@ type MatrixSettings = {
 	synonymousMutations?: string[]
 	showHints?: string[]
 	displayDictRowWithNoValues?: boolean
-	/** allow to add two buttons (CNV and mutation) to control panel for selecting mclasses displayed on oncoMatrix */
+	/** allow to add two buttons (CNV and mutation) to control panel for selecting
+	 * mclasses displayed on oncoMatrix */
 	addMutationCNVButtons?: boolean
-	/** this is now computed from sortPriority[x].tiebreakers.find(tb => tb.filter?.values[0]?.dt === 1) ... */
+	/** this is now computed from sortPriority[x].tiebreakers.find(tb =>
+	 * tb.filter?.values[0]?.dt === 1) ... */
 	sortByMutation?: string
-	/** this is now computed from sortPriority[x].tiebreakers.find(tb => tb.filter?.values[0]?.dt === 4).isOrdered */
+	/** this is now computed from sortPriority[x].tiebreakers.find(tb =>
+	 * tb.filter?.values[0]?.dt === 4).isOrdered */
 	sortByCNV?: boolean
 	cnvUnit?: 'log2ratio' | 'segmedian'
 }
@@ -899,10 +995,10 @@ type UrlTemplateBase = {
 }
 export type UrlTemplateSsm = UrlTemplateBase & {
 	/** to create separate link, but not directly on chr.pos.ref.alt string.
-	name of link is determined by either namekey or linkText. former allows to retrieve a name per m that's different from chr.pos.xx */
+    name of link is determined by either namekey or linkText. former allows to retrieve a name per m that's different from chr.pos.xx */
 	shownSeparately?: boolean
 	/** optional name of link, if set, same name will be used for all links. e.g. "ClinVar".
-	if missing, name is value of m[url.namekey], as used in url itself (e.g. snp rsid) */
+if missing, name is value of m[url.namekey], as used in url itself (e.g. snp rsid) */
 	linkText?: string
 }
 
@@ -926,25 +1022,26 @@ type Termdb = {
 	selectCohort?: SelectCohortEntry
 
 	/** quick fix to convert category values from a term to lower cases for comparison (case insensitive comparison)
-	for gdc, graphql and rest apis return case-mismatching strings for the same category e.g. "Breast/breast"
-	keep this setting here for reason of:
-	- in mds3.gdc.js, when received all-lowercase values from graphql, it's hard to convert them to Title case for comparison
-	- mds3.variant2samples consider this setting, allows to handle other datasets of same issue
-	  */
+for gdc, graphql and rest apis return case-mismatching strings for the same category e.g. "Breast/breast"
+keep this setting here for reason of:
+- in mds3.gdc.js, when received all-lowercase values from graphql, it's hard to convert them to Title case for comparison
+- mds3.variant2samples consider this setting, allows to handle other datasets of same issue
+  */
 	useLower?: boolean
 
 	scatterplots?: Scatterplots
 	matrix?: Matrix
 	survival?: Survival
 	logscaleBase2?: boolean
-	chartConfigByType?: ChartConfigByType
+	plotConfigByCohort?: PlotConfigByCohort
 	/** Functionality */
 	dataDownloadCatch?: DataDownloadCatch
 	helpPages?: URLEntry[]
 	multipleTestingCorrection?: MultipleTestingCorrection
-	/** regression settings for neuro-oncology datasets:
-	- no interaction terms
-	- hide type III stats and miscellaneous statistical tests */
+	/** regression settings for neuro-oncology portals:
+- no interaction terms
+- report event counts of cox coefficients
+- hide type III stats and miscellaneous statistical tests */
 	neuroOncRegression?: boolean
 	urlTemplates?: {
 		/** gene link definition */
@@ -968,19 +1065,18 @@ type Termdb = {
 	dictionary?: GdcApi
 	allowCaseDetails?: AllowCaseDetails
 	isGeneSetTermdb?: boolean
-	// !!! TODO: improve this type definition !!!
-	getGeneAlias?: (q: any, tw: any) => any
-	convertSampleId?: {
-		gdcapi: boolean
-	}
+	/** Searches the genedb alias list to return the genecode ID */
+	getGeneAlias?: (q: any, tw: any) => { gencodeId: any }
+	convertSampleId?: GdcApi
 	hierCluster?: any
 
 	/** ds customization of rules in TermTypeSelect on what term type to exclude for a usecase.
-	used by gdc in that gene exp cannot be used for filtering 
-	note this applies to left-side term type tabs, but not terms in dict tree. latter is controlled by excludeTermtypeByTarget
-	*/
+    used by gdc in that gene exp cannot be used for filtering
+    note this applies to left-side term type tabs, but not terms in dict tree. latter is controlled by excludeTermtypeByTarget
+    */
 	useCasesExcluded?: {
-		/** key is target name (todo restrict values), value is array of 1 or more term types (todo restrict values) */
+		/** key is target name (todo restrict values), value is array of 1 or more term
+		 * types (todo restrict values) */
 		[useCaseTarget: string]: string[]
 	}
 	/** ds customization to rules in isUsableTerm(). this applies to what's showing in dict tree
@@ -1007,12 +1103,13 @@ type SampleType = {
 	parent_id: string
 }
 
-type ChartConfigByType = {
-	[index: string]: ChartConfig
-}
-
-type ChartConfig = {
-	[key: string]: any
+/** predefined configuration objects per subcohort per plot type */
+type PlotConfigByCohort = {
+	/** key is subcohort string */
+	[index: string]: {
+		/** key is plot type as in mass/charts.js */
+		[key: string]: object
+	}
 }
 
 /** modified version of termwrapper*/
@@ -1082,7 +1179,8 @@ export type Cohort = {
 		}
 	}
 	db: FileObj
-	/** customize the default chart to open on mass ui when there's no charts. if missing it opens dictionary ui */
+	/** customize the default chart to open on mass ui when there's no charts. if
+	 * missing it opens dictionary ui */
 	defaultChartType?: string
 	hiddenChartTypes?: string[]
 	massNav?: MassNav
@@ -1215,9 +1313,9 @@ type Svcnv = BaseTrack & {
 
 type KeyLabelFull = {
 	/* Used in: 
-			queries.genefpkm.boxplotbysamplegroup.attributes
-			cohort.hierarchies.lst[i].levels
-	*/
+                queries.genefpkm.boxplotbysamplegroup.attributes
+                cohort.hierarchies.lst[i].levels
+*/
 	k: string
 	label: string
 	full?: string
@@ -1261,6 +1359,7 @@ type GeneFpkm = Fpkm & {
 }
 
 type CutoffValueLstEntry = {
+	/** '<' or '>' to add to the label */
 	side: string
 	value: number
 	label: string

package/src/index.ts

@@ -20,6 +20,7 @@ export * from './routes/hicgenome.ts'
 export * from './routes/hicstat.ts'
 export * from './routes/sampledzimages.ts'
 export * from './routes/samplewsimages.ts'
+export * from './routes/termdb.boxplot.ts'
 export * from './routes/termdb.categories.ts'
 export * from './routes/termdb.cluster.ts'
 export * from './routes/termdb.DE.ts'

package/src/routes/genesetOverrepresentation.ts

@@ -7,6 +7,8 @@ export type genesetOverrepresentationRequest = {
 	genome: string
 	/** msigdb branch term name. all genesets under this branch will be analyzed */
 	geneSetGroup: string
+	/** Boolean variable describing if non-coding genes should be filtered */
+	filter_non_coding_genes: boolean
 }
 
 export type genesetOverrepresentationResponse = {
@@ -29,4 +31,6 @@ export type gene_overrepresentation_input = {
 	gene_set_group: string
 	/** Path to gene db */
 	genedb: string
+	/** Boolean variable describing if non-coding genes should be filtered */
+	filter_non_coding_genes: boolean
 }

package/src/routes/termdb.DE.ts

@@ -9,10 +9,29 @@ export type DERequest = {
 	min_count: number
 	/** Minimum total read count required for each sample */
 	min_total_count: number
+	/** Storage_type for storing data. Will deprecate text files */
+	storage_type: 'text' | 'HDF5'
 	/** Method of DE used wilcoxon/edgeR */
 	method?: string
 }
 
+export type ExpressionInput = {
+	/** Case samples separated by , */
+	case: string
+	/** Control samples separated by , */
+	control: string
+	/** data_type instructs rust to carry out differential gene expression analysis */
+	data_type: 'do_DE'
+	/** File containing raw gene counts for DE analysis */
+	input_file: string
+	/** Relative cpm cutoff for filtering a gene compared to all samples and genes in dataset */
+	min_count: number
+	/** Minimum total read count required for each sample */
+	min_total_count: number
+	/** Type of storage file: HDF5 or text. Text will be deprecated in the future */
+	storage_type: 'HDF5' | 'text'
+}
+
 export type DEResponse = {
 	/** Array containing objects of each gene containing foldchange, gene name, gene symbol, original pvalue, adjusted pvalue */
 	data: string

package/src/routes/termdb.boxplot.ts

@@ -0,0 +1,40 @@
+export type BoxPlotRequest = {
+	//TOOD: define request
+	tw: any
+}
+
+export type BoxPlotResponse = {
+	plots: BoxPlotEntry[]
+	/** Absolute min value for all plots */
+	absMin: number
+	/** Absolute max value for all plots */
+	absMax: number
+	/** Longest label length for all plots */
+	maxLabelLgth: number
+}
+
+export type BoxPlotEntry = {
+	boxplot: BoxPlotData
+	/** Label to show */
+	label: string
+	// /** Number of samples */
+	// plotValueCount: number
+	/** TODO: Is this needed? */
+	values: number[]
+	/** Lowest min for the scale domain */
+	min: number
+	/** Highest max for the scale domain */
+	max: number
+}
+
+export type BoxPlotData = {
+	w1: number
+	w2: number
+	p05: number
+	p25: number
+	p50: number
+	p75: number
+	p95: number
+	iqr: number
+	out: { value: number }[]
+}