@things-factory/spc 7.0.0-alpha.18

package/server/controllers/spc-chart/u.ts

@@ -0,0 +1,31 @@
+import { SPCChartPlot, SPCChartAnalysis } from '../../service/spc-chart/spc-chart-type'
+
+export function calculateUChartAnalysisResult(plots: SPCChartPlot[]): SPCChartAnalysis {
+  // 각 샘플의 평균을 계산
+  plots = plots.map(plot => ({
+    ...plot,
+    defects: plot.values.map(Boolean).length,
+    n: plot.values.length
+  }))
+
+  // 단위당 결함 수의 평균(UBar)을 계산합니다.
+  const totalDefects = plots.reduce((acc, plot) => acc + plot.defects, 0)
+  const totalUnits = plots.reduce((acc, plot) => acc + plot.n, 0)
+  const UBar = totalDefects / totalUnits
+
+  // 샘플 그룹의 크기(n)에 따라 상수를 결정합니다. 여기서는 일반적인 상수 값을 사용합니다.
+  const n = plots.length // 샘플 그룹의 수
+  // UCL과 LCL 계산을 위한 상수. 실제 값은 샘플 크기와 분포에 따라 달라질 수 있습니다.
+  const ucl = UBar + 3 * Math.sqrt(UBar / totalUnits)
+  const lcl = UBar - 3 * Math.sqrt(UBar / totalUnits) < 0 ? 0 : UBar - 3 * Math.sqrt(UBar / totalUnits) // LCL이 음수가 되지 않도록 처리
+
+  return {
+    chartType: 'U',
+    controlLimits: {
+      ucl,
+      lcl,
+      cl: UBar
+    },
+    plots
+  }
+}

package/server/controllers/spc-chart/x-bar-r.ts

@@ -0,0 +1,53 @@
+import { SPCChartPlot, SPCChartAnalysis } from '../../service/spc-chart/spc-chart-type'
+
+function getA2Value(sampleSize: number): number {
+  const a2Values: { [key: number]: number } = {
+    2: 1.88,
+    3: 1.023,
+    4: 0.729,
+    5: 0.577,
+    6: 0.483
+    // 다른 샘플 크기에 대한 A2 값 추가...
+  }
+
+  return a2Values[sampleSize] || 0 // 샘플 크기에 대한 A2 값이 정의되지 않은 경우 0을 반환
+}
+
+export function calculateXBarAnalysisResult(plots: SPCChartPlot[]): SPCChartAnalysis {
+  // 각 샘플의 평균을 계산
+  plots = plots.map(plot => ({
+    ...plot,
+    xbar: plot.values ? plot.values.reduce((sum, val) => sum + val, 0) / plot.values.length : 0,
+    r: Math.max(...plot.values) - Math.min(...plot.values)
+  }))
+
+  const plotSize = plots[0]?.values?.length // 샘플 크기 추정(모든 그룹이 같은 크기를 가정)
+
+  // 각 샘플의 범위(R) 계산
+  const ranges = plots.map(plot => {
+    if (plot.values) {
+      return Math.max(...plot.values) - Math.min(...plot.values)
+    }
+    return 0
+  })
+
+  // 범위(R)의 평균 계산
+  const averageRange = ranges.reduce((sum, r) => sum + r, 0) / ranges.length
+
+  // 전체 평균(중심선, CL) 계산
+  const overallMean = plots.reduce((sum, plot) => sum + plot.xbar, 0) / plots.length
+
+  const A2 = getA2Value(plotSize)
+  const ucl = overallMean + A2 * averageRange
+  const lcl = overallMean - A2 * averageRange
+
+  return {
+    chartType: 'Xbar',
+    controlLimits: {
+      ucl,
+      lcl,
+      cl: overallMean
+    },
+    plots
+  }
+}

package/server/controllers/spc-chart/x-bar.ts

@@ -0,0 +1,53 @@
+import { SPCChartPlot, SPCChartAnalysis } from '../../service/spc-chart/spc-chart-type'
+
+function getA2Value(sampleSize: number): number {
+  const a2Values: { [key: number]: number } = {
+    2: 1.88,
+    3: 1.023,
+    4: 0.729,
+    5: 0.577,
+    6: 0.483
+    // 다른 샘플 크기에 대한 A2 값 추가...
+  }
+
+  return a2Values[sampleSize] || 0 // 샘플 크기에 대한 A2 값이 정의되지 않은 경우 0을 반환
+}
+
+export function calculateXBarAnalysisResult(plots: SPCChartPlot[]): SPCChartAnalysis {
+  // 각 샘플의 평균을 계산
+  plots = plots.map(plot => ({
+    ...plot,
+    xbar: plot.values ? plot.values.reduce((sum, val) => sum + val, 0) / plot.values.length : 0,
+    r: Math.max(...plot.values) - Math.min(...plot.values)
+  }))
+
+  const plotSize = plots[0]?.values?.length // 샘플 크기 추정(모든 그룹이 같은 크기를 가정)
+
+  // 각 샘플의 범위(R) 계산
+  const ranges = plots.map(plot => {
+    if (plot.values) {
+      return Math.max(...plot.values) - Math.min(...plot.values)
+    }
+    return 0
+  })
+
+  // 범위(R)의 평균 계산
+  const averageRange = ranges.reduce((sum, r) => sum + r, 0) / ranges.length
+
+  // 전체 평균(중심선, CL) 계산
+  const overallMean = plots.reduce((sum, plot) => sum + plot.xbar, 0) / plots.length
+
+  const A2 = getA2Value(plotSize)
+  const ucl = overallMean + A2 * averageRange
+  const lcl = overallMean - A2 * averageRange
+
+  return {
+    chartType: 'Xbar',
+    controlLimits: {
+      ucl,
+      lcl,
+      cl: overallMean
+    },
+    plots
+  }
+}

package/server/index.ts

@@ -0,0 +1,10 @@
+export * from './service'
+
+import { DataUseCase } from '@things-factory/dataset'
+import { DataUseCaseSPC } from './controllers'
+
+process.on('bootstrap-module-start' as any, async ({ app, config, schema }: any) => {
+  DataUseCase.registerUseCase('SPC', new DataUseCaseSPC())
+
+  console.log('[spc:bootstrap] SPC has just registered as a DataUseCase.')
+})

package/server/service/index.ts

@@ -0,0 +1,21 @@
+/* EXPORT ENTITY TYPES */
+
+/* IMPORT ENTITIES AND RESOLVERS */
+import { entities as SpcChartEntities, resolvers as SpcChartResolvers, subscribers as SpcChartSubscribers } from './spc-chart'
+
+export const entities = [
+  /* ENTITIES */
+  ...SpcChartEntities
+]
+
+export const subscribers = [
+  /* SUBSCRIBERS */
+  ...SpcChartSubscribers
+]
+
+export const schema = {
+  resolverClasses: [
+    /* RESOLVER CLASSES */
+    ...SpcChartResolvers
+  ]
+}

package/server/service/spc-chart/index.ts

@@ -0,0 +1,5 @@
+import { SpcChartQuery } from './spc-chart-query'
+
+export const entities = []
+export const resolvers = [SpcChartQuery]
+export const subscribers = []

package/server/service/spc-chart/spc-chart-query.ts

@@ -0,0 +1,102 @@
+import { Resolver, Query, Arg, Ctx } from 'type-graphql'
+import { Between, In } from 'typeorm'
+
+import { getRepository } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { DataSet, DataSample } from '@things-factory/dataset'
+
+import { SPCChartAnalysis, SPCChartAnalysisResult } from './spc-chart-type'
+import { calculateXBarAnalysisResult } from '../../controllers/spc-chart/x-bar'
+import { calculateRChartAnalysisResult } from '../../controllers/spc-chart/r'
+import { calculateIChartAnalysisResult } from '../../controllers/spc-chart/i'
+import { calculateMRChartAnalysisResult } from '../../controllers/spc-chart/mr'
+import { calculateUChartAnalysisResult } from '../../controllers/spc-chart/u'
+import { calculateCChartAnalysisResult } from '../../controllers/spc-chart/c'
+import { calculatePChartAnalysisResult } from '../../controllers/spc-chart/p'
+import { calculateNPChartAnalysisResult } from '../../controllers/spc-chart/np'
+
+@Resolver(DataSet)
+export class SpcChartQuery {
+  @Query(returns => SPCChartAnalysisResult!, { nullable: true, description: 'To fetch a SpcChart' })
+  async spcChart(
+    @Arg('dataSetId') dataSetId: string,
+    @Arg('variable') variable: string,
+    @Arg('chartType') chartType: string,
+    @Arg('fromDate') fromDate: string,
+    @Arg('toDate') toDate: string,
+    @Ctx() context: ResolverContext
+  ): Promise<SPCChartAnalysisResult> {
+    const { domain } = context.state
+
+    const dataSet = (await getRepository(DataSet).findOne({
+      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id: dataSetId }
+    })) as DataSet
+
+    if (!dataSet) {
+      throw 'no given dataset'
+    }
+
+    const dataItem = dataSet.dataItems.find(dataItem => dataItem.name == variable)
+
+    if (!dataItem) {
+      throw 'no given variables in the dataset'
+    }
+
+    // TODO timezone
+    const fromTime = new Date(fromDate) /* default: 30days before */
+    const toTime = new Date(toDate) /* default: today */
+
+    const dataSamples = (await getRepository(DataSample).find({
+      where: {
+        dataSet: { id: dataSet.id },
+        createdAt: Between(fromTime, toTime)
+      }
+    })) as DataSample[]
+
+    const tag = dataItem.tag
+    const samples = dataSamples
+      .map(dataSample => {
+        const data = dataSample.data[tag]
+
+        return {
+          x: dataSample.createdAt,
+          values: Array.isArray(data) ? data : [data]
+        }
+      })
+      .filter(sample => {
+        const { x, values } = sample
+        return x && values && values.length > 0 && values.every(v => v ?? false)
+      })
+
+    const charts = [] as SPCChartAnalysis[]
+
+    switch (chartType) {
+      case 'Xbar-R':
+        charts.push(calculateXBarAnalysisResult(samples))
+        charts.push(calculateRChartAnalysisResult(samples))
+        break
+      case 'I-MR':
+        charts.push(calculateIChartAnalysisResult(samples))
+        charts.push(calculateMRChartAnalysisResult(samples))
+        break
+      case 'C':
+        charts.push(calculateUChartAnalysisResult(samples))
+        break
+      case 'U':
+        charts.push(calculateCChartAnalysisResult(samples))
+        break
+      case 'P':
+        charts.push(calculatePChartAnalysisResult(samples))
+        break
+      case 'NP':
+        charts.push(calculateNPChartAnalysisResult(samples))
+        break
+    }
+
+    return {
+      dataSet,
+      variable,
+      charts
+    }
+  }
+}

package/server/service/spc-chart/spc-chart-type.ts

@@ -0,0 +1,105 @@
+import { ObjectType, Field, ID, Int, Float } from 'type-graphql'
+
+import { DataSet } from '@things-factory/dataset'
+
+@ObjectType()
+export class SPCChartPlot {
+  @Field(type => ID)
+  x: string
+
+  @Field(type => [Float], { nullable: true })
+  values?: number[]
+
+  @Field(type => Float, { nullable: true })
+  xbar?: number
+
+  @Field(type => Float, { nullable: true })
+  r?: number
+
+  @Field(type => Float, { nullable: true })
+  i?: number
+
+  @Field(type => Float, { nullable: true })
+  mr?: number
+
+  @Field(type => Float, { nullable: true })
+  n?: number
+
+  @Field(type => Float, { nullable: true })
+  defects?: number
+}
+
+@ObjectType()
+class SPCControlLimits {
+  @Field(type => Float, { nullable: true })
+  ucl?: number
+
+  @Field(type => Float, { nullable: true })
+  lcl?: number
+
+  @Field(type => Float, { nullable: true })
+  cl?: number
+}
+
+@ObjectType()
+class SPCSpecLimits {
+  @Field(type => Float, { nullable: true })
+  target?: number
+
+  @Field(type => Float, { nullable: true })
+  lsl?: number
+
+  @Field(type => Float, { nullable: true })
+  usl?: number
+}
+
+@ObjectType()
+export class SPCChartAnalysis {
+  @Field()
+  chartType: string
+
+  @Field(type => SPCControlLimits, { nullable: true })
+  controlLimits?: SPCControlLimits
+
+  @Field(type => SPCSpecLimits, { nullable: true })
+  specLimits?: SPCSpecLimits
+
+  @Field(type => [SPCChartPlot], { nullable: true })
+  plots?: SPCChartPlot[]
+
+  // @Field(type => [Bin], { nullable: true })
+  // bins?: Bin[]
+
+  // @Field(type => [Category], { nullable: true })
+  // categories?: Category[]
+}
+
+// @ObjectType()
+// class Bin {
+//   @Field()
+//   binRange: string
+
+//   @Field()
+//   count: number
+// }
+
+// @ObjectType()
+// class Category {
+//   @Field()
+//   category: string
+
+//   @Field()
+//   count: number
+// }
+
+@ObjectType()
+export class SPCChartAnalysisResult {
+  @Field(type => DataSet)
+  dataSet: DataSet
+
+  @Field()
+  variable: string
+
+  @Field(type => [SPCChartAnalysis])
+  charts: SPCChartAnalysis[]
+}

package/server/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig-base.json",
+  "compilerOptions": {
+    "strict": false,
+    "module": "commonjs",
+    "outDir": "../dist-server",
+    "baseUrl": "./"
+  },
+  "include": ["./**/*"]
+}

package/things-factory.config.js

@@ -0,0 +1,11 @@
+import route from './dist-client/route'
+
+export default {
+  route,
+  routes: [
+    {
+      tagname: 'spc-chart-page',
+      page: 'spc-chart'
+    }
+  ]
+}

package/translations/en.json

@@ -0,0 +1,3 @@
+{
+  "title.spc-chart": "SPC chart"
+}

package/translations/ja.json

@@ -0,0 +1,3 @@
+{
+  "title.spc-chart": "SPC チャート"
+}

package/translations/ko.json

@@ -0,0 +1,3 @@
+{
+  "title.spc-chart": "SPC 차트"
+}

package/translations/ms.json

@@ -0,0 +1,3 @@
+{
+  "title.spc-chart": "Carta SPC"
+}

package/translations/zh.json

@@ -0,0 +1,3 @@
+{
+  "title.spc-chart": "SPC 图表"
+}