Avis sur un projet

Version imprimable

20/05/2006, 22h41
nicolas66

Avis sur un projet

Bonjour,

Je vais très prochainement terminer une librairie C sur les matrices creuses. Elle permet de gérer :

- L'addition matricielle
- La soustraction matricielle
- La multiplication matricielle
- La multiplication scalaire
- La transposition
- La sauvegarde et le chargement des matrices au format XML (librairie libxml2)

La librairie est disponible à cette adresse : http://nicolas.lerme.free.fr/Booba-1.0.zip. Voilà, j'aimerai simplement avoir votre avis sur le code. Si vous avez des critiques ou des remarques, n'hésitez pas à m'en faire part. Merci d'avance :P

Nico.
20/05/2006, 23h52
ciol2.6.12

ya pas de commentaires. Des commentaires juste avant la déclaration d'une fonction c'est un minimum.
21/05/2006, 23h48
nicolas66

Citation:

Envoyé par ciol2.6.12

ya pas de commentaires. Des commentaires juste avant la déclaration d'une fonction c'est un minimum.

Pour les commentaires, je les mettrai à la fin si j'ai le temps. Sinon au niveau du contenu de la librairie, j'ai rajouté une fonction pour permettre de supprimer une cellule d'une matrice creuse.

De plus, j'ai remplacé à un endroit une allocation statique par une allocation dynamique qui se révèle beaucoup plus sûre.

Enfin, j'ai réalisé quelques tests sur le temps de calcul de deux initialisations de matrices creuses (100 x 100) dans une même boucle accompagné d'une multiplication matricielle entre celles-ci.

Au final, je tombe à environ 0.35 sec de calcul. A vrai dire, je ne sais pas si c'est énorme ou pas. Cependant, il faut bien voir que les accès ne sont pas du tout directs ...
22/05/2006, 08h22
PRomu@ld

Juste une chose, en C, il n'y a pas de librairie mais des bibliothèques de fonctions.

Concernant les commentaires, perso lorsque je dois utiliser une bibliothèque ou il n'y a pas de commentaires ça me gène. Les commentaires représentent une très grande partie dans la maintenance du code et la facilité d'utilisation. Une simple phrase suffit. En plus, avec les outils comme doxygen, tu peux générer des choses sympa après dessus.
22/05/2006, 09h03
nicolas66

Citation:

Envoyé par PRomu@ld

Juste une chose, en C, il n'y a pas de librairie mais des bibliothèques de fonctions.

Ah merci de me corriger, je ne le savais pas.

Citation:

Envoyé par PRomu@ld

Concernant les commentaires, perso lorsque je dois utiliser une bibliothèque ou il n'y a pas de commentaires ça me gène. Les commentaires représentent une très grande partie dans la maintenance du code et la facilité d'utilisation. Une simple phrase suffit. En plus, avec les outils comme doxygen, tu peux générer des choses sympa après dessus.

J'utilise déjà doxygen mais peut-on générer des commentaires de manière automatique avec ? Sinon concernant les résultats en temps de calcul, est-ce que cela t'étonne ou pas ?
22/05/2006, 09h12
Skyounet

Citation:

Envoyé par nicolas66

J'utilise déjà doxygen mais peut-on générer des commentaires de manière automatique avec ? Sinon concernant les résultats en temps de calcul, est-ce que cela t'étonne ou pas ?

Doxygen genere de la doc via les commentaires.
22/05/2006, 12h21
nicolas66

Citation:

Envoyé par Skyrunner

Doxygen genere de la doc via les commentaires.

Je sais bien mais je pensais qu'on pouvait définir un genre de patron de commentaire. Mais bon quand on y pense, le commentaire d'une fonction est propre à chaque fonction donc mon idée serait difficilement applicable ...

Juste une question : faut-il mettre les commentaires des fonctions dans le header, dans le code source ou dans les deux ?
22/05/2006, 12h24
Skyounet

Citation:

Envoyé par nicolas66

Je sais bien mais je pensais qu'on pouvait définir un genre de patron de commentaire. Mais bon quand on y pense, le commentaire d'une fonction est propre à chaque fonction donc mon idée serait difficilement applicable ...

Juste une question : faut-il mettre les commentaires des fonctions dans le header, dans le code source ou dans les deux ?

Il me semble que c'est juste dans le header.

Enfin c'est comme ca que je fais...
22/05/2006, 12h51
PRomu@ld

Citation:

Juste une question : faut-il mettre les commentaires des fonctions dans le header, dans le code source ou dans les deux ?

En fait, dans le hearder, je fais une descritption des fonctions. Dans le source, je commente le code (les parties difficiles ou techniques). Mais la doc générée par doxygen ne l'est qu'à partir des commentaires du header (les utilisateurs doivent savoir ce que font les fonctions mais pas comment elles le font).

Citation:

Sinon concernant les résultats en temps de calcul, est-ce que cela t'étonne ou pas ?

En fait, je ne sais pas, il faudrait comparer avec ce qui existe déjà, avec une bibliothèque de matrices simple (via un gros tableau 2D). Tu pourrait peut être te tourner du coté du forum Algorithme
De toute façon, si le temps mis par ta bibliothèque est raisonnable pour les applications qui l'utilisent ça suffit.
22/05/2006, 13h26
nicolas66

Ok merci pour vos précisions pour les commentaires :). Je vais poser la question dans le forum Algorithmes pour le temps de calcul.
23/05/2006, 11h29
Lucky-94

Citation:

Envoyé par nicolas66

Pour les commentaires, je les mettrai à la fin si j'ai le temps.

D’où la nécessité de commenter son code au fur et à mesure car souvent quand on dit « après » cela devient « jamais ».