Troubleshooting Deploying Documentation Using MkDocs

Recently, I was developing a package for my job. One of the requirements was to make sure that it was properly documented. Being a big fan of Markdown, MkDocs was a natural choice. Not only is it easy to pick up and customize, but Material for MkDocs offers some fantastic functionality on top of it. With very little effort, you can add admonitions (the nice colorful boxes with handy information), tables , site search , and many others.

After spending time and effort in writing the documentation per se, it was finally time to go live and deploy it. You can do this manually using GitHub Pages. However, in my case it was much handier to automate the documentation deployment after every push. GitHub Actions allow you to do this very easily. Unfortunately, this solution didn’t really work out of the box for me. In this post, I will share the problems I ran into and how I fixed them. Maybe this will be useful for someone else.

Read More

Using the .github directory in Enterprise Accounts

Among GitHub’s many cool features, you can create default “community health files” (e.g., CODE_OF_CONDUCT.md, FUNDING.yml, etc.) for all your repositories.

If you are working on repositories from your personal account, you can create a .github repository where you can place the corresponding files. Then, new repositories that you create will use these same files (unless you create community health files for each of them, in which case these will override the defaults). However, when working on an enterprise organization, there are a couple of considerations that you need to take into account to get this up and running.

Read More

New Paper - A Federated Approach to Identify Women with Early-stage Cervical Cancer

After more than two years of work, I am happy to share that our latest paper is out! Here, we used federated learning (more specifically, the logistic regression flavor of our previously published GLM model) to identify women at low risk of pN+ cervical cancer. This work has the potential to be used as a guide in shared decision-making process when considering the extent of lymph node dissection.

The abstract is as follows:

Read More

Estimating Breathing Rate from Respiratory Sinus Arrhythmia

As a Biomedical Engineer, I’ve always been fascinated by working with physiological signals. It amazes much how much stuff we can measure on the human body and what we can learn from it. Lately, I’ve been missing working with such data. To scratch that itch, I have been busy with a side project focused on estimating the respiratory rate from the heart rate variability signal (measured from single-lead ECG), as shown in the work by Schäfer and Kratky (2008).

GIF for display purposes only. Original lung GIF by PresenterMedia

Read More

Incorporating an Anaconda Prompt to a Windows Terminal

Anaconda is a fantastic software distribution that has everything that you need to start your Data Science projects. It comes with its own package manager, conda, which includes its own command prompt. It is great to manage your environments and launch your tools. However, when you need more than one command prompt open (which happens quite often), it is very annoying to have them spread all over the place. Having them under a single window with a tab system would be much handier. Enter Windows Terminal.

In this post, I will share the steps that I followed to incorporate Anaconda’s Prompt into it.

Read More