Frequently Asked Questions

Doric Neuroscience Studio

For version 6 to recognize older Doric devices, you also need to update the firmware of your devices. Download instructions Here. In case a manual update is required, you can find the firmware specific to our different devices on this webpage. 

The Time Series functionality moved locations in DNS v6. It can now be found under the Global Settings button in the Configuration tab (see image below). 

To export doric files as .csv, you should use the Doric File Editor module (see image below). Briefly, by loading all doric data files within the module, you can click the ‘Export All’ to save them as CSV files.  

Note: if you are using Matlab, Python or Octave, you can directly read .doric files with code provided here. With a small modification to your data analysis pipeline (a few lines of code at most), you can easily replace .csv file with .doric file. The advantage of the .doric file (HBF5-based) is that it saves both the raw data and the recording parameters together (useful for troubleshooting and/or reproducibility). We’ve moved to this file format in version 6 because it can handle metadata (behavior videos, images, signal, TTL, etc.) and stores very large data efficiently.  

  

danseâ„¢ & Data Analysis

You have a few different options to analyze data in the .doric format: 

  1. We recently came out with danse™ which is a software designed to analyze .doric files. Specifically, with NO coding required, danse™ can: 

  • Basic processing (remove artifacts, decimate, linear interpolation, calculate dF/F0, find spikes, etc.) 

  • Import stimuli/behavior events and behavior videos from other devices 

  • Calculate behavior events that are time-locked to the neural activity (including Animal tracking, calculate animal presence in zones, animal distance from points, Motion score, and create behavior events from all those behavior measures using adjustable threshold) 

  • Create plots that combine neural activity and behavior data (e.g. peri-event/ peri-stimuli time histograms) 

  • Automatize data processing and data analysis pipelines without coding required  

 

NOTE: The Technical Support Tab of our website now contains many danse™ tutorial videos  which can give you an idea of what the software can do. Currently, only photometry-related content has been made in tutorial form, but we are consistently adding to this video library with behavior and microscopy tutorial videos coming soon. If you are interested in this option, contact us at sales@doriclenses.com for a free 15-day trial and/or a quote. We also provide virtual demos through zoom, including a walk-through using your own data with us to see how you can best utilise the software to analyze your specific experiments. 

 

  1. Doric Neuroscience Studio (DNS), our free data acquisition software, contains the Signal Analyzer, Image Analyzer, and Behavior Analyzer modules which include some basic data processing tools that are also offered by danse™ (like calculating dF/F, find spikes, etc.). 

 

  1. If you are interested in using Matlab, Python, R, or Octave, you can directly read .doric files with code provided on our GitHub repository. This includes the .doric output of the Signal Analyzer, Image Analyzer, and Behavior Analyzer modules. This allows you to do further analyses on Photometry dF/F0 calculations to create your plots and calculate your stats in either of those softwares. 

 

Fiber Photometry

A useful guide presenting and comparing our different photometry systems may be found here. This guide, in addition to going through their specificities, may also guide you towards a system that may better fit your own experiment. If you need further assistance with this, contact one of our specialists at sales@doriclenses.com.

The Technical Support Tab of our website now contains several tutorial videos providing some help with photometry systems installation and set-up. If you need further assistance with setting-up your system, contact one of our specialists at sales@doriclenses.com. 

Comparison between interleaved and LockIn modes: 

 

Interleaved mode 

LockIn mode 

Maximal Temporal Frequency 

60 Hz 

1000 Hz 

Compatible Photometry Systems 

Basic & Bundle 

Basic only 

Number of signals 

2 (basic) 

up to 3 (bundle) 

Up to 4 

Sensitive to ambient light 

YES 

NO  

The Interleave mode alternates two LED excitations, as presented in the image below. 

 

  

 

The Lock-in mode uses sinusoidal reference frequencies to drive 2 and more LED excitations at different frequencies (see image below). Then a demodulation algorithm separates the signals.  

 

This method has several advantages:

  1. Demodulated signals are invariant to ambient light and to noise above/below reference frequency
  2. Have no on/off artifact since the LEDs are always oscillating between Vmin and Vmax (and are never completely shut off). The only disadvantage of the lock-in mode is that it requires high sampling frequency, which is not always possible especially when using CMOS sensors instead of photodetectors to record photometry signals.  
 
 

No signal: (dips and bumps are almost identical between experimental and isosbestic trace) 

 

 

Weak signal (bumps in the functional signal do not occur in the isosbestic trace but low in amplitude) 

 

Strong signal (bumps in the functional signal do not occur in the isosbestic trace) 

 

 

Depending on the system, the expression level of the recorded fluorophores, and a bunch of external factors, these values will always be different and must be optimized for your specific conditionsA good starting point is to look up papers in the brain region of interest and/or that used your fluorophore. The LED power is usually reported and can give you an idea of a more specific range of power for your case. We do recommend though that the isosbestic power be half the power of the experimental signal. This will reduce photobleaching. You should measure the LED power of each LED one at a time (turn off LEDs in the LED Driver module). 

There are two possibilities: either settings are not optimal or there is a malfunctioning component within the system. 

 

  1. For FMC or iFMC systems (with external LEDs) 

  • Check the connections of the system. In particular, ensure the Connector keys are well aligned in the receptacle slots, especially when tightening the coupling nut (see image below). Misalignment can significantly reduce transmission through the fiber and lead to sever drops in power. 

 

  • Set the LED Driver in CW mode, and low-power mode with max current (200 mA) to reproduce the minimum and maximum power figures given on the LED and iFMC datasheet. If they differ more than 10%, contact Doric support (support@doriclenses.com) to ensure the device is working properly. 

 

 

  1. ilFMC Gen.2 systems (with integrated LEDs, but separate LED Driver) 

  • Turn adjustment ring (silver ring) clockwise to increase transmitted power through the variable attenuator (see image below) 

  • Check the connections of the systems. In particular, ensure the Connector keys are well aligned in the receptacle slots, especially when tightening the coupling nut (see image below). Misalignment can significantly reduce transmission through the fiber and lead to sever drops in power. 

  • Use a power meter and a 400µm NA0.57 patch cord with the current set to 200mA to reproduce the minimum and maximum power figures given on the ilFMC datasheet. If they differ more than 10%, contact Doric support (support@doriclenses.com) to ensure the device is working properly. 

 

  1. ilFMC Gen.3 systems (with integrated LEDs and LED Driver)

  • Check the connections of the systems 

  • Use a power meter and a 400µm NA0.57 patch cord with the current set to 500mA to reproduce the maximum power figure given on the ilFMC datasheet. If they differ more than 10%, contact Doric support (support@doriclenses.com) to ensure the ilFMC is working properly. 

 

Since ~80% of the photometry signal arises from the volume of tissue located at a depth of ~200 μm from the facet of the fiber, the approximate area of FOV for each core diameter is directly related to the diameter of the patch cord. (You simply can calculate the area of each patch cord using diameter to see the difference in FOV.) The NA of the patch cord will change the shape and depth of the data collections. You can learn more about the effect of the core diameter and NA on photometry data collection in this paper. Note that people use different diameter patch cords depending on the size of their region of interest. If your region of interest has a diameter of around 200um, use the 200um patch cord. If it's larger, use the 400µm core instead. You will get 75% more signal using a 400µm core since you can image many more neurons with this larger area patch cord. For fiber photometry larger NA is recommended to collect more signal; While it is true that a lower NA will increase the penetration depth, when we recommend a high NA fiber, we assume that the cannula is placed close (less than a few µm) to the detection area. Then, since the position can be manually optimized, we recommend optimizing the fluorescence collection with a high NA fiber.  

 

  • One of the causes of movement artifact on the signal is the optical transmission of the rotary joint that may vary in rotation. 

  • If the rat generates fast acceleration, it can be difficult to correct those motion artifacts. 

  • The system embedded on the rotor of a torque-assisted electrical rotary joint, as the RFMC or the RBFMC, will remove those signal variations, as the sensor is on the rotor directly, then does not pass through an optical rotary joint. 

  • Other causes of movement artifact are the fiber bending losses and the movement of the fiber implant. The fiber bending loss is difficult to prevent. You may consider using a stronger jacket, i.e. ARMO jacket instead of the 1.1 mm hytrel jacket for the patch cords to the animal. It is less flexible, and will affect more the behavior, but is acceptable for rats. And it will help the cable to survive longer. 

  • Movement of the fiber implant requires good cementing and maybe protection around the implant to make sure it is stable. For mice, it is less of an issue, but for rats, we know that researchers add some features to solidify the implant. You may consider using the 2.5 mm ferrule instead of 1.25 mm, or another type of receptacle. You may take a look here for more detailed information regarding the implants we offer. 

 

Minicubes with integrated LEDs reduce the number of optical connections and the system's overall footprint, which overall simplifies the system. However, it offers less flexibility to the user in terms of the light sources to be used. On the other hand, non-integrated minicubes present larger number of components and space, but modularity increases flexibility so that you can use different LEDs / lasers and/or fluorophores in the future than by replacing a few components required instead of buying a whole new system. 

NOTE: there is no price difference between an integrated mini cube and a non-integrated mini cube with LEDs and cables purchased separately. 

While the isosbestic point of GCaMP fluorophores have been well characterized and 405 and 415nm being widely used in green photometry, red photometry is still in its infancy. There are some who do not use an isosbestic point at all for either color of photometry (even though it is a nice way to control for background fluorescence/artifacts, especially in freely moving animals). 

We usually recommend using the DC mode. When in DC mode, the signal from the photodiode is directly passed along to the amplifier without alteration. The output range at the BNC connector is 0V to 5V. This mode is recommended for photometry experiments and should be used by default unless specified otherwise. When in AC mode, the signal from the photodiode is passed through a 30Hz high-pass filter before going to the amplifier. Any variations lower than 30 oscillations per second as well as the average value of the signal is removed. The output range at the BNC connector is -5V to 5V. This mode offers twice the dynamic range but can hide a state of saturation of the pre-amplifier and should be used with care. 

  

The gain switch selects between three or two (depending on mini-cube generations) output level for the same input fluorescence light. The 1x gain passes the signal from the pre-amplifier directly to the BNC while the 10x and 100x add 2 other amplification levels. Gain selection should be done only for very coarse signal adjustment. Gain should be lowered if the amplifier is saturated (at line around 5V) and increased if is lower than 0.5V. It is quite common that the 10X amplification is used for photometry experiments, but this will also depend on your signal. 

This PDF gives step-by-step instructions on how to measure the power using our ProntoSI power meter. However, the instructions can be generalize for other types of power meters.
 
Also, we provide a excel template to help users set the proper LED Power % target.
If you are using one of our rotary joints, small fluorescent fluctuations are expected when the joint is rotated. Here are the maximum variation expected for different types of rotary joints:
  • FRJ_1x1_PT: 2% peak-to-peak
  • FRJ_2x2_PT: 3% peak-to-peak
  • AFRJ_2x2_PT: 3% peak-to-peak
 
If the value of the peak-to-peak ratio is larger than the maximum specification of your rotary joint contact us at sales@doriclenses.com.

Microscopy

For microscopes using an USB-3 connection to the computer (eTOSM, eTSM-Gen3): 

  • Ensure that the Microscope Driver is plugged into the computer using the provided USB-3 cable. 

  • Ensure that the Electrical Cable Connector is plugged into the appropriate device (computer and microscope). 

  • When the 1-color Microscope Driver is activated, the On/Off Switch should be on ON and the white LED blink while initializing. If the light is sustained without any blinking when first turned on, restart the Microscope Driver. 

 

For microscopes using an ethernet connection to the computer (SFM, 2CFM): 

  • Ensure that the Microscope Driver is plugged into the computer using an Ethernet cable. 

  • Ensure that the Electrical Cable Connector is plugged into the appropriate device. The Microscope Driver must be linked to the Microscope. 

  • Ensure that the IP address is static (see Fig.1) 

  • Ensure the Jumbo Frames are activated (see Fig.2) 

 

  • Windows Firewall can prevent communication. To ensure the communication is not being blocked, open the Windows Firewall configuration window, then click on Allow an app through the firewall. From there, select the Change Settings button, find Doric Neuroscience Studio software and check the Private and Public checkboxes. 

  • In the Network & Sharing Center, check the Ethernet connection; it should indicate Unidentified Network. If Network Cable Unplugged is shown despite the Ethernet cable being plugged in and the driver being turned on, disable and re-enable the Ethernet connection. 

  • Ensure Network & sharing is properly configured at 1 Gbps by double-clicking the Ethernet connection and checking the Speed. 

  • When the 1-color Microscope Driver is activated, the On/Off Switch should blink blue while initializing. If the light is sustained without any blinking when first turned on, restart the Microscope Driver.  

 

If you need further assistance with this, contact one of our specialists at support@doriclenses.com.

The microscope driver must be connected to a computer ethernet port. Should a USB to Ethernet adapter be used for other function, such as internet access, the adapter must be disabled during the first initialization of the microscope. 

While running a microscopy experiment with Doric Neuroscience Studio, we recommend deactivating all internet-using programs that can conflict with the Doric Neuroscience Studio (i.e Skype, Firewall, etc.) 

In addition, we recommend using a computer with these specifications: 

  • Operating System: Windows 10 or 11 

  • CPU: Quad Core I7 3.46 GHz 

  • RAM: 16 Gb 

  • Dedicated Graphics Card: with Open GL version 4.6 recommended 

  • Desktop computer recommended 

 

Finally, Windows might limit the performances to reduce energy consumption.  

To ensure that the communication is not limited, open the Power option window and follow these steps: 

  • Press the Windows + R keys to open the Run dialog box. 

  • Type in the following text: “powercfg.cpl”, and then press Enter. 

  • In the Power Options window, under Select a power plan, choose High Performance. 

  • If you do not see the High Performance option, click the down arrow next to Show additional plans. 

  • If available, change the System standby and System hibernates settings to Never. 

  • Click Save changes or click OK. 

 

*Dropped frames are black frames that occur when an image is lost in communication. They can easily be spotted in the Average Intensity in ROI trace if the value descends to 0. 

The images obtained with Doric Neuroscience Studio are saved in a .doric format, which is a HDF5 type format. They can be visualized using softwares supporting HDF5 format such as Doric Neuroscience Studio (using the Image Analyzer plugin), ImageJ (Import function and various plugins) or a HDF viewer. Code examples are also provided here on our website and allow to read the images in Python, Matlab and Octave. 

We recommend that the optical fiber Patch Cord is of equal or shorter length than the microscope Electrical Cable when connected to the Assisted Opto-Electric Rotary Joint. Even if the cable is looped, the distance from rotary joint to patch-cord connector should be shorter than the length of the electrical cable. 

These two components are meant to be glued together after installation. If they have not been glued during installation, add a drop of quick-drying glue on the border between the Cannula and Protrusion Adjustment Ring. 

Fill the interior of the Cannula with KWIK-CAST (WPI) to act as a cap. After removal of the dried sealant, clean the Rod Lens outer surface using a cotton swab lightly dipped in isopropyl alcohol. 

- Ensure that the Microscope Clamps are sufficiently loose (screw in the barrel). 

- Ensure that the Cannula and Microscope Body are properly aligned. 

- Verify the Cannula installation instructions . Some tips are available in this application note. You may also have a look at this one-color microscope instructional video or this video for two color microscope.

 

 

 

  • We recommend first ensuring that the microscope body is correctly connected to the implant baseplate, since a small gap between both may affect signal transmission and/or illumination. 

  • Usually, the system can distinguish cells 2 or 3 weeks after the implantation of the cannula. Nonetheless, better image quality is obtained 2-8 weeks after the implantation. The waiting time for tissue repair can be a good period to use the Dummy Microscope to train the animal tolerating the encumbrance of a microscope on its head and to get used to moving easily in its cage with it. If you are imaging 2-3 following implantation, consider waiting another 10 days-2 weeks before trying again. If the issue persists, consider checking implant positioning in the sample towards the location of the fluorescent cells to image (to check whether they are out of range from microscope working distance) 

 

In the latest version of Doric Neuroscience Studio v5, a new file format, .doric format, was introduced, and this format is the sole format to be saved in the latest v6 versions. Data is exclusively saved in HDF5 files .doric extension format (.csv and .tiff format from version 5 are no longer available). HDF 5 files can be read with Matlab, Octave, and Python. Code examples are provided to facilitate data analysis with those external applications. 

 

The use of .doric file format over other formats provides several advantages: 

  • Stores heterogeneous data types (such as signal vectors, images,and videos) in a single file; 

  • Saves configuration parameters used to record the data  

  • No maximum length, which is ideal for time-series recordings lasting more than a day and/or recordings with behavioral videos 

  • Seamlessly integrate behaviour data with  in vivoneuralr ecordings 

  • Compatible with Doric’s new data analysis software, danseTM 

  • Easily read .doric to Matlab, Python  or Octave using provided  codes. 

 One important note is that saved channel configurations from version 5 are no longer compatible with version 6.

Optogenetics

For optogenetics, it depends on use case: (1) do you want light to reach as large an area as possible? (ie for a large manipulation and therefore greatest change of affecting behaviour) or (2) is precision of light in a small area required (to avoid stimulating neighbouring areas to prevent confounds). While a lower NA will increase the penetration depth. 

 

The choice of the optic fiber NA will also be influence that is used to perform the light stimulation. When using a Laser Diode light source, NA 0.22 patch cord are commonly used, NA of the laser being approximately of 0.15. 

Behavior Cameras

Doric’s B&W cameras are compatible with visible-light and near infrared light regions (no IR filter). See spectral sensitivity below. You can check here for more detailed information about the behavior camera we offer. 

 

 

Rotary Joints

Check that the power cable of the rotary joint is NOT plugged into a computer USB port, but on the provided power supply. The USB port does not send the minimum required current to adequately supply power to the rotary joint motors 

 

If that does not solve the issue, contact Doric support (support@doriclenses.com). 

  • Check the connections of the system. In particular, ensure the Connector keys are well aligned in the receptacle slots, especially when tightening the coupling nut (see image below). Misalignment can significantly reduce transmission through the fiber and lead to severe power drops. 

  • Set the LED Driver in CW mode and set the max current to 500 mA. Measure the maximum power output of the Rotary joint on its own & with patch cord, and compare it to power output of the patch cord on its own. If the measures differ by more than 10% from the report transmission on the testsheet, contact Doric support (support@doriclenses.com) to ensure the device is working properly. 

 

Check most frequently asked questions here, if you still need help then please contact us at sales@doriclenses.com.