klio 1.4.8 → 1.4.9

package/README.md

@@ -97,8 +97,10 @@ It's possible to analyze a csv with a column of either ISO date time or unix tim
 
 - **Show house and sign distribution of the datetime column**: `klio [planet] --csv <file-path>`
 - **Show aspect type distribution between two planets:** `klio [planet1] [planet2] --csv <file-path> --a`
+- **Filter CSV data by column value:** `klio [planet] --csv <file-path> --filter "column:value"` (e.g., `--filter "Item:coffee"`)
+- **Creating a bar chart**: Create a bar chart and save the image to the downloads' folder. The image shows the aspect distribution of your csv datetime values: `klio moon sun --csv /home/user/Downloads/coffee.csv  --filter "Item:cookie" --a --title "Eaten cookies during sun-moon aspects"`
 
-The command also returns a Chi-Square. 
+- The command also returns a Chi-Square. 
 
 ### Adding different charts
 
@@ -109,7 +111,7 @@ The command also returns a Chi-Square.
   - `--people` - Lists all saved persons
   - `--delete-person <id>` - Deletes a person
 
-Then, instead using `--i` for the commands from above you can use `--wp <id>` i.e. `--wp john`
+Then, instead using `--i` for the commands from above you can use `--wp <id>` or  `--wp john`
 
 ### Advanced Features
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klio",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "description": "A CLI for astrological calculations",
   "main": "src/main.js",
   "bin": {

package/src/astrology/astrologyService.js

@@ -1900,7 +1900,39 @@ function analyzeSignDistributionSignificance(signDistribution) {
   };
 }
 
-function analyzeCSVWithDatetime(filePath, planetName = 'moon', houseSystem = 'koch', analyzeAspects = false, partnerPlanet = null) {
+// Helper function to parse filter criteria
+function parseFilterCriteria(filterString) {
+  if (!filterString) return null;
+  
+  const parts = filterString.split(':');
+  if (parts.length !== 2) {
+    console.warn('Invalid filter format. Expected "column:value"');
+    return null;
+  }
+  
+  return {
+    column: parts[0].trim(),
+    value: parts[1].trim()
+  };
+}
+
+// Helper function to apply filter to records
+function applyFilter(records, filterCriteria) {
+  if (!filterCriteria || !records || records.length === 0) return records;
+  
+  const parsedCriteria = typeof filterCriteria === 'string' 
+    ? parseFilterCriteria(filterCriteria) 
+    : filterCriteria;
+  
+  if (!parsedCriteria) return records;
+  
+  return records.filter(record => {
+    const recordValue = record[parsedCriteria.column];
+    return recordValue && recordValue.toString() === parsedCriteria.value;
+  });
+}
+
+function analyzeCSVWithDatetime(filePath, planetName = 'moon', houseSystem = 'koch', analyzeAspects = false, partnerPlanet = null, filterCriteria = null) {
   return new Promise(async (resolve, reject) => {
     const results = [];
     let pendingOperations = 0;
@@ -1967,8 +1999,11 @@ function analyzeCSVWithDatetime(filePath, planetName = 'moon', houseSystem = 'ko
           skip_empty_lines: true
         });
 
+        // Apply filter if specified
+        const filteredRecords = filterCriteria ? applyFilter(records, filterCriteria) : records;
+
         // Process each row
-        for (const data of records) {
+        for (const data of filteredRecords) {
           // Look for a column with ISO-Datetime values or Unix-Timestamps
           const datetimeColumns = Object.keys(data).filter(key => {
             const value = data[key];
@@ -2107,6 +2142,20 @@ function analyzeCSVWithDatetime(filePath, planetName = 'moon', houseSystem = 'ko
       fs.createReadStream(filePath)
           .pipe(csvParser())
           .on('data', (data) => {
+            // Apply filter if specified
+            if (filterCriteria) {
+              const parsedCriteria = typeof filterCriteria === 'string' 
+                ? parseFilterCriteria(filterCriteria) 
+                : filterCriteria;
+              
+              if (parsedCriteria) {
+                const recordValue = data[parsedCriteria.column];
+                if (!recordValue || recordValue.toString() !== parsedCriteria.value) {
+                  return; // Skip this record
+                }
+              }
+            }
+
             // Look for a column with ISO-Datetime values or Unix-Timestamps
             const datetimeColumns = Object.keys(data).filter(key => {
               const value = data[key];

package/src/cli/cli.js

@@ -11,6 +11,16 @@ const swisseph = require('swisseph');
 const path = require('path');
 const fs = require('fs');
 
+// Import chart generation and downloads folder utilities
+let chartGenerator = null;
+let downloadsFolder = null;
+try {
+  chartGenerator = require('../utils/chartGenerator');
+  downloadsFolder = require('../utils/downloadsFolder');
+} catch (error) {
+  console.debug('Chart generation utilities not available');
+}
+
 // Wikidata service import
 let wikidataService = null;
 try {
@@ -265,6 +275,8 @@ program
   .option('--v <count>', 'Shows past aspects between two planets (Format: --v <count> planet1 aspectType planet2)')
   .option('--z <count>', 'Shows future aspects between two planets (Format: --z <count> planet1 aspectType planet2)')
   .option('--csv <filepath>', 'Analyzes a CSV file with ISO-Datetime values or Unix timestamps')
+  .option('--filter <column:value>', 'Filters CSV data by column:value (e.g., --filter "Item:coffee")')
+  .option('--title <title>', 'Title for the chart image (generates PNG image when provided)')
   .option('--in [count]', 'Shows next planet ingress (entering new sign). Optional count for multiple ingresses')
   .option('--wiki <occupation>', 'Fetches people from Wikidata by occupation and checks for specific aspects (Format: planet1 aspectType planet2 --wiki <occupation> [limit])')
   .option('--gui', 'Launches the web interface for command history (port 37421)')
@@ -1495,8 +1507,9 @@ program
       const planet = planetArg ? planetArg.toLowerCase() : 'moon';
       const houseSystem = actualOptions.hs ? actualOptions.hs.toLowerCase() : 'koch';
       const analyzeAspects = actualOptions.a || false;
+      const filterCriteria = actualOptions.filter;
       
-      analyzeCSVWithDatetime(actualOptions.csv, planet, houseSystem, analyzeAspects, planet2)
+      analyzeCSVWithDatetime(actualOptions.csv, planet, houseSystem, analyzeAspects, planet2, filterCriteria)
         .then(({ results, houseDistribution, signDistribution, aspectStatistics }) => {
           if (results.length === 0) {
             console.log('No valid ISO-Datetime values found in the CSV file.');
@@ -1614,6 +1627,60 @@ program
             // Also show total number of records and house system
             console.log(`\nIn Total: ${results.length}`);
             console.log(`House system: ${houseSystem.charAt(0).toUpperCase() + houseSystem.slice(1)}`);
+            
+            // Generate chart image if --title option is provided
+            if (actualOptions.title && chartGenerator && downloadsFolder) {
+              try {
+                // Get the downloads folder path
+                const downloadsPath = downloadsFolder.getValidDownloadsFolder();
+                
+                // Create a safe filename from the title
+                const safeTitle = actualOptions.title
+                  .replace(/[^a-zA-Z0-9\s\-_.]/g, '')
+                  .substring(0, 50)
+                  .trim();
+                
+                const timestamp = new Date().toISOString()
+                  .replace(/[:.]/g, '-')
+                  .substring(0, 19);
+                
+                const filename = `${timestamp}_${safeTitle}.png`;
+                const outputPath = path.join(downloadsPath, filename);
+                
+                console.log(`\n📊 Generating chart image: ${filename}`);
+                console.log(`💾 Saving to: ${outputPath}`);
+                
+                // Calculate statistics for the chart
+                let chartStats = null;
+                if (analyzeAspects && aspectStatistics) {
+                  const { analyzeAspectDistributionSignificance } = require('../astrology/astrologyService');
+                  chartStats = analyzeAspectDistributionSignificance(aspectStatistics);
+                } else if (houseDistribution) {
+                  const { analyzeHouseDistributionSignificance } = require('../astrology/astrologyService');
+                  chartStats = analyzeHouseDistributionSignificance(houseDistribution);
+                }
+                
+                // Generate the chart
+                const chartData = {
+                  houseDistribution: houseDistribution || { counts: {}, total: results.length },
+                  aspectStatistics: aspectStatistics || { types: [], counts: {}, total: 0 },
+                  results: results,
+                  statistics: chartStats
+                };
+                
+                return chartGenerator.generateBarChart(
+                  chartData,
+                  actualOptions.title,
+                  outputPath,
+                  analyzeAspects // Show aspects if --a option was used
+                ).then(imagePath => {
+                  console.log(`✅ Chart image successfully saved to: ${imagePath}`);
+                  console.log(`📁 You can find it in your Downloads folder`);
+                });
+              } catch (error) {
+                console.error('❌ Error generating chart image:', error.message);
+              }
+            }
           }
         })
         .catch(error => {
@@ -2509,8 +2576,9 @@ program
       const planet = planetArg ? planetArg.toLowerCase() : 'moon';
       const houseSystem = actualOptions.hs ? actualOptions.hs.toLowerCase() : 'koch';
       const analyzeAspects = actualOptions.a || false;
+      const filterCriteria = actualOptions.filter;
       
-      analyzeCSVWithDatetime(actualOptions.csv, planet, houseSystem, analyzeAspects, planet2)
+      analyzeCSVWithDatetime(actualOptions.csv, planet, houseSystem, analyzeAspects, planet2, filterCriteria)
         .then(({ results, houseDistribution, signDistribution, aspectStatistics }) => {
           if (results.length === 0) {
             console.log('No valid ISO-Datetime values found in the CSV file.');

package/src/utils/chartGenerator.js

@@ -0,0 +1,129 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Generate a bar chart SVG from CSV analysis data
+ * @param {Object} data - CSV analysis data
+ * @param {string} title - Chart title
+ * @param {string} outputPath - Output file path
+ * @param {boolean} showAspects - Whether to show aspects or house distribution
+ * @returns {Promise<string>} Path to the generated image
+ */
+async function generateBarChart(data, title, outputPath, showAspects = false) {
+  // SVG dimensions
+  const width = 1200;
+  const height = 800;
+  const padding = 60;
+  const chartWidth = width - 2 * padding;
+  const chartHeight = height - 2 * padding;
+  const titleHeight = 80;
+  const legendHeight = 100;
+
+  // Colors
+  const barColors = ['#4e79a7', '#f28e2b', '#e15759', '#76b7b2', '#59a14f', '#edc948', '#b07aa1', '#ff9da7', '#9c755f', '#bab0ac'];
+
+  // Prepare data for charting
+  let chartData, labels, maxValue, dataType;
+
+  if (showAspects && data.aspectStatistics) {
+    // Aspect statistics chart
+    dataType = 'Aspects';
+    chartData = data.aspectStatistics.types.map((type, index) => ({
+      label: type,
+      value: data.aspectStatistics.counts[type] || 0,
+      color: barColors[index % barColors.length]
+    }));
+    maxValue = Math.max(...chartData.map(d => d.value), 10);
+  } else {
+    // House distribution chart (default)
+    dataType = 'House Distribution';
+    chartData = [];
+    
+    // Ensure houseDistribution exists and has counts
+    const houseDist = data.houseDistribution || { counts: {} };
+    
+    for (let i = 1; i <= 12; i++) {
+      chartData.push({
+        label: `House ${i}`,
+        value: houseDist.counts[i] || 0,
+        color: barColors[(i-1) % barColors.length]
+      });
+    }
+    
+    maxValue = Math.max(...chartData.map(d => d.value), 10);
+  }
+
+  // Calculate bar dimensions
+  const barCount = chartData.length;
+  const barWidth = chartWidth / barCount / 1.5;
+  const maxBarHeight = chartHeight - titleHeight - legendHeight;
+  const yScale = maxBarHeight / maxValue;
+
+  // Generate SVG
+  const svgContent = `<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background -->
+  <rect width="100%" height="100%" fill="#f8f9fa"/>
+
+  <!-- Title -->
+  <text x="${width/2}" y="${padding + titleHeight/2 + 10}" font-family="Arial" font-size="24" font-weight="bold" text-anchor="middle" fill="#333333">${title}</text>
+  
+  <!-- Statistical Subtitle -->
+  ${data.statistics ? `
+  <text x="${width/2}" y="${padding + titleHeight/2 + 40}" font-family="Arial" font-size="16" font-weight="bold" text-anchor="middle" fill="#666666">
+    χ²(${data.statistics.degreesOfFreedom}) = ${data.statistics.chiSquare}, p ${data.statistics.isSignificant ? '&lt; 0.05' : '≥ 0.05'}, Cramer's V = ${data.statistics.effectSize}
+  </text>
+  ` : ''}
+
+  <!-- Y-axis grid lines -->
+  ${Array.from({length: 6}).map((_, i) => {
+    const y = height - padding - (i * maxBarHeight / 5);
+    return `<line x1="${padding}" y1="${y}" x2="${width - padding}" y2="${y}" stroke="#e0e0e0" stroke-width="1"/>`;
+  }).join('')}
+
+  <!-- Y-axis labels -->
+  ${Array.from({length: 6}).map((_, i) => {
+    const y = height - padding - (i * maxBarHeight / 5);
+    const value = Math.round(maxValue * (i / 5));
+    return `<text x="${padding - 10}" y="${y + 4}" font-family="Arial" font-size="14" text-anchor="end" fill="#666666">${value}</text>`;
+  }).join('')}
+
+  <!-- X-axis -->
+  <line x1="${padding}" y1="${height - padding}" x2="${width - padding}" y2="${height - padding}" stroke="#666666" stroke-width="2"/>
+
+  <!-- Bars -->
+  ${chartData.map((d, index) => {
+    const barHeight = d.value * yScale;
+    const x = padding + (index * (barWidth * 1.5)) + barWidth / 2;
+    const y = height - padding - barHeight;
+    
+    return `
+    <rect x="${x - barWidth / 2}" y="${y}" width="${barWidth}" height="${barHeight}" fill="${d.color}"/>
+    ${barHeight > 20 ? `<text x="${x}" y="${y + 20}" font-family="Arial" font-size="14" font-weight="bold" text-anchor="middle" fill="white">${d.value}</text>` : ''}
+    `;
+  }).join('')}
+
+  <!-- X-axis labels -->
+  ${chartData.map((d, index) => {
+    const x = padding + (index * (barWidth * 1.5)) + barWidth / 2;
+    const y = height - padding + 25;
+    return `<text x="${x}" y="${y}" font-family="Arial" font-size="14" text-anchor="middle" fill="#666666">${d.label}</text>`;
+  }).join('')}
+</svg>`;
+
+  // Save the SVG file
+  return new Promise((resolve, reject) => {
+    fs.writeFile(outputPath, svgContent, 'utf8', (error) => {
+      if (error) {
+        reject(error);
+      } else {
+        resolve(outputPath);
+      }
+    });
+  });
+}
+
+module.exports = {
+  generateBarChart
+};

package/src/utils/downloadsFolder.js

@@ -0,0 +1,70 @@
+const path = require('path');
+const os = require('os');
+
+/**
+ * Gets the default downloads folder path for the current operating system
+ * @returns {string} Path to the downloads folder
+ */
+function getDownloadsFolder() {
+  const homeDir = os.homedir();
+  
+  switch (process.platform) {
+    case 'win32':
+      // Windows: %USERPROFILE%\Downloads
+      return path.join(homeDir, 'Downloads');
+    
+    case 'darwin':
+      // macOS: ~/Downloads
+      return path.join(homeDir, 'Downloads');
+    
+    case 'linux':
+      // Linux: Check common locations
+      const xdgDownload = process.env.XDG_DOWNLOAD_DIR;
+      if (xdgDownload) {
+        return xdgDownload;
+      }
+      // Fallback to ~/Downloads
+      return path.join(homeDir, 'Downloads');
+    
+    default:
+      // Fallback for other platforms
+      return path.join(homeDir, 'Downloads');
+  }
+}
+
+/**
+ * Ensures the downloads folder exists and is writable
+ * @returns {string} Valid downloads folder path
+ */
+function getValidDownloadsFolder() {
+  const fs = require('fs');
+  const downloadsFolder = getDownloadsFolder();
+  
+  try {
+    // Check if folder exists
+    if (!fs.existsSync(downloadsFolder)) {
+      // Try to create it
+      fs.mkdirSync(downloadsFolder, { recursive: true });
+    }
+    
+    // Check if folder is writable
+    const testFile = path.join(downloadsFolder, '.write_test_' + Date.now());
+    try {
+      fs.writeFileSync(testFile, 'test');
+      fs.unlinkSync(testFile);
+      return downloadsFolder;
+    } catch (error) {
+      // Fallback to current directory if downloads folder is not writable
+      console.warn(`⚠️  Downloads folder not writable: ${downloadsFolder}, using current directory`);
+      return process.cwd();
+    }
+  } catch (error) {
+    console.warn(`⚠️  Could not access downloads folder: ${error.message}, using current directory`);
+    return process.cwd();
+  }
+}
+
+module.exports = {
+  getDownloadsFolder,
+  getValidDownloadsFolder
+};