@jjlmoya/utils-science 1.31.0 → 1.32.0

package/src/tool/mandelbrot-fractal/i18n/tr.ts

@@ -0,0 +1,159 @@
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+
+const slug = 'mandelbrot-fraktal-hesaplayici';
+const title = 'Mandelbrot Fraktal Hesaplayici & Self Similarity Explorer';
+const description = 'Mandelbrot kumesini kesfedin, kendine benzeyen fraktal sinirlara yakinsayin ve yineleme derinligi, renk kontrasti ve karmasik duzlem koordinatlarini karsilastirin.';
+
+const howTo = [
+  {
+    name: 'Mandelbrot kumesinin bir bolgesini secin',
+    text: 'Tam kumeden baslayin veya denizati vadisi ya da spiral minibrot gibi yuksek detayli bir bolgeye dogrudan atlayin.',
+  },
+  {
+    name: 'Gorsele tiklayarak yakinsayin',
+    text: 'Canvas uzerindeki herhangi bir noktaya tiklayarak karmasik duzlemi yeniden merkezleyin ve fraktali o koordinat etrafinda buyutun.',
+  },
+  {
+    name: 'Yineleme derinligini ve renk kontrastini ayarlayin',
+    text: 'Daha ince sinir yapisini ortaya cikarmak icin yineleme butcesini artirin, ardindan kacis suresi bantlarini daha okunabilir hale getirmek icin kontrast ve paleti ayarlayin.',
+  },
+];
+
+const faq = [
+  {
+    question: 'Mandelbrot kumesi hesaplayicisi ne gosterir?',
+    answer: 'z = 0 dan baslandiginda z(n+1) = z(n)^2 + c yinelemesini sinirli tutan karmasik sayilari c gosterir. Secilen yineleme butcesi icinde asla kacmayan noktalar kumenin uyeleri olarak renklendirilirken, dis noktalar yorungelerinin ne kadar hizli kactigina gore renklendirilir.',
+  },
+  {
+    question: 'Mandelbrot kume siniri neden bu kadar cok detay iceriyor?',
+    answer: 'Sinir, kararli ve kacan yorungeleri ayirir ve bu sinir yakinindaki kucuk koordinat degisiklikleri uzun vadeli davranisi tamamen degistirebilir. Bu hassasiyet, ice ice gecmis ampuller, spiraller, filamentler ve bircok buyutme seviyesinde ortaya cikan minyatur kopyalar olusturur.',
+  },
+  {
+    question: 'Mandelbrot kumesi gercekten kendine benzer mi?',
+    answer: 'Bir Sierpinski ucgeni ile ayni katı anlamda mukemmel sekilde kendine benzemez, ancak zengin bir yari-kendine benzerlige sahiptir. Tum kumenin kucuk kopyalari duzlem boyunca, genellikle bozulmus ve ayrintili dallanma yapilariyla birbirine baglanmis olarak gorunur.',
+  },
+  {
+    question: 'Yineleme sayisi neyi kontrol eder?',
+    answer: 'Yineleme sayisi, hesaplayicinin her noktayi muhtemelen kumeye ait olduguna karar vermeden once ne kadar sure test edecegini kontrol eder. Daha yuksek degerler daha derin filamentleri ve daha temiz minibrotlari ortaya cikarir, ancak piksel basina daha fazla hesaplama gerektirir.',
+  },
+  {
+    question: 'Siyah bolgenin disinda renkler neden degisiyor?',
+    answer: 'Dis renkler kacis suresine dayanir: hizli kacan noktaler, bircok yineleme boyunca kumeye yakin kalan noktalardan farkli renkler alir. Yumusak renklendirme sert bantlari azaltir ve yakin yorungelerin geometrisini incelemeyi kolaylastirir.',
+  },
+];
+
+export const content: ToolLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+    title: 'Mandelbrot Fraktal Hesaplayici',
+    canvasLabel: 'Etkilesimli Mandelbrot kumesi canvas',
+    presetsLabel: 'Mandelbrot bolgesi on ayarlari',
+    presetFull: 'Tam Kume',
+    presetSeahorse: 'Denizati Vadisi',
+    presetSpiral: 'Spiral Minibrot',
+    centerPoint: 'Merkez',
+    magnification: 'Buyutme',
+    visibleWindow: 'Gorunur pencere',
+    renderBudget: 'Yineleme',
+    iterationsLabel: 'Yineleme derinligi',
+    contrastLabel: 'Kacis kontrasti',
+    colorLabel: 'Renk alani',
+    paletteEmber: 'Kor bantlari',
+    paletteLagoon: 'Lagun plazmasi',
+    paletteInk: 'Murekkep spektrumu',
+  },
+  seo: [
+    {
+      type: 'title',
+      text: 'Mandelbrot Set Calculator for Fractals, Escape Time, and Self-Similarity',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Bu Mandelbrot fraktal hesaplayicisi, <strong>z(n+1) = z(n)^2 + c</strong> yinelemesiyle tanimlanan klasik karmasik duzlem kumesini render eder. Pasif izlemeden ziyade kesif icin tasarlanmistir: her tiklayis duzlemi yeniden merkezler, her yakinsama daha kucuk bir matematiksel komsulugu ortaya cikarir ve yineleme kaydiricisi, hesaplayicinin bir noktayi kararli veya kacan olarak renklendirmeden once siniri ne kadar derin test etmesi gerektigine karar vermenizi saglar.',
+    },
+    {
+      type: 'title',
+      text: 'How to Read the Mandelbrot Image',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Koyu merkezi sekil, yorungeleri mevcut yineleme butcesi icinde sinirli kalan noktalari isaretler. Renkli dis kisim bir kacis suresi haritasidir. Kumeye yakin renklendirilmis bir nokta, buyuklugu kacis yaricapini asmadan once yuzlerce yineleme hayatta kalabilirken, uzaktaki bir nokta neredeyse aninda kacar. Bilimsel olarak en ilginc geometri genellikle dolu seklin icinde degil, sinirli ve sinirsiz davranisin ic ice gectigi sinir boyuncadir.',
+    },
+    {
+      type: 'table',
+      headers: ['Kontrol', 'Neyi degistirir', 'Ne zaman artirilmali'],
+      rows: [
+        ['<strong>Yineleme derinligi</strong>', 'Her piksel icin kac yineleme adiminin test edildigi.', 'Ince filamentlere veya minyatur kopyalara yakinsadiktan sonra daha yuksek degerler kullanin.'],
+        ['<strong>Kacis kontrasti</strong>', 'Yumusak kacis degerlerinin gorunur bantlara ne kadar guclu ayrildigi.', 'Goruntu duz gorundugunde yukseltin; renkler cok sert oldugunda dusurun.'],
+        ['<strong>Palet</strong>', 'Dis noktalara uygulanan renk eslemesi.', 'Bir renk alani tarafindan gizlenebilecek yapilari ortaya cikarmak icin paletleri degistirin.'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Self-Similarity and Minibrots',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Mandelbrot kumesinin bu kadar unlu olmasinin bir nedeni yari-kendine benzerligidir. Antenlere, spirallere ve vadilere yakinsadikca, minibrotlar olarak adlandirilan kucuk Mandelbrot benzeri adalarla tekrar tekrar karsilasirsiniz. Bu kopyalar sadece dekoratif degildir. Dizilisleri, periyodik ampuller, bifurcation patternleri ve yorungelerin kacmadan once uzun sureler boyunca kapali kaldigi bolgeler dahil olmak uzere, karesel haritalarin dinamigini yansitir.',
+    },
+    {
+      type: 'title',
+      text: 'Why Higher Iterations Matter at Deep Zoom',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Tam kume goruntusunde, makul bir yineleme siniri taninabilir bir goruntu verir. Ancak daha derin buyutmede, bircok sinir noktasi kacip kacmadiklarini ortaya cikarmak icin cok daha uzun surer. Yineleme siniri cok dusukse, ince yapilar yanlislikla kat veya bulanik gorunebilir. Yineleme sayisini yukseltmek sinir siniflandirmasini iyilestirir ve hesaplayicinin dar dallari, spiral kollari ve uydu ampulleri daha fazla guvenle cozmesini saglar.',
+    },
+    {
+      type: 'title',
+      text: 'Mathematical Meaning of the Complex Coordinates',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Koordinat okumasi, goruntuleme alaninin mevcut merkezini karmasik bir sayi olarak c = a + bi gosterir. Yatay eksen gercek kisim, dikey eksen ise sanal kisimdir. Canvas uzerine tiklamak yeni bir karmasik koordinat secer ve ardindan gorunur pencereyi onun etrafinda buyutur. Bu, araci fraktalin gorsel bolgelerinin karmasik duzlemdeki kesin konumlara nasil karsilik geldigini ogrenmek icin kullanisli hale getirir.',
+    },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      description,
+      applicationCategory: 'ScientificApplication',
+      operatingSystem: 'Any',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((item) => ({
+        '@type': 'Question',
+        name: item.question,
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: item.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((step) => ({
+        '@type': 'HowToStep',
+        name: step.name,
+        text: step.text,
+      })),
+    },
+  ],
+};

package/src/tool/mandelbrot-fractal/i18n/zh.ts

@@ -0,0 +1,159 @@
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+
+const slug = 'mandelbrot-fractal-calculator';
+const title = 'Mandelbrot Fractal Calculator & Self Similarity Explorer';
+const description = '探索Mandelbrot集合，放大观察自相似的分形边界，并比较迭代深度、颜色对比度和复平面坐标。';
+
+const howTo = [
+  {
+    name: '选择Mandelbrot集合的一个区域',
+    text: '从完整集合开始，或直接跳转到高细节区域，例如海马谷或螺旋形迷你brots。',
+  },
+  {
+    name: '点击图像进行缩放',
+    text: '点击画布上的任意点，以重新居中复平面并放大该坐标周围的分形。',
+  },
+  {
+    name: '调整迭代深度和颜色对比度',
+    text: '增加迭代预算以揭示更精细的边界结构，然后调整对比度和调色板，使逃逸时间带更易于阅读。',
+  },
+];
+
+const faq = [
+  {
+    question: 'Mandelbrot集合计算器显示什么？',
+    answer: '它显示哪些复数 c 在从 z = 0 开始时能使递推关系 z(n+1) = z(n)^2 + c 保持有界。在所选的迭代预算内从未逃逸的点被着色为集合的成员，而外部点则根据其轨道逃逸的速度进行着色。',
+  },
+  {
+    question: '为什么Mandelbrot集合的边界包含如此多的细节？',
+    answer: '边界分隔了稳定轨道和逃逸轨道，边界附近微小的坐标变化可能完全改变长期行为。这种敏感性产生了嵌套的 bulbs、螺旋、细丝以及在多个放大级别出现的微型副本。',
+  },
+  {
+    question: 'Mandelbrot集合真的是自相似的吗？',
+    answer: '它在与谢尔宾斯三角形相同的严格意义上并非完全自相似，但它具有丰富的准自相似性。整个集合的小副本出现在整个平面上，通常被扭曲并通过精细的分支结构连接在一起。',
+  },
+  {
+    question: '迭代次数控制什么？',
+    answer: '迭代次数控制计算器在判定每个点可能属于集合之前对其进行测试的时间。更高的值会揭示更深的细丝和更清晰的迷你brots，但需要每像素更多的计算。',
+  },
+  {
+    question: '为什么黑色区域之外的颜色会变化？',
+    answer: '外部的颜色基于逃逸时间：快速逃逸的点与多次迭代后仍停留在集合附近的点获得不同的颜色。平滑着色减少了生硬的条带，使附近轨道的几何形状更易于检查。',
+  },
+];
+
+export const content: ToolLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+    title: 'Mandelbrot Fractal Calculator',
+    canvasLabel: '交互式Mandelbrot集合画布',
+    presetsLabel: 'Mandelbrot区域预设',
+    presetFull: '完整集合',
+    presetSeahorse: '海马谷',
+    presetSpiral: '螺旋形迷你brot',
+    centerPoint: '中心',
+    magnification: '放大倍数',
+    visibleWindow: '可见窗口',
+    renderBudget: '迭代次数',
+    iterationsLabel: '迭代深度',
+    contrastLabel: '逃逸对比度',
+    colorLabel: '颜色场',
+    paletteEmber: '余烬带',
+    paletteLagoon: '泻湖等离子体',
+    paletteInk: '墨水光谱',
+  },
+  seo: [
+    {
+      type: 'title',
+      text: 'Mandelbrot Set Calculator for Fractals, Escape Time, and Self-Similarity',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '此Mandelbrot分形计算器渲染由迭代 <strong>z(n+1) = z(n)^2 + c</strong> 定义的经典复平面集合。它专为探索而非被动观看而设计：每次点击都会重新居中平面，每次缩放都会暴露一个更小的数学邻域，而迭代滑块可让您决定计算器在将点着色为稳定或逃逸之前应对边界进行多深的测试。',
+    },
+    {
+      type: 'title',
+      text: 'How to Read the Mandelbrot Image',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '深色中心形状标记了在当前迭代预算内轨道保持有界的点。彩色外部是逃逸时间图。靠近集合着色的点可能在其幅度超过逃逸半径之前经受数百次迭代，而较远的点几乎立即逃逸。最具科学趣味的几何形状通常不在填充形状内部，而是在有界与无界行为交织的边界沿线。',
+    },
+    {
+      type: 'table',
+      headers: ['控制', '更改内容', '何时增加'],
+      rows: [
+        ['<strong>迭代深度</strong>', '每个像素测试的递推步骤数。', '在放大到细小细丝或微型副本后使用更高的值。'],
+        ['<strong>逃逸对比度</strong>', '平滑逃逸值被分离成可见带的强度。', '当图像看起来平坦时提高；当颜色过于刺眼时降低。'],
+        ['<strong>调色板</strong>', '应用于外部点的颜色映射。', '切换调色板以揭示可能被单一颜色场隐藏的结构。'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Self-Similarity and Minibrots',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Mandelbrot集合如此著名的一个原因是其准自相似性。当您放大天线、螺旋和山谷时，您会反复遇到类似Mandelbrot的小岛，通常称为迷你brots。这些副本不仅仅是装饰性的。它们的排列反映了二次映射的动力学，包括周期性bulbs、分岔模式以及轨道在逃逸前长时间被困的区域。',
+    },
+    {
+      type: 'title',
+      text: 'Why Higher Iterations Matter at Deep Zoom',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '在完整集合视图下，适度的迭代限制可生成可识别的图像。然而，在更深放大倍数下，许多边界点需要更长的时间才能揭示它们是否逃逸。如果迭代限制太低，精细结构可能会错误地看起来是实心或模糊的。提高迭代次数可改善边界分类，并使计算器能够更自信地解析狭窄的卷须、旋臂和卫星bulbs。',
+    },
+    {
+      type: 'title',
+      text: 'Mathematical Meaning of the Complex Coordinates',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '坐标读数将视口的当前中心显示为复数 c = a + bi。水平轴是实部，垂直轴是虚部。点击画布会选择一个新的复数坐标，然后放大其周围的可见窗口。这使得该工具对于学习分形的视觉区域如何对应于复平面中的精确位置非常有用。',
+    },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      description,
+      applicationCategory: 'ScientificApplication',
+      operatingSystem: 'Any',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((item) => ({
+        '@type': 'Question',
+        name: item.question,
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: item.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((step) => ({
+        '@type': 'HowToStep',
+        name: step.name,
+        text: step.text,
+      })),
+    },
+  ],
+};

package/src/tool/mandelbrot-fractal/index.ts

@@ -0,0 +1,11 @@
+import { mandelbrotFractal } from './entry';
+import type { ToolDefinition } from '../../types';
+
+export * from './entry';
+
+export const MANDELBROT_FRACTAL_TOOL: ToolDefinition = {
+  entry: mandelbrotFractal,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/mandelbrot-fractal/logic/MandelbrotEngine.ts

@@ -0,0 +1,67 @@
+export interface MandelbrotViewport {
+  centerX: number;
+  centerY: number;
+  scale: number;
+  width: number;
+  height: number;
+}
+
+export interface MandelbrotSample {
+  escaped: boolean;
+  iterations: number;
+  smooth: number;
+}
+
+export interface MandelbrotStats {
+  magnification: number;
+  visibleWidth: number;
+  visibleHeight: number;
+  centerLabel: string;
+}
+
+export class MandelbrotEngine {
+  public sample(real: number, imaginary: number, maxIterations: number): MandelbrotSample {
+    let zr = 0;
+    let zi = 0;
+    let iterations = 0;
+
+    while (zr * zr + zi * zi <= 4 && iterations < maxIterations) {
+      const nextR = zr * zr - zi * zi + real;
+      zi = 2 * zr * zi + imaginary;
+      zr = nextR;
+      iterations += 1;
+    }
+
+    if (iterations === maxIterations) {
+      return { escaped: false, iterations, smooth: iterations };
+    }
+
+    const magnitude = Math.sqrt(zr * zr + zi * zi);
+    const smooth = iterations + 1 - Math.log(Math.log(Math.max(magnitude, 2))) / Math.log(2);
+    return { escaped: true, iterations, smooth };
+  }
+
+  public pixelToComplex(x: number, y: number, viewport: MandelbrotViewport): { real: number; imaginary: number } {
+    const aspect = viewport.height / viewport.width;
+    const visibleWidth = 3.5 / viewport.scale;
+    const visibleHeight = visibleWidth * aspect;
+
+    return {
+      real: viewport.centerX + (x / viewport.width - 0.5) * visibleWidth,
+      imaginary: viewport.centerY + (y / viewport.height - 0.5) * visibleHeight,
+    };
+  }
+
+  public getStats(viewport: MandelbrotViewport): MandelbrotStats {
+    const aspect = viewport.height / viewport.width;
+    const visibleWidth = 3.5 / viewport.scale;
+    const visibleHeight = visibleWidth * aspect;
+
+    return {
+      magnification: viewport.scale,
+      visibleWidth,
+      visibleHeight,
+      centerLabel: `${viewport.centerX.toFixed(6)} ${viewport.centerY >= 0 ? '+' : '-'} ${Math.abs(viewport.centerY).toFixed(6)}i`,
+    };
+  }
+}