Sunvoltaic (Javascript)

É responsável por conter fórmulas (métodos) úteis para cálculos fotovoltaicos; Foi construído inicialmente para estimar os valores de uma usina com base no valor da entrada da conta de energia.

Você pode instalar facilmente através do NPM.

npm i sunvoltaic-js

Você precisa de um arquivo de configuração, para tudo funcionar adequadamente, com o nome sunvoltaic.config.js, neste arquivo você irá configurar:

| Parâmetro | Tipo | Descrição | | :---------- | :--------- | :---------------------------------- | | average_sun | Numeric | Radiação Solar | | plant_age | Numeric | Para estimativas de ecônomia de CO² e outros | | plate_w | Numeric | Quantidades de Watts das Placa. | | value_kwv | Object (all are numeric) | Deverá conter residential (Default), commercial e/ou agro | | reference_kwh | Function => Numeric | Uma função que recebe o parâmetro used_kit e deverá retornar um valor numérico |

Todas as entradas são obrigatórias, enquanto value_kwv precisa receber no mínimo um Objeto com residential.

Para utilizar de forma estática (não haverá mudança nos valores de Configuração):

// sunvoltaic.config.js

module.exports = {
    average_sun: 4.66,
    plant_age: 25,
    plate_w: 530,
    value_kwv: {
        residential: 0.89,
        commercial: 0.99,
        agro: 1,
    },
    reference_kwh: (used_kit) => {
        return used_kit > 5 ? 6555.5 : 7999.9;
    } 
}

Se desejar que esses valores sejam dinâmicos, você pode criar apenas como uma variável contendo este mesmo Objeto, que será passado como o 3° Parâmetro da Instância.

Instanciando o Sunvoltaic

A classe Sunvoltaic recebe "apenas" 3 parâmetros:

• 1° Valor da Conta Energética
• 2° Tipo de Atividade (1 = residential 2 = commercial 3 = agro referenciados no Objeto value_kwv de sunvoltaic.config.js)
• 3° O Objeto de Configuração (O próprio sunvoltaic.config.js)

const Sunvoltaic = require('sunvoltaic-js')
const SunvoltaicConfig = require('./sunvoltaic.config.js')

let energy_bill = 250
let type_activity = 1

const {
    daily_power,
    monthly_power,
    planted_trees,
    plant_age
} = new Sunvoltaic(energy_bill, type_activity, SunvoltaicConfig)

console.log(`Potência gerada diária: ${daily_power} kWh`)
console.log(`Potência gerada mensal: ${monthly_power} kWh`)
console.log(`${planted_trees} Árvores deixarão de ser cortadas em ${plant_age} anos.`)

Você poderá adquirir:

| Valor | Tipo | Descrição | |:------|:-----|:----------| |energy_bill| number | Valor da Conta de Energia |plant_age| number | Idade da Usina |average_sun| number | Radiação Solar |value_kwh| number | Valor de Kwh |monthly_consumption| number | Consumo mensal |indicated_kit| number | Kit Indicado |used_kit| number | Kit Utitlizado |plate_quantity| number | Quantidade de Placas |daily_power| number | Potência Diaria |monthly_power| number | Potência Mensal |annual_power| number | Potência Anual |power_archieved| number | Potência da Usina baseada na Idade da Usina (plant_age) |planted_trees| number | Estimativa de Árvores que deixarão de ser cortadas |CO2_reduction| number | Estimativa de diminuição do CO² |km_cars| number | Estimativa de Km rodados |payback| number | Valor de Payback (em meses) |average_plant| number | Valor Médio da Usina |economy_value| number | Valor de Ecônomia (mensal) |required_space| number | Estimativa de Espaço Necessário (em m²) |structure| number | Estimativa de Peso da Estrutura (em Kg)

Você pode desestruturar esses valores da Instância (como no exemplo acima) ou referenciando direto do Objeto, como por exemplo:

// ...

const Calculator = new Sunvoltaic(250, 1, SunvoltaicConfig)

console.log(`Potência gerada diária: ${Calculator.daily_power} kWh`)
console.log(`Potência gerada mensal: ${Calculator.monthly_power} kWh`)
console.log(`${Calculator.planted_trees} Árvores deixarão de ser cortadas em ${Calculator.plant_age} anos.`)

O que vem por aí?

• [ ] Reescrever biblioteca utilizando Typescript
• [ ] Obter Radiação Solar apartir de API (ou similar)
• [ ] Substituir entrada de Radiação Solar por CEP

Deixe as suas sugestões via Issue.

Autores

• @victorpubh