PortfolioAnalytics v0.0.4 (Changelog)

![Travis Build Status](https://travis-ci.org/lequant40/portfolio_analytics_js)

Pour le suivi des performances de mes stratégies d'investissement en bourse, ainsi que pour l'analyse des stratégies que je publie sur mon blog Le Quant 40, j'avais besoin de fonctions de mesures de performances de portefeuille en JavaScript.

Pourquoi en JavaScript ? Principalement parce que je suis un utilisateur inconditionel de Google Sheets, qui est facilement extensible grâce à Google Apps Script, un language dérivé du JavaScript.

Après avoir cherché en vain mon bonheur sur Internet (codes incomplets, ou avec trop de dépendances, ou non documentés, ou comportant beaucoup d'erreurs...), j'ai décidé de créer ma propre bibliothèque de fonctions, en espérant qu'elle puisse être utile à quelqu'un d'autre que moi...

Caractéristiques

- Compatible avec Google Sheets
- Compatible avec les navigateurs supportant le ECMAScript 5 (i.e., développement front-end)
- Compatible avec Node.js (i.e., développement back-end)
- (Performances) Utilisation automatique des tableaux typés JavaScript
- (Précision) Utilisation de méthodes numériques précises (algorithmes corrigés en deux passes pour le calcul de la moyenne, de la variance, de l'asymétrie, de l'aplatissement, algorithme précis pour le calcul de la fonction d'erreur...)
- Code testé et intégré de manière continue avec Travis CI
- Code documenté avec JSDoc

Utilisation

$3

Si vous souhaitez utiliser PortfolioAnalytics avec Google Sheets dans vos feuilles de calcul, vous pouvez soit :

- (Solution recommandée) Importer la bibliothèque externe de Script ID 1NXwj16pdgcJT-XG5LiWRJyRW604Dj26U4lqgGsJJfOKLum4y9grakXPI

ou soit :

- Importer les fichiers JavaScript contenus dans le répertoire dist/gs

Dans les deux cas, vous pouvez ensuite appeler les fonctions de PortfolioAnalytics de la manière que vous préferez :

- En utilisant une fonction qui encapsule ces appels, fonction qui est directement accessible depuis votre feuille de calcul et à laquelle vous pouvez donc fournir une plage de données quelconque (A1:A99...), e.g.:

``

js

function computeUlcerIndexWrapper(iEquityCurveRange) {

  // La plage d'entree est convertie en tableau

  var aInternalArray = [];

  for (var i=0; i    aInternalArray.push(iEquityCurveRange[i][0]);

  }

    

  // Calcul de l'index par PortfolioAnalytics

  var ulcerIndex = PortfolioAnalytics.ulcerIndex(aInternalArray);

  

  // Renvoi de cet index a la feuille de calcul

  return ulcerIndex;

}





- En utilisant des fonctions internes à Google Apps Script - typiquement la famille de fonctions getRange(...) -, qui sont optimisées pour les performances, e.g.:

js

function computeUlcerIndex() {

  // Adapte de https://developers.google.com/apps-script/reference/spreadsheet/sheet#getrangerow-column-numrows

 var ss = SpreadsheetApp.getActiveSpreadsheet();

 var sheet = ss.getSheets()[0];

 var range = sheet.getRange(1, 1, 100); // A1:A100

 var values = range.getValues();



 // Conversion de la plage ci-dessus en tableau

 var aInternalArray = [];

 for (var row in values) {

   for (var col in values[row]) {

     aInternalArray.push(values[row][col]);

   }

 }

 

  // Calcul de l'index

  var ulcerIndex = PortfolioAnalytics.ulcerIndex(aInternalArray);

  

  // Utilisation de l'index (nouveau calcul, ecriture dans la feuille de calcul...)

  ...

}





Vous trouverez des exemples d'utilisation dans cette feuille de calcul.



$3



Si vous souhaitez utiliser PortfolioAnalytics avec un navigateur, vous pouvez télécharger le code source et/ou le code source minifié.



Il vous suffit ensuite d'inclure ce code dans une page HTML, par exemple :

html





A noter que si le navigateur prend en charge les tableaux typés JavaScript, vous pouvez utiliser ces tableaux avec PortfolioAnalytics pour de meilleures performances, par exemple :

html

PortfolioAnalytics.arithmeticReturns(new Float64Array([100.0, 109.75, 111.25]))

// Le type de retour sera un Float64Array





$3



Si vous souhaitez utiliser PortfolioAnalytics avec Node.js, vous devez simplement déclarer ce module comme dépendance

dans votre fichier

package.json

.



Le reste est du code Node.js standard, e.g. :

js

var PortfolioAnalytics = require('portfolio-analytics');

...

var ui = PortfolioAnalytics.ulcerIndex([100, 110, 105, 102, 95]);

// ui == 0.07204222820421435







$3



#### Mesures liées aux pertes (drawdowns)

js

PortfolioAnalytics.maxDrawdown([1, 2, 1]); 

// == La perte maximale (maximum drawdown)



PortfolioAnalytics.drawdownFunction([1, 2, 1]); 

// == La fonction de pertes (drawdown function)



PortfolioAnalytics.topDrawdowns([1, 2, 1], 1); 

// == Les 'n' pertes maximales (second largest drawdown, etc.) avec leurs indexes de début/fin



PortfolioAnalytics.ulcerIndex([1, 2, 1]);

// == L'Ulcer Index



PortfolioAnalytics.painIndex([1, 2, 1]);

// == Le Pain Index, qui correspond aussi à la valeur moyenne de la fonction de pertes



PortfolioAnalytics.conditionalDrawdown([100, 90, 80], 0.5);

// == La perte conditionelle (conditional drawdown)





#### Mesures liées aux rendements

js

PortfolioAnalytics.cumulativeReturn([1, 2, 1]); 

// Le rendement cumulé de la première à la dernière période



PortfolioAnalytics.cagr([1, 2, 1], [new Date("2015-12-31"), new Date("2016-12-31"), new Date("2017-12-31")]); 

// Le taux de croissance annuel composé (CAGR) de la première à la dernière date



PortfolioAnalytics.arithmeticReturns([1, 2, 1]); 

// Les rendements arithmétiques pour toutes les périodes



PortfolioAnalytics.valueAtRisk([1, 2, 1], 0.7);

// La valeur à risque en pourcentage (value at risk)





#### Mesures liéesau ratio de Sharpe

js

PortfolioAnalytics.sharpeRatio([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100]); 

// Le ratio de Sharpe



PortfolioAnalytics.biasAdjustedSharpeRatio([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100]); 

// Le ratio de Sharpe ajusté de son biais



PortfolioAnalytics.doubleSharpeRatio([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100]); 

// Le double ratio de Sharpe (i.e., le ratio de Sharpe ajusté de son risque d'estimation)



PortfolioAnalytics.sharpeRatioConfidenceInterval([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100], 0.05); 

// L'intervalle de confiance du ratio de Sharpe (ici, à un niveau de significativité de 5%)



PortfolioAnalytics.probabilisticSharpeRatio([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100], 0); 

// Le ratio de Sharpe probabilistique (i.e., la probabilité que le ratio de Sharpe soit plus grand qu'un

// ratio de Sharpe de référence, ici 0)



PortfolioAnalytics.minimumTrackRecordLength([100, 110, 105, 107.5, 115], [100, 100, 100, 100, 100], 0.05, 0); 

// La longueur minimale de l'historique des performances (i.e., la longueur minimale de l'historique des performances

// nécessaire à avoir confiance statistiquement, ici à 95%, que le ratio de Sharpe est plus grand qu'un ratio

// de Sharpe de référence).







#### Mesures liées aux rendements par rapport à la variabilité

js

PortfolioAnalytics.gainToPainRatio([1, 2, 1]); 

// Le ratio gain to pain





Comment contribuer ?



$3





$3



npm install





$3



$3



- La commande suivante génère les fichiers à utiliser dans un navigateur ou avec Node.js dans le répertoire

dist



grunt deliver





- La commande suivante génère les fichiers à utiliser avec Google Sheets dans le répertoire

dist\gs



grunt deliver-gs



$3



L'une ou l'autre des deux commandes suivantes exécute les tests unitaires QUnit du répertoire

test sur le fichier généré dist\portfolio_analytics.dev.min.js



npm test



grunt test

$3

License

License MIT