Skip to content

BitVecEntropy

BitVecEntropy

Description

Calculate information entropy of a bitvector. Entropy measures the randomness/information content of the bit pattern.

Parameters

Name Direction Description
bv in Bitvector to analyze

Usage example (from documentation)

  double entropy = BitVecEntropy(&flags);

Returns

Entropy value in bits (0.0 to 1.0)

Usage example (Cross-references)

Usage examples (Cross-references)
    }
    
    double BitVecEntropy(BitVec *bv) {
        ValidateBitVec(bv);
    // Test BitVecEntropy basic functionality
    bool test_bitvec_entropy_basic(void) {
        WriteFmt("Testing BitVecEntropy basic functionality\n");
    
        BitVec bv     = BitVecInit();
        BitVecPush(&bv, false);
    
        double entropy = BitVecEntropy(&bv);
        result         = result && (fabs(entropy - 1.0) < 0.001);
        BitVecPush(&bv, true);
    
        entropy = BitVecEntropy(&bv);
        result  = result && (entropy == 0.0);
    // Test BitVecEntropy edge cases
    bool test_bitvec_entropy_edge_cases(void) {
        WriteFmt("Testing BitVecEntropy edge cases\n");
    
        BitVec bv     = BitVecInit();
    
        // Test empty bitvector
        double entropy = BitVecEntropy(&bv);
        result         = result && (entropy == 0.0);
        // Test single bit
        BitVecPush(&bv, true);
        entropy = BitVecEntropy(&bv);
        result  = result && (entropy == 0.0);
        u64    dot_prod    = BitVecDotProduct(&bv1, &bv2);
        double correlation = BitVecCorrelation(&bv1, &bv2);
        double entropy1    = BitVecEntropy(&bv1);
        int    align_score = BitVecAlignmentScore(&bv1, &bv2, 1, -1);
        u64    best_align  = BitVecBestAlignment(&bv1, &bv2);
    
    bool test_bitvec_entropy_null(void) {
        WriteFmt("Testing BitVecEntropy(NULL) - should fatal\n");
        BitVecEntropy(NULL);
        return true;
    bool test_bitvec_entropy_null(void) {
        WriteFmt("Testing BitVecEntropy(NULL) - should fatal\n");
        BitVecEntropy(NULL);
        return true;
    }
Last updated on